Skip to main content

warehouseTransfersUpdate

Changes a transfer’s details or lines and returns it.

Business Rules​

  • Only the arguments sent change. Send null to clear a value
  • items replaces every line. A product that stays keeps its line
  • Lines and buildings change only while the transfer is a draft. Sending the values the transfer already has is not a change
  • The receiving location must be in the destination building, and cannot change once units are received
  • A canceled transfer cannot change
  • Received quantities are recorded with warehouseTransfersRecordReceipts
  • Costs are amounts in the company’s currency
  • The arrival date cannot be earlier than the ship date, and the received date cannot be earlier than either. The same day is allowed
  • transferNumber renames the transfer. Spaces before and after it are removed. It cannot be blank or null, has at most 60 characters, and cannot match another transfer’s number in the company, archived transfers included

Error Scenarios​

  • “Transfers are not enabled for this company”
  • “Transfer not found.”
  • “Transfer number must be present and 60 characters or fewer.”
  • “Transfer number TRF-2026-0001 is already used.”
  • “Lines can only change while the transfer is a draft”
  • “The arrival date can’t be earlier than the ship date (Oct 20, 2026).”
  • A message naming the SKU when a product appears twice or a quantity has too many decimal places

Permissions Required​

  • warehouse:update_transfer
warehouseTransfersUpdate(
  input: WarehouseTransfersUpdateInput!
): WarehouseTransfer!

Arguments​

warehouseTransfersUpdate.input ● WarehouseTransfersUpdateInput! non-null input common​

Parameters for WarehouseTransfersUpdate

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.