Update Item Place External
POST/api/items/updateplaceexternal
Tier: Public — stable, supported for third-party integration.
Records a movement of a single item to a new place.
MovedOn supports back-dated movements: the movement is inserted into the item's movement history at the correct chronological position, and the item's current place/last-moved timestamp only change when the new record is the newest one. ReferenceId de-duplicates integration-driven movements with the same reference.
A move from state Allocated only allows a further transition to Dispatched or Present; from Reserved only to OnLoan or Present; from Dispatched only to Received or Missing; from OnLoan only to Returned or Missing; from Consumed only to Restored — any other move from these states is rejected.
Side effects: an Items.ItemPlaceMovementHistoryDto row and an
Items.ItemStateHistoryDto row (state Moved) are written, and the item's
SkuPlaceStock is adjusted.
Request
Responses
- 200
- 400
- 401
- 403
Returns the updated item. See Items.ItemDetailDto.
Validation failure, including: the item does not exist or is not visible ("Invalid Item", NotFound); the destination place does not exist ("New Place doesn't exist", OperationFailed); the item is already at the destination and the request has neither a ReferenceId nor geo-coordinates (ItemAlreadyInLocation); ReasonId refers to a reason whose scope is not Item ("Invalid Reason Scope", InvalidReference); or the item's current state does not allow a move ("Item not allowed to move").
Caller is not authenticated.
Caller does not have Update permission on the Item module.