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
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 IPP Use 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 | |
senderor 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"
}
}
]
}
Updated 8 months ago