Skip to main content
Base path: /inventory-transaction (relative to your instance’s /api/v2). The standard list, single-record read, query, count, and group-and-count endpoints are available. A restricted single-object POST is also available; other generic writes are not registered. Search columns: reason

Fields

Quantities use the item’s base unit. adjust is a signed delta at the destination (or source when no destination is provided). transfer moves a nonnegative quantity between two locations in the same department. return removes a nonnegative quantity from fromLocationId. The posting location determines shopId; a supplied department cannot override it.

Post a transaction

POST /inventory-transaction accepts one object, with itemId, type, and quantity required. Only adjust, transfer, and return are accepted here. Supply the relevant source/destination location; the posting service resolves and validates the department and updates stock atomically. Transactions cannot be patched, upserted, or deleted through this API.
receipt goes through POST /delivery/{id}/receive; consume and produce go through the production actions; ship is posted by outbound delivery completion. Posting a ledger row directly would skip those workflows. Inventory posting requires item update permission.