Send a Medical Document to HCP v2

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

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

• 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 v2.

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: Create Binary v2

Create a DocumentReference resource containing the document's metadata

See: Create DocumentReference v2

Create a CommunicationRequest resource to order a document exchange

Send a POST

• production environment : https://api.lifen.fr/fhir/v2/CommunicationRequest
• test environment : https://api.post-prod.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 v2 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.