SFM Basis API Implementation Guide

About Reseptformidleren (RF) and Kjernejournal (KJ)

The SFM Basis API is based on interactions offered by the national systems Reseptformidleren (RF) and Kjernejournal (KJ). The underlying API's for the services provided by these are based on XML and webservices.

The SFM Basis API provides a standarized interface to e-resept. The interface supports all prescription relatated functions of the Reseptformidleren and the medication and allergy part of Kjernejournal. These two systems are subject of different regulations with different scopes and technologies, and serves as complementary systems in the chain.

  • Reseptformidleren - receives and shows the prescriptions for a patient.
    • Users are granted access when they have adequate authorization as healthcare professional, with license to issue prescriptions in Norway.
    • Prescription data is is available as long as it is needed for medication dispense.
    • Generally no historic data
    • Contains the current medication list for Multidose patients, and later also for all patients.
  • Kjernejournal - receives data from Reseptformidleren and keeps 3 years of history.
    • Users are granted access based on separate rules, and is available for a broader range of healtcare professional categories than Reseptformidleren
    • Contains also a record of Critical info / Allergy intolerance data.
    • It is possible for patients to opt out for this journal.

Due to the regulation differences there may be situations where a patient has prescription information in only one of the systems.

Typically a nurse looking up medical information using this API will only receive information from Kjernejournal, but a doctor or dentist will receive aggregated information from both.

The SFM API Basis aims to make these legal differences somewhat transparent to the user and the implementer, by accessing the relevant systems for the user and aggregate the information for the end-system regardless of the origin of the information. The healthcare professional category and licenses of the user determines the right to submit information, and the source when you read information.

For information on errorcodes from KJ see page: https://kjernejournal.atlassian.net/wiki/spaces/KJERNEJOURDOK1/pages/664635127/Error+codes+and+messages (Note that as of 2022-12-01 this page is not up to date)