Skip to main content

warehouseTransfersStepBack

Moves a transfer back to its previous status and returns it: Allocated to Draft, In Transit to Allocated, Delivered to In Transit, In Receiving to Delivered, Received to In Receiving, and Closed to Received.

Business Rules​

  • Allocated to Draft releases the hold at the origin building
  • In Transit to Allocated returns the shipped units to the origin’s stock and holds them again
  • Allowed when the destination’s counts come from an integration. The integration is not asked what it received, so units it already counted at the destination can also count at the origin
  • In Receiving to Delivered is refused once any units are received
  • Received to In Receiving counts the units not yet received as incoming again
  • The date of the status the transfer leaves is cleared: the ship date when it leaves In Transit, the arrival date when it leaves Delivered, and the received date when it leaves Received. The date of the status it returns to is kept
  • expectedStatus is the status the caller saw. The request is refused when the transfer has moved since, so a repeated or stale request cannot move it back one more step

Error Scenarios​

  • “Transfers are not enabled for this company”
  • “Transfer not found.”
  • “A Draft transfer cannot step back.”
  • “Un-receive every line before stepping back to Delivered.”
  • “This transfer is now Allocated. Reload it and try again.”
  • “This transfer changed. Reload and try again.”

Permissions Required​

  • warehouse:change_transfer_status
warehouseTransfersStepBack(
  input: WarehouseTransfersStepBackInput!
): WarehouseTransfer!

Arguments​

warehouseTransfersStepBack.input ● WarehouseTransfersStepBackInput! non-null input common​

Parameters for WarehouseTransfersStepBack

Type​

WarehouseTransfer object inventory​

A movement of the company’s own inventory from one of its buildings to another.

Allocating holds the units at the origin. Shipping takes them out of the origin’s stock and counts them as incoming at the destination. Receiving adds them to the destination’s stock. Marking the transfer Received writes off the units not received: they stop counting as incoming.