Create Replenishment Task
Creates one manual pending root, snapshots current UOM and Policy authority under lock, and
schedules the shared source/destination feasibility Planner. The response may remain pending
while the task-created dirty key is refreshed, then becomes released or visibly deferred.
Requires a staff Bearer token and an Idempotency-Key; retries with the same body return the
original task while a changed body is rejected.
Manual creation is allowed with automatic dispatch disabled and can exceed Warehouse and Lane
open-task caps. Manual roots count toward these caps and can delay new automatic Tasks,
including Emergency Tasks, until capacity becomes available.
Authorizations
Generate a JWT access token through a Custom Global Integration and provide it with each request in the Authorization header prefixed with "Bearer" and then a single space.
Headers
Caller-generated retry identity unique within the Warehouse.
1 - 64^[A-Za-z0-9._:-]+$Path Parameters
Warehouse identity.
Body
Product to replenish.
x >= 1Active Replenishment Lane whose destination Profile owns the task.
x >= 1Active Policy belonging to the selected Lane and Product Merchant.
x >= 1Requested quantity in replenished Product units before feasibility reduction. Must be a whole number of the Product's current confirmed move units.
0 < x <= 99999999.9999Must be a multiple of 0.0001Operator reason retained in the immutable task snapshot.
1 - 255Response
Created manual Replenishment task with locked snapshots and scheduled feasibility evaluation.
Durable, read-only snapshot of Replenishment work. Quantity fields are expressed in the
replenished Product's units. In Product quanta at the applicable LCM, qty_planned_total
equals the sum of unpicked, custody, placed, canceled, short/exception, and externally
satisfied quantities. Independently rounded decimal fields may not sum exactly. Mutations use the
task_revision and claim_lease_version compare-and-swap values.
Empty relationship expansion dictionary.
Additional metadata pertaining to the response.