Purchasing Manager API

Suppliers and purchase orders: raise one, send it, receive what arrives and record its costs.

Event-sourced purchase-order (receiving) service. Owns the PO lifecycle, expected vs confirmed costs, landed costs, and unit/lot identity capture at receipt (it is the serial-uniqueness authority). Quantity movements are commanded through the inventory service, which remains the platform's source of truth for stock levels.

Base URL

https://purchasing.getmanifold.io

Auth

A bearer token on every call. See the quickstart.

OpenAPI

purchasing-manager.openapi.json

pos

Purchase-order lifecycle: draft → authorised → partially-received → received → invoiced → closed, or cancelled.

• GET /supplier-prices What suppliers charge
• PUT /supplier-prices/{supplierId}/{sku} Set what a supplier charges for a SKU
• DELETE /supplier-prices/{supplierId}/{sku} Forget what a supplier charges for a SKU
• GET /pos A page of purchase orders from the current read model
• POST /pos Raise a draft purchase order with a supplier
• GET /incoming Stock on its way for skus
• GET /pos/{poId} One purchase order by its po_ id
• PUT /pos/{poId} Rewrite a purchase order
• DELETE /pos/{poId} Cancel a purchase order before any goods arrive
• PUT /pos/{poId}/expected Set the expected delivery day
• POST /pos/{poId}/authorise Authorise a draft PO
• POST /pos/{poId}/receipts Record goods arriving against an authorised PO
• POST /pos/{poId}/invoice Authorise the supplier invoice, confirming per-line unit costs
• POST /pos/{poId}/landed-costs Allocate an additional cost to an authorised
• POST /pos/{poId}/costs Journal an additional cost on the order by hand
• POST /pos/{poId}/costs/{costId}/reverse Reverse a cost on the order
• GET /supplier-payments Money paid to suppliers
• POST /supplier-payments Record money paid to a supplier against what one or more of its purchase orders owe
• POST /pos/{poId}/close Close a purchase order: done, read only from here
• POST /pos/{poId}/issues Report what was wrong with a delivery
• PUT /pos/{poId}/shipments/{shipmentId} Record an inbound shipment carrying goods of the order
• POST /pos/{poId}/shipments/{shipmentId}/tracking Record what the carrier said about an inbound shipment
• GET /supplier-performance The supplier scorecard
• GET /supplier-performance/{supplierId} One supplier's performance in depth
• GET /arrivals When each open purchase order will really arrive
• GET /restock-eta When a unit of each SKU is likely to be in hand

settings

Organization-level purchasing policy.

• GET /settings The organization's purchasing policy
• PUT /settings Replace the organization's purchasing policy

events

The purchasing append-only event log.

• GET /events Replay committed purchasing events at-or-after since
• GET /events/head The journal's position at a moment