Fill Request 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.

Fill Request Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
scriptKeysArray50RequiredList of Array of scriptKey(s) (scriptKey is unique Id associated with script request).
shippingObject (shipping)RequiredObject containing shipping information for the order.
insuranceObject (insurance)OptionalOptionally specify insurance information to be used on the fill request.

Shipping Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
addressObject (address)RequiredObject containing address information for order to be shipped to.
ShippingCodeString10RequiredShipping method to be used for the order. See Shipping Codesbelow
SaturdayDeliveryBooleantrue/falseOptionalValues: True/False. Saturday Delivery is an option for certain shipping codes, depending on the carrier. To have an order delivered on a Saturday, select the correct Shipping Code and then set this flag to true.
SignatureRequiredBooleantrue/falseOptionalValues: True/False. Select the option if the package requires a signature

Shipping Codes

CodeDescriptionNotes
POS 1CUSPS 1st ClassSaturday delivery
POS 1MUSPS PrioritySaturday delivery
UPS 1DUPS Next Day Air (12:00 PM Delivery)Saturday delivery
UPS 1DAMUPS Next Day Air AM DeliverySaturday delivery
UPS 1SUPS Next Day Air Saver (3:00 PM Delivery)Saturday delivery
UPS 2DUPS 2nd Day (12:00 PM Delivery)Saturday delivery
UPS 2DAMUPS 2nd Day (Morning Delivery)Saturday delivery
UPS GRUPS Ground
UPS MIDMail Innovations
UPS 3DSUPS 3 Day SelectSaturday delivery
UPS USGUPS-USPS Sure PostSaturday delivery

Address Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
line1String40RequiredStreet Address
line2String40OptionalStreet Address
line3String40OptionalStreet Address
cityString35RequiredCity
stateString2RequiredUS State Abbreviation Code
zipCodeString10RequiredFormat NNNNN or NNNNN-NNNN
countryCodeString2OptionalISO-3166 2 character country code. Defaults to US.

Insurance Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
planNumberString100RequiredInsurance plan number to be used on order previously provided by HealthDyne on a create Insurance response.
coPayString6RequiredPayment collected from the patient at checkout. Format "xx.xx" or "xxx.xx"
transactionNumberStringMaxRequiredThe payment transaction number. This should be the stripe transaction number if payment is managed by HealthDyne.
personCodeString3OptionalNumber 0 to 9.
relationshipCodeString1OptionalNumber 0 to 9. See relationship code table [below]

Relationship Codes

codeDescription
0Relation is NOT SPECIFIED
1Relation is CARDHOLDER
2Relation is SPOUSE
3Relation is CHILD
4Relation is OTHER DEPENDENT
5Relation is STUDENT DEPENDENT
6Relation is DISABLED DEPENDENT
7Relation is ADULT DEPENDENT
8Relation is SIGNIFICANT OTHER

GET Fill Request

Query Parameter

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
submittedArray [submitted]OptionalArray of submitted Objects containing event details.
rxVerifiedArray [rxVerified]OptionalArray of rxVerified objects containing verified information.
rxShippedArray [rxshipped]OptionalArray of rxShipped objects containing tracking/shipping information.
rxIssueArray [rxissue]OptionalArray of rxIssue objects containing issued information.
rxCanceledArray [rxcanceled]OptionalArray of rxCanceled objects containing cancel reason information.

SUBMIT Fill Request

Request Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
scriptKeysArray50 per valueRequiredList of Array of scriptKey(s) (scriptKey is unique Id associated with script request).
shippingObject (shipping)RequiredObject containing shipping information for the order.
insuranceObject (insurance)OptionalOptionally specify insurance information to be used on the fill request.

Shipping Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
addressObject (address)RequiredObject containing address information for order to be shipped to.
ShippingCodeString10RequiredShipping method to be used for the order. See Shipping Codesbelow
SaturdayDeliveryBooleantrue/falseOptionalValues: True/False. Saturday Delivery is an option for certain shipping codes, depending on the carrier. To have an order delivered on a Saturday, select the correct Shipping Code and then set this flag to true.
SignatureRequiredBooleantrue/falseOptionalValues: True/False. Select the option if the package requires a signature

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
messageStringMaxRequiredStatus messages string.

SUBMIT Fill Request

Request Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
scriptsKeysObject scriptsKeys50 per valueRequiredList of Array of scriptsKeys Object.
shippingObject (shipping)RequiredObject containing shipping information for the order.
transactionNumberStringRequiredA unique identifier assigned to each transaction by the client.

scriptsKeys Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
scriptsKeyString50RequiredUnique Id associated with script request
patientInsuranceObject patientInsuranceRequiredObject containing shipping information for the order.

patientInsurance Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
planNumberString10RequiredAn identifier representing a specific insurance or benefit plan associated with a transaction for the client.
clientItemCostDecimalRequiredThe base cost of the item (e.g., medication, product, or service) billed to the client before any additional fees or discounts.
clientDispenseFeeDecimalRequiredA fee charged to the client for the dispensing or handling of the item.
clientOtherFeeDecimalRequiredAn additional fee billed to the client that does not fall under item cost or dispensing.
clientCoPayDecimalRequiredThe portion of the transaction that the client is required to pay out-of-pocket.

Shipping Data Object

FieldTypeCharacter LimitRequired/OptionalDescription
addressObject (address)RequiredObject containing address information for order to be shipped to.
ShippingCodeString10RequiredShipping method to be used for the order. See Shipping Codesbelow
SaturdayDeliveryBooleantrue/falseOptionalValues: True/False. Saturday Delivery is an option for certain shipping codes, depending on the carrier. To have an order delivered on a Saturday, select the correct Shipping Code and then set this flag to true.
SignatureRequiredBooleantrue/falseOptionalValues: True/False. Select the option if the package requires a signature

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
messageStringMaxRequiredStatus messages string.


UPDATE Fill Request

Request Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
scriptKeysArray50 per valueRequiredList of Array of scriptKey(s) (scriptKey is unique Id associated with script request).
shippingObject (shipping)RequiredObject containing shipping information for the order.

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
messageStringMaxRequiredStatus messages string.

CANCEL Fill Request

Request Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
scriptKeysArray50 per valueRequiredList of Array of scriptKey(s) (scriptKey is unique Id associated with script request).
cancelReasonStringMaxRequiredTBD

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
fillRequestKeyString50RequiredUnique ID assigned by sending pharmacy to each fill request for tracking.
messageStringMaxRequiredStatus messages string.