Phase I - Add It
April 2019
Dsco will first be simply adding the dscoLifecycle attribute to co-exist with the status attribute on orders.

Phase II - Modify Dsco Reports
May/June 2019
Dsco will then modify Dsco's reports to use the new status.

Phase III - Modify Dsco Workflows
May-August 2019
Dsco will then modify its own internal workflows to use the new dscoLifecycle attribute as an event trigger for order workflows including order export, order webhook workflows and others.

Phase IV - Deprecate Status
May-August 2019
Dsco will then deprecate the order.status atttribute.

Phase V - Remove Status
October 2019
The order.status attribute will be removed.

Today's order.status attribute, seen in the diagram above, transitions from the "shipment pending" state to the "shipped" state when any quantity on any order line item is shipped.  Today's order.status transitions to "cancelled" only when all quantity on all items are cancelled.  This state machine is inconsistent and confusing.

The new order.dscoLifecyle state machine, seen in the diagram above, corrects the issues with the existing order.status states.

• received
  Dsco has received an order, but it's not yet ready for a supplier to take the order.
• created
  A newly received order is now ready for a supplier to take the order and fulfill it.
• acknowledged
  The supplier has the order, either because the order was exported to the user or because the order was specifically acknowledged, perhaps via APIs.  It's possible that some quantity of the order's line items are either shipped or cancelled but there is still order line item quantity that is not shipped or cancelled.
• completed
  All quantity of all line items on the order are either shipped or cancelled.