Skip to main content

Append Tags To Order

POST 
/api/orders/appendtags

Tier: Public — stable, supported for third-party integration.

Grows an ad-hoc order by turning scanned tags directly into order lines, rather than requiring the lines to be pre-defined.

Depending on AppendTagsToOrderDto.ProcessAs, each scanned tag either becomes/increments a unique-item line, an outer-SKU line (an inner-SKU scan accrues 1 / InnerQuantity against the outer line), or its own SKU line. Unknown tags cause new items to be auto-created (subject to the same operational-SKU rule as order creation). The order automatically transitions Open → Allocating or Receiving on the first append, depending on order type. Raises OrderSnapshotAdded on success. Supports the async AddOrderSnapshotDto.NotifyOnceComplete pattern described on Controllers.OrderController.

Request​

Responses​

Returns Orders.OrderOperationResultDto — either the updated order (OrderDto) or a queued BackgroundTaskId.