Skip to main content
Version: v1.0.0

Inventory Transfers

An inventory transfer moves stock from one location to another. Because inventory is always tracked per location, a transfer is how you reflect goods physically relocating — and it accounts for the time they spend in transit between the two.

Transfers apply to both ledgers independently: materials transfer within the materials ledger, and finished goods transfer within the finished-goods ledger. The mechanics are identical.

The two-step flow

A transfer is a pair of ledger entries that share one auto-generated reference.

  1. Create. You pick a material or product, a source and destination location, and a quantity. Pharus writes one TRANSFER entry against the source — on-hand there drops immediately — and assigns a reference.
  2. In transit. Until it's completed, the stock belongs to neither location's on-hand: it has left the source but not yet arrived. A transfer is "in transit" whenever a TRANSFER entry exists with no matching RECEIVE.
  3. Complete. You complete the transfer by its reference. Pharus writes a RECEIVE entry at the destination — on-hand there rises — using the same reference so the two entries stay paired.

Transfer references

References are generated for you and make the pair easy to find:

  • MaterialsTFR-MI-001, TFR-MI-002, …
  • Finished goodsTFR-FG-001, TFR-FG-002, …

Both the TRANSFER and its completing RECEIVE carry this value as their ref.

See also

Create and complete transfers through the REST API or the MCP server.