Order Fulfillment Lifecycle

After an order is submitted, it may take anywhere from minutes to days to complete the order and retrieve data. During that time, the order will transition in state (potentially multiple times). Order fulfillment covers the complete process from when a request is made all the way through delivery of medical records to the client.

Order states

PhaseDescription
CreatedWe’ve received your request, but have not started the order yet. Orders will only be in this state for a short time. (< 5 minutes)
In ProgressWe are actively processing the order
PendedThe order is suspended due to a required input or decision. One or more tasks are open and need to be resolved
CompletedAn order is completed successfully when we have delivered the medical records or unsuccessfully when we’re unable to retrieve data within the allocated time frame
CancelledThe order is cancelled

Order state transitions

Along its lifecycle, an order will transition from a state to another based on lifecycle events.

FromTrigger
Created >> In ProgressThe order has officially started in our back end.
In Progress >> PendedThe order is suspended due to a requirement of additional input. One or more tasks have been created and must be resolved.
Pended >> In ProgressAll the open tasks have been resolved. The order fulfillment is resuming.
In Progress >> CompletedThe order fulfillment is complete (either we have delivered data or we couldn’t find any in time)
Pended >> CompletedThe order timed out.
In Progress >> CancelledWe have received a request to cancel the order
Pended >> CancelledWe have received a request to cancel the order

When do you need to monitor the order’s lifecycle?

  • You want users of your system to track progress directly from within your application (without having to visit the Human API Portal).
  • You want to trigger an automated business process based on the order lifecycle transitions (e.g. retrieve specific records when the order is complete).