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.
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
| State | Meaning |
|---|---|
| Draft | Editable, deletable and cancellable. No stock has moved. |
| Pending Approval | Submitted; lines locked; waiting for approval. Can still be cancelled, or rejected by an approver. |
| Packaging | Approved: can no longer be changed or cancelled. Packages are made now; no stock has moved yet. |
| Partially In Transit | Some packages have shipped; others are still being packed. |
| In Transit | Every package has shipped: their contents have left the source location and are in transit to the destination warehouse. |
| Partially Received | Some packages have been received (or reported missing); others are still on their way or not yet shipped. |
| Received | Every package has been received or reported missing. |
| Cancelled | Cancelled before approval. No stock moved. |
- Submit for approval (list row or transfer page) — Draft only. Needs at least one line, every quantity above zero, a sellable source, and — for a move within one warehouse — a destination location other than the source. Moves it to Pending Approval.
- Approve — Pending Approval only; the same checks run again and the approver and time are recorded. Moves it to Packaging.
- Reject — Pending Approval only, approvers only. Give a reason (required) and choose Back to Draft for rework (the lines can be edited again and it can be resubmitted) or Cancel the transfer. The last rejection's reason, who rejected it and when are shown on the transfer page. Added 11 Nov 2026.
- Cancel transfer — Draft or Pending Approval only. Moves it to Cancelled.
- Generate packages — Packaging only. Packs every line into the carrier's boxes as Draft packages (see the Packages tab). No stock moves. You can run it again to start over, until the first package ships.
- Ship (on a package, Packages tab) — the whole package ships: its contents leave the source location and it goes Despatched. A package is never shipped in part. If the source does not have enough free stock (on hand minus what is reserved for sale orders), nothing ships and the reason is shown.
- Ship all — ships every package not yet shipped, making the packages first if there are none.
- Receive package / Package missing (Packages tab) — see below. The transfer's state follows its packages: it moves on by itself as packages ship, arrive or go missing.
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).
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.
- Ship (needs stock_transfer.send) ships one Draft package, optionally with its tracking number. Its contents leave the source location and it becomes Despatched.
- Tracking adds or changes the carrier's tracking number on a shipped package.
- Package missing (needs stock_transfer.receive) marks a shipped package Lost, with a reason. Everything it carried is counted as missing and stays In Transit, Open, until head office resolves it — nothing is written off automatically.
- Receive package marks a shipped package Delivered. Pick the location for the good books, then count each item: Good starts at everything shipped, Damaged at 0, and Missing is worked out for you (shipped − good − damaged). Good books go into your location, damaged ones into the warehouse's Quarantine, and missing ones stay In Transit with the item Open. Good + damaged can't be more than was shipped. If everything arrived fine, just pick the location and confirm.
- In Package missing, turn on Raise a carrier complaint and enter a claim amount. This creates a Draft carrier complaint (type Lost in Transit) for the package, ready to review and submit. It needs the package to have a carrier.
- The Postage column shows the cost from the carrier's rate card, worked out when the package ships from its weight and the destination warehouse's PIN zone. It is a recorded cost only; no accounting entry is made.
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:
- Returned to sender — the books never left, or turned up at the source: they go back from In-Transit to the transfer's source location.
- Written off — lost in transit: they go from In-Transit to Inventory Loss.
- Found at destination — they turned up later at the receiving warehouse: pick the location and they go in there.
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.
- Add attachment (needs stock_transfer.create) uploads a file (up to 10 MB). Files are stored on the server's private disk — they are not publicly reachable by URL.
- Download (needs stock_transfer.view) streams the file back to you through the authenticated console.
- Delete (needs stock_transfer.create) removes the attachment and its file from disk.
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.