Without Patient Information API

3. Search the patient

You need to send all the patient information (name, birthdate, …) with the strongest identifier you have (INSq > IPP > other).

Please see Patient Identity Management (INSq) for more information about the INSq.

4. Send the medical document

In this step, you'll proceed to sending a medical document and you'll use all the references you've kept in the previous steps.

Search the managing-organization

Before sending your document, you have to search the issuer of the document in our healthcare structure directory or find it in the developer portal. This organization will be used to find the sender’s email address paired to your application (ex: [email protected]).

To find it, you can search on the api.lifen.fr/fhir/v3/Organization/$search-for-mss endpoint as explained in the previous step or in the developer portal.

🚧

It is your responsibility to pick the right organization for every document sent. You must be careful, i.e. the hospital where the patient concerned by the document has/had an encounter. For example, you should not use hospital A’s email address to send a document about a patient that stayed at hospital B.

📘

All the managing-organization are available in your developer portal

Example from the developer portal

Example from the developer portal

You need to complete the following information :

Parameter

Type

Description

Mandatory fields

detailed-subject

Resource

resource patient with all the administrative information needed to send to mssanté canal

Use case 1 : INSq

  • family birthname

  • list of given names

  • usual firstname and family (optional)

  • birthplace / birth location as INSEE code only

  • birthdate

  • gender

  • identifier INSq = “matricule INS” - INS type via OID (NIR or NIA)Use case 2 : IPP

  • usual firstname and family

  • birthdate

  • gender

  • identifier IPPUse case 3 : local identifier

  • usual firstname and family

  • birthdate

  • gender

  • local identifier

recipients

Resource

all the recipients, with their mssante email addresses. Either the Lifen reference or the RPPS number

sender
or
sender-identifier

Reference or
string

Practitioner who signed the document. Either the Lifen reference or the RPPS

optional (only one between sender or sender-identifier must be added)

managing-organization

Reference

organization used as the issuer of the document paired with your application

required with detailed-subject

payload parameter :type

Code

for each document, you must choose the type of the document referring to the list Document Type

payload parameter : content.attachment.content-type

Code

for each document, you must describe the content-type of the document application/pdf (no other type currently supported)

payload parameter : content.attachment.data

base64

all documents, in base64 format

Examples of the body request

