Shipments

Public Preview: Asset Lifecycle is in public preview. The functionality and API surface may evolve in future releases.

A shipment records the delivery of equipment against a purchase order. Each shipment is dispatched by a single courier and may include any number of line items drawn from the purchase order's BOM line items.

Multiple shipments may be associated with a single purchase order - for example, when an order is fulfilled in several deliveries or when a partial shipment is replaced.

Fields

Purchase Order

The purchase order this shipment delivers against.

Courier

The courier delivering the shipment.

Courier Account

The courier account being billed for the shipment. Optional. If specified, the account must belong to the selected courier.

Site

The destination site for the shipment. Optional.

Location

The destination location within the site. Optional. If specified, the location must belong to the selected site.

Tracking Number

The tracking number provided by the courier. The combination of courier and tracking number must be unique. When the courier has a tracking URL defined, this value is rendered as a clickable link.

Status

The shipment's lifecycle status. One of:

• Prepared (default)
• Shipped
• Received
• Cancelled
• Returned
• Lost

Permitted status transitions are controlled by status transition rules.

Date Shipped

The date on which the shipment left the vendor. Optional.

Date Expected

The date on which the shipment is expected to arrive. Optional. Must not be earlier than the date shipped.

Date Received

The date on which the shipment was received. Optional. Must not be earlier than the date shipped.