Purchase Orders Built
A Purchase Order (PO) moves new stock from the Manufacturing Unit into one of AIR's warehouses. You build it as a Draft, Submit it for approval, an approver Approves it, then it is Sent (it goes In Transit) and the receiving warehouse counts each package as it arrives — good, damaged or missing. Updated 11 Nov 2026: the approval step and Cancel are back; receipts are counted good / damaged / missing, and head office resolves missing quantity; the separate Goods Receipt screen stays retired.
What a PO is
Every PO ships from the Manufacturing Unit — a built-in, virtual warehouse that stands for wherever new books come from. It has unlimited stock: nothing is checked or reduced there. The PO lists the products and quantities and the destination warehouse; stock only enters that warehouse when someone there receives it, line by line, into a shelf location of their choice. The Manufacturing Unit never appears as a choice anywhere a real warehouse is expected (sale orders, transfers, stock filters, the Warehouses screen).
Where to find it & who can see it
Open Purchasing › Purchase Orders. The list's Product filter keeps POs with a line for that product; a product's Inventory tab links here with it already set, and shows the quantity still incoming per warehouse (sent − received − missing on open POs).
Creating a PO
Select New purchase order. The form is the header only — lines are added from the PO's own page.
| Field | Type | Required | Notes |
|---|---|---|---|
vendor_id | Select | No | Optional — pick a Vendor if one supplies this order (needed later only for vendor billing). |
company | Select | Yes | AIR, AIS, Ainfo or ALA. Defaults to AIR. |
warehouse_id | Select | Yes | Destination warehouse — where the goods are going. |
carrier_id | Select | No | The carrier bringing the goods. Decides the box types the goods are packed into, and is recorded on every stock move of the PO. |
order_date | Date | Yes | Defaults to today. |
expected_date | Date | No | When the goods are expected to arrive. |
notes | Textarea | No | Free text. |
On save the PO gets a number PO-YYYY-##### and starts as a Draft.
Lines
On the PO's Lines tab add each product and quantity — one line per product (to order more, change that line's quantity) and only stockable products (a set is refused; order its parts). The rate is optional: leave it blank and the product's current cost price is used. Lines can be added, edited and removed only while the PO is a Draft. Each line shows Ordered, Shipped (what has shipped so far), its own State, Good, Damaged, Missing, Unresolved (missing not yet resolved), Reconciliation and Outstanding (shipped − good − damaged − missing).
Lifecycle
| State | Badge | Meaning |
|---|---|---|
| Draft | Gray | Being built — header and lines editable; the PO can be deleted or cancelled. |
| Pending Approval | Amber | Submitted. Lines are locked; waiting for someone with approval rights. Can still be cancelled. |
| Packaging | Primary | Approved. The order can no longer be changed or cancelled; packages are made now. Nothing has moved yet. |
| Partially In Transit | Blue | Some packages have shipped; others are still being packed. |
| In Transit | Blue | Every package has shipped and is waiting to be received. |
| Partially Received | Amber | Some packages have been received (or reported missing); others are still on their way or not yet shipped. |
| Received | Green | Every package has been received or reported missing. |
| Cancelled | Red | Cancelled before approval. Nothing was posted to stock. |
- Submit for approval (list row or PO page) — Draft only. The PO needs a vendor, a destination warehouse and at least one line, every line with a quantity above zero; otherwise the reason is shown. Moves it to Pending Approval.
- Approve — Pending Approval only. The same checks run again, your name and the time are recorded (Approved by / Approved at on the PO page), and the PO moves to Packaging. From here it can no longer be edited or cancelled.
- Generate packages — Packaging only. Packs every line into the carrier's boxes as Draft packages (Packages tab). Nothing is recorded as on its way yet. Run it again to start over, until the first package ships.
- Ship (on a package) — that whole package is recorded as on its way (Manufacturing Unit → In-Transit) and becomes Despatched. 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 PO's state follows its packages: it moves on by itself as packages ship, arrive or go missing.
- POs sent before packages existed keep Receive and Report missing on each line: a quantity and a location, or a quantity and a reason. A reported shortfall stays In Transit, Open, until head office resolves it (below).
- 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 order. The reason is kept in the PO's state log and the last one is shown on the PO page as Last rejection. Added 11 Nov 2026.
- Cancel order — Draft or Pending Approval only. The PO moves to Cancelled and stays on record.
- Edit / Delete — Draft only.
Separately from the state, every PO and line has a Reconciliation badge: Clean when nothing is wrong, Open as soon as any quantity is reported missing (a lost package counts as arrived for the state, with its contents missing) (the PO can be Received and still Open). Filter the list by it to find orders with unresolved shortfalls. Damaged books alone don't open anything — they are already in quarantine.
Resolving missing quantity. Head office (purchase_order.reconcile) uses Resolve missing on a line with unresolved missing books, choosing one outcome and a quantity (part now, the rest later is fine): Returned to sender — the vendor never sent them, so they go back from In-Transit to the Manufacturing Unit; Written off — lost on the way, In-Transit → Inventory Loss; Found at destination — they turned up, pick the location they go into. You can't resolve more than is unresolved. Each resolution is recorded against the package(s) the books went missing from, oldest first. When the last one is resolved the line becomes Reconciled, and the PO too once no line is still Open.
The Receipt history tab lists every receive and missing entry — when, product, quantity, location, reason, the stock move it created and who did it. State changes are also kept in the PO's state log. The Stock moves tab lists every stock move the PO has made (shipping into In-Transit, receiving, damaged, resolutions) with product, from → to, quantity, state and date. Added 11 Nov 2026.
Packages tab
Generate packages packs the lines into the carrier's box types, the same way as for stock transfers; a line too big for one package is split over several. The packages start as Draft.
- Ship (needs purchase_order.send) ships one Draft package, optionally with its tracking / LR number: its contents are recorded as on their way (Manufacturing Unit → In-Transit) and it becomes Despatched.
- Tracking adds or changes the tracking / LR number on a shipped package.
- Package missing (needs purchase_order.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 (for a courier loss: Written off) — 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. Good books go into your location, damaged ones into the warehouse's Quarantine (on hand, never sellable), and missing ones stay In Transit with the line Open.
- 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 vendor (or the Manufacturing Unit if the PO has no vendor) and show the PO number.
Each package is closed on its own (received or missing); the PO is Received once all of them are.
Rates and the PO total are pre-tax. If a vendor supplied the goods, a Vendor Bill (which may reference the PO) applies GST and a Vendor Payment settles it. Old Goods Receipts remain viewable as history only.
Related pages
Stock Transfers (the same flow between two real warehouses), Warehouses, Stock on Hand, Stock Moves (shipping a package is a Receipt move from the Manufacturing Unit into In-Transit; each receipt moves good stock from In-Transit to a location and damaged stock to the warehouse's Quarantine), Roles & Permissions.