// with INSq
// with recipient identified by the Lifen ID
{
   "resourceType":"Parameters",
   "parameter":[
     {
       "name":"payload",
       "part":[
         {
           "name":"document",
           "resource": {
             "resourceType":"DocumentReference",
             "type":{
               "coding":[{
                 "system":"urn:oid:2.16.840.1.113883.6.1",
                 "code":"11488-4"
               }]
             },
             "content":[{
               "attachment":{
                 "content-type":"application/pdf",
                 "data":"{{document in base 64}}"
               }
             }]
           }
         }
       ]
     },
     {
       "name":"recipients",
       "part":[
         {
           "name":"recipient",
           "resource":{
             "resourceType":"Practitioner",
             "id":"456",
             "telecom":[
               {
                 "id":"42995", // optional
                 "system":"email",
                 "value":"[email protected]"
               }
             ]
           }
         }
       ]
     },
     {
       "name":"sender", // optional
       "valueReference": {
         "reference": "Practitioner/3434545"
       }
     },
     /* either sender or sender-identifier 
     {
         "name":"sender-identifier", // optional
         "valueString": "12345678910"
     },
     */
     {
       "name":"managing-organization",
       "valueReference": {
         "reference": "Organization/3434545"
       }
     },
     {
       "name": "detailed-subject", 
       "resource":
       {
         "resourceType": "Patient",
         "identifier": [
           {
             "system" : "urn:oid:1.2.250.1.213.1.4.8", // INS system (.8 for INS NIR ou .9 for INS NIA)
             "value" : "2950244162294" // matricule INS 
           }
         ],
         "extension": [
           {
             "url": "http://hl7.org/fhir/StructureDefinition/birthPlace",
             "valueAddress": {
               "city": "ROUGON", //optional
               "district": "04171", // code INSEE   
               "postalCode": "04120", //optional
               "country": "FRA" //optional
             }
           }
         ],
         "name": [
           {
             "family": "MICHUE birthname",
             "given": [
                   "PAULETTE",
                   "JEANNE",
                   "MARIE"
              ],
              "use" : "official" 
           },
           {
             "family": "DUPONT",
             "given": [
                    "PAULETTE"
              ],
             	"use" : "usual" 
           }
         ],
         "gender": "female",
         "birthDate": "1990-03-01"
       }
     }
   ]
}
// with INSq
// with recipient identified by their RPPS
{
   "resourceType":"Parameters",
   "parameter":[
     {
       "name":"payload",
       "part":[
         {
           "name":"document",
           "resource": {
             "resourceType":"DocumentReference",
             "type":{
               "coding":[{
                 "system":"urn:oid:2.16.840.1.113883.6.1",
                 "code":"11488-4"
               }]
             },
             "content":[{
               "attachment":{
                 "content-type":"application/pdf",
                 "data":"{{document in base 64}}"
               }
             }]
           }
         }
       ]
     },
     {
       "name":"recipients",
       "part":[
         {
           "name":"recipient",
           "resource":{
             "resourceType":"Practitioner",
             "identifier": [
               {
                 "system": "http://rpps.fr",
                 "value": "811111111111111"
               }
             ],
             "telecom":[
               {
                 "id":"42995", // optional
                 "system":"email",
                 "value":"[email protected]"
               }
             ]
           }
         }
       ]
     },
     {
       "name":"sender", // optional
       "valueReference": {
         "reference": "Practitioner/3434545"
       }
     },
     /* either sender or sender-identifier 
     {
         "name":"sender-identifier", // optional
         "valueString": "12345678910"
     },
     */
     {
       "name":"managing-organization",
       "valueReference": {
         "reference": "Organization/3434545"
       }
     },
     {
       "name": "detailed-subject", 
       "resource":
       {
         "resourceType": "Patient",
         "identifier": [
           {
             "system" : "urn:oid:1.2.250.1.213.1.4.8", // INS system (.8 for INS NIR ou .9 for INS NIA)
             "value" : "2950244162294" // matricule INS 
           }
         ],
         "extension": [
           {
             "url": "http://hl7.org/fhir/StructureDefinition/birthPlace",
             "valueAddress": {
               "city": "ROUGON", //optional
               "district": "04171", // code INSEE   
               "postalCode": "04120", //optional
               "country": "FRA" //optional
             }
           }
         ],
         "name": [
           {
             "family": "MICHUE birthname",
             "given": [
                   "PAULETTE",
                   "JEANNE",
                   "MARIE"
              ],
              "use" : "official" 
           },
           {
             "family": "DUPONT",
             "given": [
                    "PAULETTE"
              ],
             	"use" : "usual" 
           }
         ],
         "gender": "female",
         "birthDate": "1990-03-01"
       }
     }
   ]
}
// with IPP
{
   "resourceType":"Parameters",
   "parameter":[
     {
       "name":"payload",
       "part":[
         {
           "name":"document",
           "resource": {
             "resourceType":"DocumentReference",
             "type":{
               "coding":[{
                 "system":"urn:oid:2.16.840.1.113883.6.1",
                 "code":"11488-4"
               }]
             },
             "content":[{
               "attachment":{
                 "content-type":"application/pdf",
                 "data":"{{document in base 64}}"
               }
             }]
           }
         }
       ]
     },
     {
       "name":"recipients",
       "part":[
         {
           "name":"recipient",
           "resource":{
             "resourceType":"Practitioner",
             "id":"456",
             "telecom":[
               {
                 "id":"42995", // optional
                 "system":"email",
                 "value":"[email protected]"
               }
             ]
           }
         }
       ]
     },
     {
       "name":"sender", // optional
       "valueReference": {
         "reference": "Practitioner/3434545"
       }
     },
     /* either sender or sender-identifier 
     {
         "name":"sender-identifier", // optional
         "valueString": "12345678910"
     },
     */
     {
       "name":"managing-organization",
       "valueReference": {
         "reference": "Organization/3434545"
       }
     },
     {
       "name": "detailed-subject",
       "resource":
       {
         "resourceType": "Patient",
         "identifier": [
           {
             "system" : "urn:oid:1.250.1.432.5.1.2.1",  
             "value" : "35345354654656" // IPP value
           }
         ],
         "name": [
           {
             "family": "DUPONT",
             "given":
             [
               "PAULETTE"
             ],
             "use" : "usual" 
           }
         ],
         "gender": "female",
         "birthDate": "1990-03-01"
       }
     }
   ]
}
// with local identifier
{
   "resourceType":"Parameters",
   "parameter":[
     {
       "name":"payload",
       "part":[
         {
           "name":"document",
           "resource": {
             "resourceType":"DocumentReference",
             "type":{
               "coding":[{
                 "system":"urn:oid:2.16.840.1.113883.6.1",
                 "code":"11488-4"
               }]
             },
             "content":[{
               "attachment":{
                 "content-type":"application/pdf",
                 "data":"{{document in base 64}}"
               }
             }]
           }
         }
       ]
     },
     {
       "name":"recipients",
       "part":[
         {
           "name":"recipient",
           "resource":{
             "resourceType":"Practitioner",
             "id":"456",
             "telecom":[
               {
                 "id":"42995", // optional
                 "system":"email",
                 "value":"[email protected]"
               }
             ]
           }
         }
       ]
     },
     {
       "name":"sender", // optional
       "valueReference": {
         "reference": "Practitioner/3434545"
       }
     },
     /* either sender or sender-identifier 
     {
         "name":"sender-identifier", // optional
         "valueString": "12345678910"
     },
     */
     {
       "name":"managing-organization", 
       "valueReference": {
         "reference": "Organization/3434545"
       }
     },
     {
       "name": "detailed-subject", 
       "resource":
       {
         "resourceType": "Patient",
         "identifier": [
           {
             "system" : "http://lifen.fr/fhir/StructureDefinition/Patient/Identifier/[client_id_app]", // replace [client_id_app] with your client id or other local system you juge pertinent
             "value" : "345345345454345354" // other local identifier you judge pertinent
           }
         ],
         "name": [
           {
             "family": "DUPONT",
             "given":
             [
               "PAULETTE"
             ],
             "use" : "usual" 
           }
         ],
         "gender": "female",
         "birthDate": "1990-03-01"
       }
     }
   ]
}