Skip to main content

warehouseTransfersRecordReceipts

Records the total units received on transfer lines and returns the transfer.

Business Rules​

  • Allowed while the transfer is Delivered or In Receiving. To change a Received transfer’s quantities, step it back to In Receiving first
  • A changed receipt on a Delivered transfer moves it to In Receiving in the same step
  • Each quantity replaces the line’s earlier total. The difference, up or down, moves into or out of the receiving location; lowering a total un-receives units
  • The receiving location is fixed at the first receipt: the transfer’s receiving location when set, otherwise the destination’s default available location
  • When the destination’s counts are synced from an integration, quantities are recorded and stock does not move
  • Receiving more than a line’s quantity is allowed. Negative quantities are refused
  • Each line sends receivedQuantity or receivedAmount, in the line’s unit of measure. Decimal places are allowed only for products stored in a finer unit
  • Lines whose total did not change are left alone

Error Scenarios​

  • “Transfers are not enabled for this company”
  • “Transfer not found.”
  • “Each line can only appear once in a receipt.”
  • “Revert the transfer to In Receiving to change received quantities.”
  • “Received quantities can only change while the transfer is Delivered or In Receiving.”
  • A refusal naming the problem when the destination has no usable receiving location
  • A message naming the SKU when a received amount has too many decimal places

Permissions Required​

  • warehouse:receive_transfer
warehouseTransfersRecordReceipts(
  input: WarehouseTransfersRecordReceiptsInput!
): WarehouseTransfer!

Arguments​

warehouseTransfersRecordReceipts.input ● WarehouseTransfersRecordReceiptsInput! non-null input common​

Parameters for WarehouseTransfersRecordReceipts

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.