This process allows Netsmart myUnity to send HL7 records to FullCount for ADT integration and for FullCount to process these records internally. This service is located on FullCount integration server.
Authentication
All methods are authenticated via basic authentication. Usernames and passwords will be provided from FullCount to vendor. Separate credentials will be provided for internal and external users.
Send HL7 Records
This method will be called by Netsmart myUnity to send HL7 records to the FullCount integration server.
URL:
/hl7
Method:
POST
URL Params:
None
Data Params:
HL7 Message
MSH|^~\&|VISION^4932|743^amm|FullCount|FullCount|20160328203318||ADT^A01^ADT_A01|amm_7669|P|2.6
EVN|A01|20160328203318|20160316000000|03|testuser
PID|1|18787|18787^^^^PN^^20160328202500^||TestMonday^August10th^^^||19330302000000|M||2131-1||||||U|OTH|||||U||||||||N
PV1|1|I|^120^A^BPIL|R||^^^|||||||||||||BPIL-2330|||||||||||||||||||||||||20160301000000|
Success Response:
Code: 201
Content: “Y”
Error Response:
Code: 400
Content: “Message not formatted as HL7”
Code: 400
Content: “Incorrect HL7 version”
Code: 400
Content: “Unsupported HL7 format type”
Code: 400
Content: “No community found”
Code: 400
Content: “Message length longer than column size”
Code: 401
Content: Bad Credentials
Code: 500
Content: “Unknown Internal Error”
Request HL7 Data
This method will be called by FullCount application servers to request HL7 records for a specific community from the FullCount integration server.
URL:
/receive/:communityId
Method:
GET
URL Params:
Required:
communityId=[integer]
Example: /receive/10
Data Params:
None
Success Response:
Code: 200
Content: List of JSON objects containing HL7 Messages
[
{
"id": 1,
"createdBy": "Integration Process",
"modifiedBy": "Integration Process",
"createdDate": 1522251593151,
"modifiedDate": 1522251593151,
"contents": "MSH|^~\\&|VISION^4932|743^amm|FullCount|FullCount|20160328203318||ADT^A01^ADT_A01|amm_7669|P|2.6\rEVN|A01|20160328203318|20160316000000|03|testuser\rPID|1|18787|18787^^^^PN^^20160328202500^||TestMonday^August10th^^^||19330302000000|M||2131-1||||||U|OTH|||||U||||||||N\rPV1|1|I|^120^A^BPIL|R||^^^|||||||||||||BPIL-2330|||||||||||||||||||||||||20160301000000|",
"processed": "N",
"communityId": 10
}
]
Error Response:
Code: 401
Content: Bad Credentials
Code: 500
Content: Error Message
Mark Record as Processed
This method will be called by FullCount application servers to indicate that a specific HL7 record has been successfully processed and therefore stop the record from being processed again.
URL:
/processed/:id
Method:
PUT
URL Params:
Required:
id=[integer]
Example: /processed/1
Data Params:
None
Success Response:
Code: 204
Error Response:
Code: 400
Content: “Resource Not found for id: :id”
Code: 401
Content: Bad Credentials
Code: 500
Content: “Unknown Internal Error”