Skip to main content

Purchase Order Form (Purchase_Order_Form)

Field-by-field reference for the Purchase Order form in Zoho Creator, extracted from the Deluge form definition. This form is the system of record for parts purchasing — every parts order raised against a repair job is captured here, and it is the reference data the Invoice Extraction module matches supplier invoices against.

  • Display name: Purchase Order Form
  • Success message: "Data Added Successfully!"
  • Last documented: 12 June 2026

Form Layout

The form is organised into two sections plus two line-item grids:

  1. Main section (row 1) — vehicle, claim, supplier, and ordering details
  2. Line-item grids (rows 2–3) — the parts on the order
  3. System section (row 4) — status tracking, PO numbering, and links into the parts workflow

Main Section — Order Details

FieldTypeSource / ValuesNotes
File_NumberPicklist (lookup)Claim_Form.ID, displays [File_Number]Links the PO to the claim. Sorted ascending.
RegistrationTextFree textVehicle rego. Key matching field for invoice extraction (see below).
VIN_NoTextFree textVehicle identification number. APG invoices print VIN rather than rego.
MakeTextFree textVehicle make.
ModelTextFree textVehicle model.
Ordered_ByPicklist (lookup)User.ID, displays full name (prefix + first + last + suffix)Staff member who raised the order.
Date_OrderedDateAll days allowedMandatory (must have).
Supplier_NamePicklist (lookup)Suppliers.ID, displays [Supplier_Name]The canonical supplier list lives in the Suppliers form — this is the master data that invoice supplier-name matching resolves against.
Purchase_Order_No_I_BodyTextFree text"Purchase Order No. (I-Body)" — the iBody purchase number. This is the order reference suppliers print on their invoices, and the primary key for invoice-to-PO matching.

Line-Item Grids

The form carries two line-item grids, both bidirectional (child records link back to this PO):

FieldTypeChild FormNotes
Order_Line_Items_Parts_OrderGrid (subform)Parts_OrderDisplay name "Order Line Items".
Order_Line_ItemsGrid (subform)Order_Line_ItemsDisplay name "Order Line Items" — same label as the grid above.

:::caution Two grids, one label Both grids display as "Order Line Items" in the UI. Order_Line_Items is the current structure — it is the subform embedded in the Order Parts form, introduced when line items became separate records (previously part descriptions lived in a single free-text Description field). Order_Line_Items_Parts_Order (backed by Parts_Order) is the pre-existing structure. Code that reads PO line items — including the invoice extraction matching logic — should query Order_Line_Items. :::

System Section

FieldTypeSource / ValuesNotes
Total_ValueDecimalTotal value of the order. Comparison target for the extracted invoice total.
Auto_NumberAutonumberStarts at 1Internal sequence.
Order_StatusPicklistPendingOrderedArrivedInitial value Pending. Max 100 chars.
Parts_to_be_ordered_forPicklistClaim, Fleet Vehicle, Private JobJob type — not all POs belong to an insurance claim.
Date_ArrivedDateAll days allowedSet when parts are received.
PO_NumberTextFree textInternal PO number (distinct from the iBody number).
Rego_PO_NumberTextFree textCombined rego + PO reference.
Parts_Approved_to_OrderPicklist (lookup)Parts_Approved_to_Order.ID, displays [ID]Link into the parts approval workflow.
Order_PartsPicklist (lookup)Order_Parts.ID, displays [ID]Link into the parts ordering workflow.
Request_PartsPicklist (lookup)Request_Parts.ID, displays [ID]Link into the parts request workflow.

Actions

EventButtons
On addSubmit
On editUpdate, Cancel

Three PO-Number Fields — Which Is Which

The form has three distinct purchase-order references. Don't conflate them:

FieldMeaningPrinted on supplier invoices?
Purchase_Order_No_I_BodyThe iBody purchase number given to the supplier when orderingYes — this is the "Order No" / "P/O Number" / "Customer Po" that appears on invoices
PO_NumberInternal PO numberNo
Rego_PO_NumberCombined rego + PO reference for internal lookupNo

Relevance to Invoice Extraction

The invoice extraction module (Claude Vision) extracts fields from scanned supplier invoices and matches them against this form. The mapping:

Extracted invoice fieldPO form fieldMatch approach
po_number (e.g. APG "Order No")Purchase_Order_No_I_BodyExact / normalised string match — primary key
vehicle_id (Rego or VIN depending on supplier)Registration or VIN_NoExact match after normalisation (case, spaces). APG prints VIN; most others print rego.
supplier_nameSupplier_NameSuppliers formFuzzy / alias matching — invoice letterheads vary from the canonical name in Suppliers
invoice_total / sub_totalTotal_ValueTolerance comparison (GST handling: Total_Value vs invoice ex-GST subtotal needs confirming)
line_items[] (description, qty, cost)Order_Line_Items grid recordsCount, description similarity, and unit-cost comparison per line

Open questions

  • Which of the two line-item grids is authoritative for new POs (assumed: Order_Line_Items)?
  • Is Total_Value inclusive or exclusive of GST?
  • Is Purchase_Order_No_I_Body reliably populated on every PO, or only for iBody-sourced orders?