Skip to main content

​
Procurement

Procurement turns BOM-driven demand into purchased and received stock. A material request captures what an order needs, those requests are batched into purchase orders sent to suppliers, deliveries are booked with goods receipt notes (GRN), and landed costs allocate freight and duty onto received stock. Receipts feed MES stock and the matching bills post to Finindex AP.

​
The flow

​
Material Requests

A material request (MR) lists the materials and quantities an order needs, netting demand against available stock. MRs run through a submit → approve workflow, then convert into purchase orders.

​
Create a material request

​
order_id
string
required
The sales order driving this demand.
​
lines
array
required
Materials and required quantities.
Response (201):

​
Approval workflow

Check stock before requesting with GET /api/v1/material-requests/stock/{material_id}.

​
Create purchase orders from requests

The key handoff: batch one or more approved material requests into purchase orders, grouped by supplier.
​
material_request_ids
array
required
The approved material requests to convert.
Response (201):
Trace the resulting POs with GET /api/v1/material-requests/{mr_id}/linked-purchase-orders.

​
Purchase Orders

A purchase order is the committed order to a supplier. POs can also originate the other direction — generating a material request from an existing PO.

​
Create a material request from a PO

​
Create a bill (Finindex AP)

Posts an accounts-payable bill against the PO into Finindex.
Inspect the full document chain with GET /api/v1/purchase-orders/{po_id}/flow.
The PO flow endpoint stitches together the linked material request, GRNs, and bill so you can audit a single PO end to end.

​
Subcontract

Subcontract orders send materials out to an external maker and receive finished goods back. Subcontract invoices post to Finindex.

​
Goods Receipt Notes (GRN)

A GRN books a supplier delivery against its PO and increments stock. Received quantities feed MES inventory.
​
purchase_order_id
string
required
The PO being received against.
​
lines
array
required
Received materials with quantities.

​
Landed Costs

Landed costs allocate freight, duty, and handling onto received stock so material valuation reflects true delivered cost.
Apply landed costs after the GRN is booked — the allocation distributes additional cost across already-received quantities. Applying before receipt has nothing to allocate against.
See the API Reference tab for the full endpoint list.

​
Connects to

MES Production

Received stock is consumed by production.

Finindex AP

Bills and subcontract invoices post here.