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).

Permissions

Viewing needs purchase_order.view. Creating a PO, and editing or deleting it (and its lines) while it is a Draft, needs purchase_order.create. Submitting for approval also needs purchase_order.create. Approving and rejecting need purchase_order.approve, cancelling purchase_order.cancel, and generating packages and shipping them purchase_order.send. A button you are not allowed to use is not shown. Receiving / reporting missing needs purchase_order.receive and that you are assigned to the destination warehouse — a stock location of that warehouse is assigned to you, or the warehouse is in your geography. Holders of warehouse.access_all and super administrators can receive at any warehouse. Resolving missing quantity needs purchase_order.reconcile (any warehouse).

Creating a PO

Select New purchase order. The form is the header only — lines are added from the PO's own page.

FieldTypeRequiredNotes
vendor_idSelectNoOptional — pick a Vendor if one supplies this order (needed later only for vendor billing).
companySelectYesAIR, AIS, Ainfo or ALA. Defaults to AIR.
warehouse_idSelectYesDestination warehouse — where the goods are going.
carrier_idSelectNoThe carrier bringing the goods. Decides the box types the goods are packed into, and is recorded on every stock move of the PO.
order_dateDateYesDefaults to today.
expected_dateDateNoWhen the goods are expected to arrive.
notesTextareaNoFree 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

StateBadgeMeaning
DraftGrayBeing built — header and lines editable; the PO can be deleted or cancelled.
Pending ApprovalAmberSubmitted. Lines are locked; waiting for someone with approval rights. Can still be cancelled.
PackagingPrimaryApproved. The order can no longer be changed or cancelled; packages are made now. Nothing has moved yet.
Partially In TransitBlueSome packages have shipped; others are still being packed.
In TransitBlueEvery package has shipped and is waiting to be received.
Partially ReceivedAmberSome packages have been received (or reported missing); others are still on their way or not yet shipped.
ReceivedGreenEvery package has been received or reported missing.
CancelledRedCancelled before approval. Nothing was posted to stock.

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.

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.

Screenshot placeholderA Purchase Order in Partially In Transit — header with state badge, From: Manufacturing Unit, destination warehouse; the Packages tab with a Despatched and a Draft package and the Ship action; the Lines tab with Ordered / Shipped / State / Received / Missing / Outstanding; the Receipt history tab.
Pre-tax; billing comes later

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.