Zentriq Agent is live on Microsoft AppSourceInstall it free →Microsoft AppSourceInstall it free →

"Warehouse handling is required for Document Type = Order, Document No. = 101005, Line No. = 10000."

Warehouse handling is required for this document

The location used on that line is set up to require warehouse documents, so the order cannot be shipped, received or posted directly from the order itself. Business Central expects a warehouse shipment, warehouse receipt, inventory pick or inventory put-away, created from the released document and registered or posted first. Release the document, create the matching warehouse document, handle the quantity there, then post.

Why Business Central raises this error

Each location decides how much of the warehouse flow is mandatory through its Require Receive, Require Shipment, Require Put-away and Require Pick settings. As soon as one of them applies to the line, posting from the order would bypass the physical step the setup insists on, so the posting routine refuses and points you at the document type, number and line number that triggered it. The transfer variant of the message reads Warehouse handling is required for Transfer order = 1001, Line No. = 10000, and works the same way: the from-location governs the shipment side and the to-location governs the receipt side.

  • The location on the line has Require Pick, Require Shipment, Require Receive or Require Put-away enabled, and someone tried to post the quantity straight from the order.
  • The location on a line was changed, or the line was added at a warehouse-managed location while the rest of the order sits at a simpler one.
  • A transfer order ships from, or receives at, a location that requires warehouse handling, so the transfer cannot be posted from the transfer order itself.

How to fix it

  1. Read the document type, document number and line number from the message and open that document, then note the Location Code on the failing line.
  2. Open the location card for that code and look at its warehouse settings, Require Receive, Require Shipment, Require Put-away and Require Pick, to see which document Business Central is waiting for.
  3. Release the document with Release (Ctrl+F9), because warehouse documents can only be created from released documents.
  4. For an outbound line, create the warehouse shipment from the order, or use Create Inventory Pick if the location only requires a pick; for an inbound line, create the warehouse receipt, or use Create Inventory Put-away if only a put-away is required.
  5. Open the warehouse document, fill in the quantity to handle, then register the pick or put-away and post the shipment or receipt from that document rather than from the order.
  6. For a transfer order, complete the shipment side at the from-location first and only then handle the receipt at the to-location, since each side follows its own location setup.

How to avoid it in future

The error is a setup boundary rather than a mistake: someone is using an order-level shortcut at a location that was deliberately configured for warehouse handling. Keeping default locations correct on customer and vendor cards, and on the responsibility centres users work in, means lines rarely land on the wrong location by accident. If a location requires warehouse documents in theory but nobody uses them in practice, the honest fix is a decision by the administrator to relax the location setup, not a workaround on each order, and it should be made only when no warehouse documents are open for that location.

Frequently asked questions

Can I switch the requirement off so users can post from the order?

Yes, by clearing the relevant Require setting on the location card, but that is an administrator decision that changes how the whole location works. Do it only when no warehouse documents are open for that location, otherwise the open documents become orphaned and confusing.

Why do some lines at the same location post without this error?

Warehouse handling only applies to lines that move physical inventory. Service lines, charge lines, general ledger lines and drop shipment lines never touch the warehouse, so they post directly even at a location that requires picks or receipts.

Related topics

Other Business Central errors