Mailbox Data Object (Schemas)

📃

Note:

An empty string "" is considered a value and validation rules will apply (length/valid code/etc). Only null or missing elements will use default values.

Mailbox fetch parameters

Query Parameter

ParameterTypeCharacter LimitRequired/OptionalDescription
messageCountInt3Requiredused to define how many messages should be returned per batch. Maximum will be 100 messages. if no value passed, the default is 100 messages per batch

RxTransfer event Type

RxTransfer Response Object

FieldTypeCharacter LimitDescription
eventIdStringmaxUnique event identifier in HealthDyne system.
eventDateUtcString27UTC timestamp of when the event occurred.
eventTypeString50Type of event, e.g., "RXTRANSFER".
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
scriptKeyString50Unique identifier for the script being transferred which is initially defined by client.
detailRxTransferDetailObjectNested object containing extra details specific to the event type

RxTransferDetailObject

FieldTypeCharacter LimitDescription
patientKeyString50Unique identifier for the patient.
rxNumberString30Prescription number

RxStatus event Type

RxStatus Response Object

FieldTypeCharacter LimitDescription
eventIdStringmaxUnique event identifier in HealthDyne system.
eventDateUtcString27UTC timestamp of when the event occurred.
eventTypeString50Type of event, e.g., "RXTRANSFER".
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
scriptKeyString50Unique identifier for the script being transferred which is initially defined by client.
patientKeyString50Unique identifier for the patient.
detailRxStatusDetailObjectNested object containing extra details specific to the event type

RxStatusDetailObject

FieldTypeCharacter LimitDescription
reasonString255Reason for the status if any

FillRequest event Type

FillRequest Response Object

FieldTypeCharacter LimitDescription
eventIdStringmaxUnique event identifier in HealthDyne system.
eventDateUtcString27UTC timestamp of when the event occurred.
eventTypeString50Type of event, e.g., "RXTRANSFER".
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
fillRequestKeyString50Unique identifier for the fill request which is initially defined by client.
detailFillRequestDetailObjectNested object containing extra details specific to the event type

FillRequestDetailObject

FieldTypeCharacter LimitDescription
orderNumberString100order number
scriptKeyString50Unique identifier for the script being transferred which is initially defined by client.
fillNumberIntShows how many fills have been fulfilled for this Rx
remainingRefillsString10Show how many fill remaing for the Rx
refillByDateStringDate recommended for refill
shipments[ShipmentObject]shipment information

ShipmentObject

FieldTypeCharacter LimitDescription
address[AddressObject ]address information.
trackingNumberString50Package tracking number.
shipmentCodeString20Code representing the shipment type.
trackingUrlString10URL for tracking the shipment.
weightIntWeight of the shipment.
costIntShipping cost.
dispensedQtyString20Quantity of medication dispensed.
daysSupplyString20Number of days the dispensed medication will last.
shipmentDateString30The date the shipment was sent.

AddressObject

FieldTypeCharacter LimitDescription
address1String255address 1 information.
address2String50address 2 information.
cityString40Shipped to city.
stateString2Shipped to state.
zipcodeString5Shipped to zip code.

Submitted

FieldTypeCharacter LimitRequired/OptionalDescription
eventIdString4 bytes (32-bit signed int)RequiredUnique Event Identifier for the Fill Request.
eventDateUtcDateTimeYYYY-MM-DD T HH:MM:SS.microseconds ZRequiredDate and time of the event in UTC (ISO 8601).
scriptKeysArray50 per valueRequiredList of Array of scriptKey(s) (scriptKey is unique Id associated with script request).

RxVerified

FieldTypeCharacter LimitDescription
eventIdString4 bytes (32-bit signed int)Unique Event Identifier for the Fill Request.
eventDateUtcDateTimeYYYY-MM-DD T HH:MM:SS.microseconds ZDate and time of the event in UTC (ISO 8601).
eventTypeString50Event type description.
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
FillRequestKeyString50Unique ID associated with fill request.
detailRxVerified detailContains details of fill request that was verified.

