Endpoint: POST /inbound-po

Full URL: https://api.spreetaileu.com/api/api/v1/inbound-po

Create a purchase order directly and synchronously in the warehouse system against an approved delivery slot. Returns the generated PO number immediately.

Requirements

• Authentication: Bearer token required (Get token from /auth/login)
• Delivery slot: an approved slot is required. Pass a slotReference that is confirmed and unused — book one via POST /inbound-slot. Without a slot there is no agreed delivery date for the warehouse to work to, so the request is rejected with 409
• SKU resolution: every item must resolve to exactly one known product (matched by barcode first, then SKU)

The slot already told us the shape of the delivery

You don't repeat it here. The PO inherits the slot's warehouse, delivery date and window, truck-vs-container, container size, loading type, SKU bucket and pallet count. All you send is the PO reference, the items, and the things a slot booking can't know.

The slot is claimed atomically and released again if PO creation fails.

Important Fields

• PO_REFERENCE: your PO/delivery reference (becomes the supplier reference)
• containerTruckNumber and palletCount: the two deliberate overrides — the vehicle often isn't known at booking, and the pallet count is an estimate until the load is built. Omit either to keep what the slot recorded
• deliveryInfo and packingListFiles: not part of a slot booking, so send them here. For files, only references you uploaded yourself are accepted
• Warehouse_Name: comes from the slot. If you send it anyway it must match the slot's warehouse (409 otherwise) — it can't redirect an approved delivery
• Expected_Arrival_Date / estimatedArrivalWindow: ignored. The delivery date and window come from the slot; reschedule via the slot flow instead