Warehouse & Inventory

This domain tracks every physical unit from the moment it enters the building to the moment it ships. Logistics handles inbound receipts and shipments; Stock holds the truth — lots at locations with a full ledger; Warehouse Outbound allocates and dispatches finished goods; and Delivery Notes document what left the dock. Every posting reflects into the Finindex GL.

Flow

Inbound to outbound

Logistics

Inbound receipts bring goods in; shipments and deliveries move them out. Locations are the warehouse map.

GET  /api/v1/logistics/locations
POST /api/v1/logistics/inbound-receipts
POST /api/v1/logistics/inbound-receipts/{receipt_id}/post
GET  /api/v1/logistics/shipments
POST /api/v1/logistics/shipments/{shipment_id}/packing-lists

Post an inbound receipt

Posting is what turns a draft receipt into real stock — it creates lots and writes the inventory GL entry.

POST /api/v1/logistics/inbound-receipts/{receipt_id}/post
Authorization: Bearer <access_token>

Response (200):

{
  "receipt_id": "uuid",
  "status": "posted",
  "lots_created": [
    { "lot_id": "uuid", "material_id": "uuid", "quantity": 500, "location_id": "uuid" }
  ]
}

A receipt is editable only while in draft. Once posted it is immutable — correct mistakes with a stock movement or stock-take adjustment, not by editing the receipt.

Stock

Stock is the inventory system of record: lots (a quantity of a material/SKU with provenance) live at locations, and every change appends to the ledger.

GET  /api/v1/stock/balances
GET  /api/v1/stock/lots
POST /api/v1/stock/movements
GET  /api/v1/stock/ledger
POST /api/v1/stock/stock-take

lot_id

string

required

The source lot for a movement.

to_location_id

string

required

Destination location (omit for an issue/consumption).

quantity

number

required

Quantity to move; must not exceed the lot’s available balance.

POST /api/v1/stock/movements
Authorization: Bearer <access_token>

{
  "lot_id": "uuid",
  "to_location_id": "uuid",
  "quantity": 120,
  "reason": "transfer_to_cutting"
}

Response (201):

{
  "movement_id": "uuid",
  "lot_id": "uuid",
  "quantity": 120,
  "ledger_entry_id": "uuid"
}

Use POST /api/v1/stock/issue-suggestions to let the system pick which lots to consume (FIFO / by expiry) before issuing fabric to a cut job. Reservations (/stock/reservations) hold stock for a planned outbound so it cannot be double-allocated.

Warehouse Outbound

Outbound orders pull finished goods, allocate them against available lots, then dispatch.

GET  /api/v1/warehouse-outbound/orders
POST /api/v1/warehouse-outbound/orders
POST /api/v1/warehouse-outbound/orders/{order_id}/allocate
POST /api/v1/warehouse-outbound/orders/{order_id}/dispatch

Allocate an outbound order

POST /api/v1/warehouse-outbound/orders/{order_id}/allocate
Authorization: Bearer <access_token>

Response (200):

{
  "order_id": "uuid",
  "status": "allocated",
  "allocations": [
    { "lot_id": "uuid", "quantity": 600, "location_id": "uuid" }
  ]
}

Allocate reserves specific lots; dispatch commits the movement, decrements stock, and triggers the COGS / accounts-receivable posting in Finindex.

Delivery Notes

A delivery note is the document of record for goods leaving the dock, usually generated from a dispatched outbound order.

GET  /api/v1/delivery-notes
POST /api/v1/delivery-notes
GET  /api/v1/delivery-notes/{note_id}

Inventory Reconciliation

A read-only report comparing on-hand stock against the ledger to surface drift before a stock-take.

GET /api/v1/inventory/reconciliation
Authorization: Bearer <access_token>

Discrepancies flagged here are corrected with POST /api/v1/stock/stock-take, which posts the adjusting movement and its gain/loss entry to the GL.

See the API Reference tab for the full endpoint list across the Logistics, Stock, Warehouse Outbound, Delivery Notes, and Inventory Reconciliation tags.

​Warehouse & Inventory

​Flow

​Inbound to outbound

​Logistics

​Post an inbound receipt

​Stock

​Warehouse Outbound

​Allocate an outbound order

​Delivery Notes

​Inventory Reconciliation

Warehouse & Inventory

Flow

Inbound to outbound

Logistics

Post an inbound receipt

Stock

Warehouse Outbound

Allocate an outbound order

Delivery Notes

Inventory Reconciliation