Journal Service - Write API

This API is the gateway for submitting medical record data. The service accepts structured FHIR resources and ensures secure storage and processing.

Data Submission

The service supports the submission of the following FHIR resources:

• Composition: For clinical notes and documents.
• MedicationDispense: For successful medication dispensing events.
• Bundle: For grouping multiple resources in a single transaction (see example).

Endpoints

• POST /v1/Composition
• POST /v1/MedicationDispense
• POST /v1/Bundle

Validation and Rules

To ensure data quality and prevent the mixing of test and production data, the following checks are performed on every submission:

1. Technical Format Check

The API performs deserialization of the received JSON to ensure the content adheres to the FHIR standard. Requests with invalid JSON structures or missing mandatory FHIR elements will be rejected with 400 Bad Request.

2. Handling of National Identity Numbers (NIN)

Strict controls are in place regarding which types of identity numbers are allowed in different environments to ensure data separation:

• Production Environment:
  • Only real Norwegian national identity numbers are allowed.
  • Synthetic identity numbers are rejected.
• Test Environment:
  • Only synthetic identity numbers must be used.
  • Real identity numbers are rejected to prevent accidental use of actual personal data.

We recommend using SyntPop to generate valid synthetic test data for use in our test environments. More information can be found at NHN Developer Portal - SyntPop.

How to Submit

Data is submitted by posting a FHIR resource as JSON.

Example submission of a Bundle:

See Bundle resource example for details on format and structure.