Purchase Blanket Orders Realtime-enabled

Read and write Blanket Purchase Orders. This is the Purchase Header filtered to Document Type = Blanket Order, the same physical table behind orders and invoices, scoped to blanket orders here. POST a whole document (header plus purchaseBlanketOrderLines) in one call; the document type is stamped for you on insert.

Resolve the vendor

You do not need the Business Central vendor number. Send any one of vendorNumber, vendorId, or vendorIntegrationId. The last is a res field that looks the vendor up by its integrationId and sets Buy-from Vendor No. for you. See resolvers.

Create a blanket order

POST/purchaseBlanketOrders

{
  "vendorIntegrationId": "ACME-001",
  "integrationId": "PBO-1000",
  "purchaseBlanketOrderLines": [
    { "itemNumber": "1000", "quantity": 100, "directUnitCost": 4.50 }
  ]
}

Currency

currencyCode uses the ISO code (e.g. USD). The local currency (LCY) round-trips as an empty string, not its ISO code. Send "" for documents in your home currency.

Bound actions

release performs a manual release and reopen returns a released blanket order to Open. Release a blanket order through the API when an approval flow needs it released and left for a person to finish.

POST/purchaseBlanketOrders({id})/Microsoft.NAV.release

makeOrder converts the blanket order into a Purchase Order via the standard Blanket Purch. Order to Order process.

POST/purchaseBlanketOrders({id})/Microsoft.NAV.makeOrder

archive / cancel snapshot a version and keep the blanket order open, or archive then delete it (soft delete). See Archiving & cancelling.