02. I choose the method for retrieving data from the national ROR healthcare offering
I download public data via files updated once a week
The data identifying the structures as well as the data describing the healthcare offer are enough for me
The weekly update meets my needs
I download the public data from the ROR (mev2.4 CSD) in xml format on the data.gouv.fr platform. I don't need to go any further in the course.
I would like to consume public and/or restricted healthcare data via webservices
I interface my application with the APIs of the national ROR. Webservices are available in FHIR format as well as in CSD format.
Point of attention: Webservices in CSD format (meV2.4) are deprecated and do not allow, among other things, availability in beds/places. This format will be discontinued at the end of Q1 2026. We strongly recommend that you connect to the FHIR MEV3.0 APIs.
03. I identify the webservices I need
If I choose FHIR webservices based on MEV3.0, I select the webservices I need from the following 3 cases:
Case 1: I retrieve the complete initialization of the national ROR via a $export extraction.
Case 2: I retrieve offer data via targeted FHIR queries (several search criteria, less than 10,000 results).
Case 3: I retrieve capacity data on a very regular basis via a dedicated cache.
If I choose CSD webservices based on MEV2.4 (decommissioned end of Q1 2026), I choose the webservices I need from the following 3 cases:
Case 1: I need to initialize all data:
I initialize my database with the ROR offer with the "TR-Recovery Extraction" webservice (REST service)
I update my database with the following webservices:
Case 2: I import the offer of a single establishment I've selected in my business tool with the webservice TR-Lecture-OffresSanteEtablissement (SOAP service).
Case 3 : I import the information from a part of the organization that I identify from its identifier (the identifier of the internal organization (pole/department/.../elemental unit assigned by the national ROR) with the webserviceTR-Lecture-OffresSanteOrganisationInterne (SOAP service)
Need help?
Consult the documents below, for a detailed view of all transactions.