Provide Geographic Zone as FHIR Location


As an OpenLMIS administrator, I want my Geographic Zones to have a representation as FHIR Location so that other systems may inter-operate with OpenLMIS through the OpenHIE mCSD profile.

From Geographic Zone -> Location:

  • id -> id

  • code -> alias

  • level -> identifier (see examples for using the levels URI and UUID)

  • name -> name

  • latitude & longitude -> position

Also include:


  • All geographic zones are represented as FHIR locations at `GET /api/Location`
    (Note: This breaks our OpenLMIS API Style Guide because this matches FHIR specifications.)

  • Geographic zone heirarchy is naviagable by Location.partOf

  • don't bother with etags, returning a single resource (e.g. `/api/Location/{id}`), paging or building search capabilities

  • don't bother with operations other than GET


Joanna Bebak
January 29, 2018, 8:05 AM

I thought so but I had to make sure, as I didn't find any other ticket that could be related to that endpoint, which appeared new to me. All right, I will remember about it in the future. In that case, I will close the ticket.

Sebastian Brudziński
January 29, 2018, 7:55 AM

/api/geographicZones/byLocation has nothing to do with this ticket.
On a side note, please always mention someone who can answer your questions in the ticket comment and daily Slack report so those questions are not lost.

Joanna Bebak
January 26, 2018, 2:02 PM

I tested the GET/api/Location endpoint, and everything works correctly. Yet I noticed that there is also a POST/api/geographicZones/byLocation endpoint and I'm not sure if it's a part of this ticket or not. If not, this ticket can be closed.

Łukasz Lewczyński
January 26, 2018, 9:48 AM

Because we work on in a response there could be additional entries related with facilities. Please ignore them until you will verify

Mary Jo Kochendorfer
January 18, 2018, 4:24 PM

From the grooming call:



Łukasz Lewczyński


Josh Zamor