This document provides the necessary details for third-party pharmacy partners to integrate with the Synkwise Healthcare Application using HL7 messages over the API.

Access Credentials

To communicate with the Synkwise Pharma API, pharmacy partners need login credentials (username and password) provided by a Synkwise representative.

API Environments

Synkwise API supports two environments:

• Test Environment: https://pharma.synkwise.dev/api/v2/inbound
• Production Environment: https://pharma.synkwise.com/api/v2/inbound

Endpoint

The endpoint for sending HL7 messages is:

POST <https://pharma.synkwise>.[env]/api/v2/inbound

Replace [env] with the appropriate environment (dev for test and com for production).

Request Structure

The body of the request should contain XML content with the following structure:

xmlCopy code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="<http://schemas.xmlsoap.org/soap/envelope/>" xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>" xmlns:xsd="<http://www.w3.org/2001/XMLSchema>">
    <soap:Body>
        <SendMessage xmlns="<http://www.softwriters.com/fwhl7/1.0/>">
            <userId>%userId%</userId>
            <passwordDigest>%passwordDigest%</passwordDigest>
            <nonce>%nonce%</nonce>
            <ts>%ts%</ts>
            <message>%message%</message>
        </SendMessage>
    </soap:Body>
</soap:Envelope>

Placeholder Descriptions

• %userId%: Your provided username
• %passwordDigest%: Digest calculated using the provided password, nonce, and timestamp