Skip to main content

JamFR

v1.0 · Spring Boot · Apache 2.0 · Port 8089

JamFR is the Facility Registry. It maps HL7v2 MSH-4 facility codes to FHIR Organization references, auto-provisions unknown facilities, and maps to DHIS2 orgUnit IDs for surveillance.

GET /fhir/Organization?identifier=BRANCH-01
Host: jamfr:8089

Response:

{
  "resourceType": "Organization",
  "id": "org-br01-001",
  "identifier": [{"system": "urn:chain.internal", "value": "BRANCH-01"}],
  "name": "Apollo Chain Branch 01",
  "type": [{"coding": [{"code": "prov", "display": "Healthcare Provider"}]}],
  "address": [{"city": "Colombo", "country": "LK"}]
}

Auto-provisioning​

When JamBridge receives a message from an unknown MSH-4 facility code and auto-provision: true:

  1. JamFR creates a new Organization with the facility code as identifier
  2. A PROVISIONED flag is set on the Organization
  3. An alert is sent to the JamFR admin for review and completion of metadata

DHIS2 mapping​

GET /fhir/Organization?identifier=BRANCH-01&_include=Organization:partof

The response includes a dhis2OrgUnit extension on each Organization:

"extension": [{"url": "http://jamfr.io/ext/dhis2-org-unit", "valueString": "OU_BRANCH_01"}]

This is used by JamBridge's DHIS2 dispatch to populate the orgUnit field in data values.