Procurement API
Procurement Deliveries
Follow fulfilment and delivery information associated with procurement orders.
Shipment status
Real-time fulfilment
Partial deliveries
Supported
Exceptions
Delay & shortage states
Traceability
Order-linked history
Delivery model
| Resource | Purpose | Key relationship |
|---|---|---|
| delivery | Shipment / delivery aggregate | purchase_order_id |
| package | Physical parcel or shipment unit | delivery_id |
| delivery_item | Fulfilled PO line quantity | order_item_id |
| proof | Delivery proof / reference | delivery_id |
Shipment status
preparingreadydispatchedin_transitdeliveredPartial deliveries
A purchase order may be fulfilled by several deliveries. Track fulfilled quantities per order line rather than assuming one order equals one shipment.
Exceptions
| State | Meaning | Recommended action |
|---|---|---|
| delayed | Expected delivery moved | Surface updated ETA |
| shortage | Quantity unavailable | Reconcile outstanding line quantity |
| failed | Delivery attempt failed | Await supplier/carrier resolution |
| damaged | Goods damaged | Create return / dispute flow |
Proof & references
| Field | Example |
|---|---|
| tracking_number | LU123456789 |
| carrier | DHL |
| supplier_delivery_ref | DEL-2026-8842 |
| proof_url | Signed document / receipt reference |
| delivered_at | 2026-08-18T14:32:00Z |
Example request
cURLJavaScriptPython
curl "https://api.mediloop.com/v1/procurement/deliveries?purchase_order_id=po_42" \
-H "Authorization: Bearer $MEDILOOP_API_KEY" \
-H "X-Tenant-Id: $TENANT_ID"List deliveries for an order
Response200 OK
{
"data": [{ "id":"del_91", "status":"in_transit", "tracking_number":"LU123456789", "eta":"2026-08-20" }]
}