RxVerified detail

FieldTypeCharacter LimitDescription
orderNumberString50Order number used to track this order.
scriptKeyString50Unique ID associated with script key.
fillNumberString50Fill number that was dispensed.
dispenseDrugdispenseDrugDispensed drug object.

Dispense Drug

FieldTypeCharacter LimitDescription
dispenseNDCString50NDC of drug that was dispensed.
dispenseDrugNameString50Drug name that was dispensed.
daysSupplyString50Days the supply will last for.
dispenseQuantityString50Dispensed quantity
labelDirectionsString50Drug usage label direction text.
dosageFormString50Drug dosage form.
drugStrengthString50Shows strength of the drug.
drugStrengthUOMString50Drug strength unit of measure.

RxShipped

FieldTypeCharacter LimitDescription
eventIdString4 bytes (32-bit signed int)Unique Event Identifier for the Fill Request.
eventDateUtcDateTimeYYYY-MM-DD T HH:MM:SS.microseconds ZDate and time of the event in UTC (ISO 8601).
eventTypeString50Event type description.
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
FillRequestKeyString50Unique ID associated with fill request.
trackingNumberString40Shipment tracking number.
detailRxShipped detailShipments info object.

RxShipped detail

FieldTypeCharacter LimitDescription
orderNumberString50Order number used to track this order.
scriptKeyString50Unique ID associated with script key.
shipmentsshipmentsShipments info object.

shipments

FieldTypeCharacter LimitDescription
addressobjectContains shipment address information (note that currently it will always be null)
trackingNumberString50Order tracking number.
shipmentCodeString50Shipment code used to ship the order.
trackingUrlString50URL to track the order shipment status.
weightString50Package weight.
dispensedQtyString50Dispensed quantity in shipped order.
daysSupplyString50Day supply in the order.
shipmentDateStringYYYY-MM-DD T HH:MM:SS ZDate order was shipped.

RxIssue

FieldTypeCharacter LimitDescription
eventIdString4 bytes (32-bit signed int)Unique Event Identifier for the Fill Request.
eventDateUtcDateTimeYYYY-MM-DD T HH:MM:SS.microseconds ZDate and time of the event in UTC (ISO 8601).
eventTypeString50Event type description.
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
FillRequestKeyString50Unique ID associated with fill request.
detailRxIssue detailShipments info object.

RxIssue detail

FieldTypeCharacter LimitDescription
orderNumberString50Order number used to track this order.
scriptKeyString50Unique ID associated with script key.
fillNumberInt2Shows how many fills have been fulfilled for this Rx
issueMessageString50Descriptive message explaining the issue.

RxCanceled

FieldTypeCharacter LimitDescription
eventIdString4 bytes (32-bit signed int)Unique Event Identifier for the Fill Request.
eventDateUtcDateTimeYYYY-MM-DD T HH:MM:SS.microseconds ZDate and time of the event in UTC (ISO 8601).
eventTypeString50Event type description.
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
FillRequestKeyString50Unique ID associated with fill request.
detailRxCanceled detailShipments info object.

RxCanceled detail

FieldTypeCharacter LimitDescription
orderNumberString50Order number used to track this order.
scriptKeyString50Unique ID associated with script key.
fillNumberInt2Shows how many fills have been fulfilled for this Rx

Received Event

FieldTypeCharacter LimitDescription
eventIdStringmaxUnique event identifier in HealthDyne system.
eventDateUtcString27UTC timestamp of when the event occurred.
eventTypeString50Type of event, e.g., "RXTRANSFER".
statusString20Current status of the event.
statusMessageStringmaxDescriptive message explaining the status.
scriptKeyString50Unique identifier for the script being transferred which is initially defined by client.
patientKeyString50Unique identifier for the patient.
detailReceived DetailNested object containing extra details specific to the event type

Received Detail

FieldTypeCharacter LimitDescription
reasonString255Reason for the status if any