Sales Order Line: Warehouse Shipment Is Required (Location Requires Shipment)
Warehouse Shipment is required for Line No. = 10000.What It Means
The sales line uses a location where 'Require Shipment' is turned on. Business Central wants you to ship through a Warehouse Shipment document, not from the sales order. You see one of three messages: (1) a warning when you set Qty. to Ship: 'Warehouse Shipment is required for this line. The entered information may be disregarded by warehouse activities.'; (2) an error 'Warehouse Shipment is required for Line No. = 10000.' when warehouse lines already exist for the line; (3) at posting: 'Warehouse handling is required for Document Type = Order, Document No. = ..., Line No. = 10000.'
Root Cause
In the Sales Line table, CheckWarehouseForQtyToShip calls CheckWarehouse when the location has Require Shipment and Qty. to Ship is not 0. If warehouse shipment or pick lines already exist for that sales line, it raises the error; if not, it shows the warning message. In Sales-Post, lines at a location with Require Shipment or Require Pick raise 'Warehouse handling is required...' when the location uses Directed Put-away and Pick or warehouse lines exist for the line. Learn: with Require Shipment on, you post the shipment from a warehouse shipment document (methods C and D). Typical triggers: an integration or user sets Qty. to Ship on the order, the wrong Location Code was defaulted onto the order, or the location setting was changed while orders were open.
Step-by-Step Fix
- Open the sales order and check the Location Code on the header and on each line. Open that Location Card and check 'Require Shipment' and 'Require Pick'.
- If the order should ship through the warehouse: do not post from the sales order. Release the order and choose 'Create Warehouse Shipment' (or let the warehouse use Get Source Documents). Create and register the pick if needed, then post the warehouse shipment.
- If warehouse shipment lines already exist for the line, finish or delete that warehouse shipment first; do not change Qty. to Ship on the sales line.
- If the order should not go through the warehouse: reopen it and change the Location Code on the lines to a location without Require Shipment (only if that is right for your stock and your 3PL), then post from the order.
- If an integration (Shopify, EDI, 3PL) sets Qty. to Ship or posts sales orders directly, change it to create or post warehouse shipments for locations that require shipment, or map its orders to a location that does not.
Verification Steps
Sources & References
- https://github.com/microsoft/BCApps/blob/main/src/Layers/W1/BaseApp/Sales/Document/SalesLine.Table.al
- https://github.com/microsoft/BCApps/blob/main/src/Layers/W1/BaseApp/Sales/Posting/SalesPost.Codeunit.al
- https://github.com/microsoft/BCApps/blob/main/src/Layers/W1/Tests/SCM-Warehouse/SCMWarehouseVII.Codeunit.al
- https://learn.microsoft.com/en-us/dynamics365/business-central/warehouse-how-ship-items
Early Access · 30-Day Sandbox Pilot
Stop Order Sync Failures Before Customers Notice
The Order Flow Doctor monitors Microsoft Dynamics 365 Business Central order flows across Shopify, EDI (TrueCommerce, SPS), 3PLs, and carriers. Get automated root-cause diagnosis and one-click fixes.