PurchasingHistoryEntry

A purchase order line for a specific item, with fulfillment tracking.

purchaseOrderNumberstring

The PO number this line belongs to.

Example: PO-2025-0471

vendorIdstring

Reference to the vendor on the PO.

vendorNamestring

Display name of the vendor.

Example: Pacific Ingredients Co.

orderDatestring<date>

Date the purchase order was placed (ISO 8601).

Example: 2025-03-15

expectedDeliveryDatestring<date>

Expected delivery date set when the PO was created or last updated by the vendor.

Example: 2025-03-22

statusstring

Current status of the overall purchase order.

Possible values: [draft, sent, accepted, shipped, partially_received, completed, cancelled, delayed]

Example: completed

quantityOrderednumber

Total quantity ordered on this line.

Example: 200

quantityReceivednumber

Total quantity received so far against this line. Updated each time an intake is recorded.

Example: 200

outstandingQuantitynumber

Remaining quantity not yet received (quantityOrdered minus quantityReceived). A value of 0 means the line is fully fulfilled.

Example: 0

unitstring

Unit of measure.

Example: lbs

unitPricenumber

Price per unit on this PO line.

Example: 3.25

lineStatusstring

Fulfillment status of this specific line item. pending means nothing has been received yet; partially_received means some but not all has arrived; fully_received means the ordered quantity has been delivered in full.

Possible values: [pending, partially_received, fully_received]

Example: fully_received

PurchasingHistoryEntry

{
  "purchaseOrderNumber": "PO-2025-0471",
  "vendorId": "string",
  "vendorName": "Pacific Ingredients Co.",
  "orderDate": "2025-03-15",
  "expectedDeliveryDate": "2025-03-22",
  "status": "completed",
  "quantityOrdered": 200,
  "quantityReceived": 200,
  "outstandingQuantity": 0,
  "unit": "lbs",
  "unitPrice": 3.25,
  "lineStatus": "fully_received"
}