Skip to content

Send a Medical Document

The Lifen API allows you to securely send a medical document to any French healthcare professional. Currently, we offer four shipping channels :

  • MMSanté: official health messaging. More information on https://www.mssante.fr/home Lifen is an MSSanté operator (certified by ASIP Santé)

  • Apycript: most used health messaging. More information on https://www.apicrypt.org/

  • Lifen: health messaging available only to Lifen users

  • Postal: when paperless shipping is not available, Lifen can send a letter (with additional cost)

Access Control

You have to use the Access Token of an authenticated user with the BINARY_CREATE, DOCUMENTREFERENCE_CREATE and COMMUNICATIONREQUEST_CREATE permissions in the scope to access the FHIR Patient API. For user authentication, take a look at the Connect Users Guide.

How do I send a document to a healthcare professional ?

You have to upload the document on the FHIR Document API, add some metadata to it, then create a request of communication.

Create a Binary resource to upload a PDF report

See: How to create a Binary

Create a DocumentReference resource containing the document's metadata

See: How to create a DocumentReference

Create a CommunicationRequest resource to order a document exchange

Send a POST api.lifen.fr/fhir/v2/CommunicationRequest with a JSON body referencing the previously created DocumentReference as well as the sender of the document.

The subject and recipients of the communication will be completed by Lifen's artificial intelligence who analyzes the document to send.

Example :

{
  "resourceType": "CommunicationRequest",
  "meta": {
      "tag": [
          {
            "system": "http://lifen.fr/fhir/tag/processing/mode",
            "code": "IMMEDIATE_MODE",
            "display": "request should be treated in immediate mode"
          },
          {
            "system": "http://lifen.fr/fhir/tag/processing/ia",
            "code": "NEW_PROCESSING_REQUIRED"
          }
      ]
  },
  "status": "draft",
  "priority": "routine",
  "category": [
    {
      "coding": [
        {
          "system": "http://lifen.fr/fhir/ValueSet/communication-category",
          "code": "MEDICAL_REPORT"
        }
      ]
    }
  ],
  "payload": [
    {
      "contentReference": {
        "reference": "DocumentReference/XXXXXX"
      }
    }
  ],
  "authoredOn": "2020-09-02T14:54:09+00:00",
  "sender": {
    "reference": "Practitioner/XXXXXX"
  },
  "requester": {
    "agent": {
      "reference": "Organization/XXXXXX"
    }
  }
}

Take care of the following attributes :

  • sender :
    • User token : one of the identities to choose in the http://lifen.fr/userInfo.identities array from the user's ID token
    • Application token : ask our solution architect at Lifen for the Organization FHIR reference corresponding to healthcare organization you are connected to
  • requester :
    • User token : the value of http://lifen.fr/userInfo.currentWorkspaceId from the user's ID token
    • Application token : ask our solution architect at Lifen for the Organization FHIR reference corresponding to your application

Check the Connect Users Guide to find out how to read user information.

After that, the CommunicationRequest will be integrated into Lifen's sending flow to add some other information and send the document to all the recipients found.