SIGNALS Documentation
API Reference

Warehouse Transfers

Move stock between warehouses with dispatch, in-transit tracking, and receive.

Overview

A warehouse transfer moves stock from one warehouse to another. It carries an ST- reference, an origin and destination warehouse, and per-line requested/sent/received quantities. While the transfer is in transit, stock remains on the origin ledger and is held out of availability by a source-warehouse demand — ledger TransferOut / TransferIn post only on receipt.

Warehouse transfer UI routes:

Route Purpose
/warehouse-transfers Transfer index
/warehouse-transfers/create Create a draft transfer
/warehouse-transfers/{warehouseTransfer} Detail — lines, dispatch, receive, audit timeline
/warehouse-transfers/{warehouseTransfer}/edit Edit a draft transfer

Lifecycle

draft → in transit → received
  • Dispatch records quantity_sent and creates a source-warehouse availability demand for each line. Stock stays on the origin ledger; no TransferOut is posted yet. Barcoded assets remain at the origin under that demand hold.
  • Receive (line-level) posts TransferOut at the origin and TransferIn at the destination (creating the destination asset if it does not exist), then voids or shrinks the source demand for the received quantity. Barcoded assets have their warehouse_id moved to the destination.
  • A transfer stays in transit until every line is fully received, then its status becomes received.

Receiving is line-level, so partial receipts are supported; the same receive seam is used by the transfer scan context at the destination.

Cancelling

  • Enquiry transfers cancel with no stock movement and no demand.
  • In-transit transfers cancel by voiding the source availability demand. Stock never left the origin ledger, so no compensating ledger entry is posted.
  • Received or already-cancelled transfers cannot be cancelled.

Visibility & access

Transfers use either-warehouse visibility — a user who can access the origin or the destination can see the transfer. Dispatch is gated to origin access and receive to destination access.

Shortage resolution

When a shortage is resolved by moving stock from another warehouse, the shortage resolver now creates a real draft warehouse transfer for you, ready to dispatch. See Shortages.

Permissions

Permission Grants
warehouse_transfers.view See transfers
warehouse_transfers.create / .update Create and edit drafts
warehouse_transfers.dispatch Dispatch from the origin
warehouse_transfers.receive Receive at the destination
warehouse_transfers.delete Cancel a transfer

API

See the Warehouse Transfers API for the REST surface, including dispatch, receive, and line-receive routes.