Registers a new patient with the Client Registry.
Transaction Specification
URL: POST /ws/rest/v1/patients/
Description: Registers a new client/patient in the client registry.
Request
HTTP request body will contain an HL7 v2.5 message that contains all of a patient information (demographic and identifying etc.) as defined below.
Data
See UC01.002 Maintain Client Registry for the latest data structure for this section.
Message specification
The HL7 message will be a HL7 v2.5 ADT_A28 message with the following structure:
See Register-or-Query-Client
Response
HTTP 201 - Created - If the client was saved.
The location (URI) of the newly created resource should be returned in the location header.
Error
HTTP 500 - Server Error - If the server encountered an error.
HTTP 400 - Bad Request - If the HL7 v2.5 message is malformed.
Orchestration
This section describes how this transaction is orchestrated through the HIM (interoperability layer) in order to complete this transaction.
- Call Register new client
Sample Messaging Implementation
Scenario 1
Registers a new patient from the Rwandan MoH's OpenMRS implementation with the Client Registry.
User Interface
TODO
(@Ishimwe, could you please insert images of the filled in user interface from OpenMRS when you have this completed)
Sample Request Message
(@Ishimwe, can you please insert a more complete message here generated from OpenMRS)
Note: This message is very incomplete and requires revision:
POST https://hie.jembi.org:5000/ws/rest/v1/patients HTTP/1.1
<?xml version="1.0"?> <ADT_A05 xmlns="urn:hl7-org:v2xml"> <MSH> <MSH.1>|</MSH.1> <MSH.2>^~\&</MSH.2> <MSH.7> <TS.1>20120322120032.479+0200</TS.1> </MSH.7> <MSH.9> <MSG.1>ADT</MSG.1> <MSG.2>A28</MSG.2> <MSG.3>ADT_A05</MSG.3> </MSH.9> <MSH.10>2</MSH.10> <MSH.11> <PT.1>T</PT.1> </MSH.11> <MSH.12> <VID.1>2.5</VID.1> </MSH.12> </MSH> </ADT_A05>
Sample Response Message
HTTP/1.1 201 Created