Sales Blanket Orders Realtime-enabled

Read and write Sales Blanket Orders, long-term sales agreements. Microsoft excluded blanket orders from the standard v2 API (its v2 sales entities are built on aggregate buffer tables that were never created for blanket orders); this endpoint can expose them because it binds directly to Sales Header / Sales Line filtered to Document Type = Blanket Order.

Resolve the customer

The sell-to customer can be set three ways: customerNumber, the Business Central customerId, or customerIntegrationId. The last is a resolver field, supplying it looks up the Customer whose EONE Integration Id matches and stamps Sell-to Customer No. for you. See integrationId for how the store's own key round-trips on the header.

Deep insert (header + lines in one call)

POST a full blanket order with its lines nested under salesBlanketOrderLines in a single request. Business Central stamps Document Type and Document No. onto each child line automatically via the SubPageLink.

POST/salesBlanketOrders

{
  "customerIntegrationId": "CUST-1001",
  "externalDocumentNumber": "BLKT-2026-07",
  "salesBlanketOrderLines": [
    { "itemNumber": "1000", "quantity": 500, "quantityToShip": 100 }
  ]
}

The work description

workDescription is the free-text note on the document, the same text the Work Description box shows on the blanket sales order in Business Central. Send it on create or update and SmartConnect replaces the whole note, send an empty string to clear it, and leave it out to keep what is already there. Every read returns it.

Bound actions

release / reopen. POST /salesBlanketOrders({id})/Microsoft.NAV.release to release the document, or …/Microsoft.NAV.reopen to return a released blanket order to Open.

makeOrder. Converts the blanket order into a Sales Order (via codeunit Blanket Sales Order to Order), shipping quantityToShip from each line onto the new order. The response redirects to the resulting record on the salesOrders entity set, not back to the blanket order.

POST/salesBlanketOrders({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.