Publisert - 26.02.2026

Event Lifecycle

This page shows an example on how the JFT API can be used to report a new event, and follow it throughout its lifecycle.

  • Acme Inc.'s software system EvRep is used to report events.
  • HealthRecords Corp.'s software system HRec is the EHR system.

Note

Some of the endpoints are not implemented yet. See Roadmap and the OpenApi docs for latest status.

Report event

A Bundle event is reported by Acme's EvRep SW using JFT's WriteAPI. The header nhn-source-system is optional, but Acme use it to identify the system which generated the event.

JFT registers the event at timestamp 2026-01-01 00:01 and allocates resourceId="abc" for the event.

JFT flow - report event

Check status (1)

After reporting the event, Acme checks the status of the event resource using the Status endpoint and the resourceId. The response indicates that the event has been successfully registered in JFT.

JFT flow - event status after reporting

Read events

HealthRecords reads new events using the search endpoint and the _lastUpdated parameter. The ReadApi logs the read event and returns the affected event resource in a searchset. The value specified by Acme in the nhn-source-system header is included in a meta extension field in the returned resource.

JFT flow - read events

Acknowledge journaling of event

HRec creates a journal note for the event, and sends an acknowledge message to update the event status in JFT.

JFT flow - journaling acknowledged

Check status (2)

Acme verifies that the event they reported has been successfully journaled. No further action is required.

JFT flow - event status after journaling

Søk i Utviklerportalen

Søket er fullført!