Warehouse & 3PL BC Location Card (Require Shipment / Require Pick) → Sales Line / Sales-Post BCApps source: BaseApp table Sales Line (Text016, WhseRequirementMsg, CheckWarehouseForQtyToShip); codeunit Sales-Post (WarehouseRequiredErr); test SCM Warehouse VII; Microsoft Learn: Ship items

Sales Order Line: Warehouse Shipment Is Required (Location Requires Shipment)

Raw System Error String
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

  1. 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'.
  2. 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.
  3. 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.
  4. 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.
  5. 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

How to verify: The order ships through a posted warehouse shipment (or from the order at a non-warehouse location) without the message, and the sales order shows the Quantity Shipped.

Sources & References

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.

We respect your privacy. No spam. You will only be contacted when pilot slots open for your stack.