Stock Transfers Built

A stock transfer moves products from a location in one warehouse to another warehouse. It works exactly like a Purchase Order, except the goods leave a real warehouse instead of the Manufacturing Unit. Updated 11 Nov 2026: a transfer is now Submitted and Approved before it is Sent, and can be Cancelled until it is approved.

What a stock transfer is

The header names the source location (a physical shelf/location — its warehouse is the source warehouse) and the destination warehouse (a different warehouse), plus an optional carrier, scheduled date and notes. Each line is a product and a quantity. Stock leaves the source when the transfer is Sent; it enters the destination when the receiving warehouse receives each package, counting what is good (into a location of its choice), damaged (into the warehouse's Quarantine) and missing. Missing quantity stays In Transit until head office resolves it — sent back, written off, or found. Updated 11 Nov 2026: receipt counting, quarantine and Resolve missing.

Where to find it & who can see it

Open Inventory › Stock transfers.

Permissions

Viewing: stock_transfer.view. Creating, and editing or deleting a Draft: stock_transfer.create. Submitting for approval: also stock_transfer.create. Approving and rejecting: stock_transfer.approve. Cancelling: stock_transfer.cancel. Generating packages and shipping (one package or all), and Move stock on a same-warehouse transfer: stock_transfer.send. Receiving / reporting missing: stock_transfer.receive and being assigned to the destination warehouse (a stock location there is assigned to you, or the warehouse is in your geography); warehouse.access_all holders and super administrators can receive anywhere. Resolving missing quantity: stock_transfer.reconcile (any warehouse).

Creating a transfer

Select New stock transfer. Choose the source location (only in-use sellable locations are offered, labelled Warehouse / Location — a warehouse's Quarantine is never offered: damaged books stay there), the destination warehouse, and add one line per product with its quantity. To move books between two locations of the same warehouse, pick that same warehouse as the destination: a To (destination location) field appears — choose another location of the warehouse, or its Quarantine to put shelf-damaged books aside (see Moving stock within a warehouse). Updated 11 Nov 2026. Only stockable products can be transferred — a set is refused; transfer its parts. Updated 11 Nov 2026. The transfer gets a number TRF-YYYY-##### and starts as a Draft. While it is a Draft you can change the header (Edit), add/edit/remove lines on the Items tab, or Delete it.

Lifecycle

StateMeaning
DraftEditable, deletable and cancellable. No stock has moved.
Pending ApprovalSubmitted; lines locked; waiting for approval. Can still be cancelled, or rejected by an approver.
PackagingApproved: can no longer be changed or cancelled. Packages are made now; no stock has moved yet.
Partially In TransitSome packages have shipped; others are still being packed.
In TransitEvery package has shipped: their contents have left the source location and are in transit to the destination warehouse.
Partially ReceivedSome packages have been received (or reported missing); others are still on their way or not yet shipped.
ReceivedEvery package has been received or reported missing.
CancelledCancelled before approval. No stock moved.

The state is worked out from the packages, first match wins: all received or missing → Received; any received or missing → Partially Received; all shipped → In Transit; any shipped → Partially In Transit; otherwise Packaging. Missing goods give the item and the transfer a Reconciliation: Open badge (a transfer can be Received and still Open); filter the list by Reconciliation to find them. Once every missing unit has been resolved (see Resolving missing quantity below) the item becomes Reconciled, and the transfer too when none of its items is still open. Damaged books alone do not open anything: they are already accounted for in quarantine.

Each item shows Quantity, Sent (what has shipped so far), its own State, Good, Damaged, Missing, Unresolved (missing not yet resolved), Reconciliation and Outstanding (sent − good − damaged − missing; Received = good + damaged can be shown from the column toggle). Transfers sent before packages existed still have Receive and Report missing on each item; a transfer with packages is received package by package. The Stock moves tab lists every stock move the transfer has made — shipping, receiving, damaged, resolutions and same-warehouse moves — with product, from → to, quantity, state and date. The Receipt history tab lists every receive / missing entry with location, reason, the stock move it created and who recorded it. Every stock effect is a normal stock move (source → In-Transit when a package ships; In-Transit → your location for good books and → Quarantine for damaged ones on receipt; missing books stay in In-Transit until resolved).

Screenshot placeholderA Partially In Transit transfer: the Packages tab with one Despatched and one Draft package and the Ship action; the Items tab with Sent / State / Received / Missing / Outstanding; the Receipt history tab.

Packages tab

Generate packages packs the transfer's lines into the carrier's box types, using the same box fitting and books-per-package limit as sale-order waves; a line too big for one package is split over several. With no carrier on the transfer, everything goes into one package with no box. The packages start as Draft and are numbered PKG-YYYY-#####. Every line is packed in full.

Print labels (top of the Packages tab) prints a barcode label for every package, in the carrier's default layout or one you pick. Each package also has its own print button. Labels are addressed to the destination warehouse. They are from the source warehouse and show the transfer number.

Each package is closed on its own (received or missing); the transfer is Received once all of them are. These packages do not appear in waves. They can't be updated from the package delivery screen or the delivery CSV; use the transfer's own actions.

Resolving missing quantity

When an item shows Unresolved missing books, head office (stock_transfer.reconcile) uses Resolve missing on the item, once the investigation says what happened. Pick one of three outcomes and a quantity — you can resolve part now and the rest later:

You can't resolve more than is still unresolved. When the last missing book of an item is resolved the item becomes Reconciled. Every resolution is listed on the Receipt history tab — one row per package the books went missing from (oldest package first), so each posting names its package.

Moving stock within a warehouse Built

A transfer whose destination warehouse is the source's own warehouse moves books between two of its locations. It is approved exactly like any other transfer (Draft → Submit for approval → Approve). Once it is in Packaging, Move stock (needs stock_transfer.send) takes the place of Generate packages / Ship all: every line moves from the source location to the destination location at once, the transfer goes straight to Received, and there are no packages, no In-Transit stage and nothing to receive. Each line gets one stock move (shown on the Stock moves tab). If the source does not have enough free stock, nothing moves and the reason is shown. Moving into the warehouse's Quarantine counts the books as Damaged. Added 11 Nov 2026.

Damaged books

Damaged books stay in the warehouse's Quarantine. They are never sent anywhere: Quarantine can never be the source of a transfer, of any type. (The repair-warehouse flow briefly built on 11 Nov 2026 was withdrawn the same day.)

Attachments tab Built

The view page also has an Attachments tab where you can attach supporting documents — a challan, a photo, a signed receipt — to the transfer. Unlike the lifecycle actions, this is available at every stage: from Draft through In Transit to Received or Cancelled. Each attachment records which stage the transfer was at when the file was added, who uploaded it, and its size.

This is where the Requires attachment flag set at creation is satisfied — the flag marks that a transfer should carry a document, and this tab is where you provide it.

Related pages

Purchase Orders (same flow, from the Manufacturing Unit), Stock on hand, Stock Moves, Warehouses, Roles & Permissions.