Skip to main content

Bulk Insert (Create from Products)

POST 

/api/stock-takes/bulk-insert

Create a new stock take and bulk-insert product IDs as line items in one operation.

Authentication: Requires Bearer token.

ids: array of product IDs to add. Required unless filters is provided.

filters: alternatively provide DataTable filters to select products dynamically.

mode: full_count (default) or adjustment.

is_initial_count: optional boolean; forces full_count and flags the take as the warehouse's initial count.

Unit cost: for adjustment mode, each item's unit_cost is pre-seeded from the product's best-available cost at the warehouse (FIFO / weighted-average / catalog unit cost, via GetBestAvailableCogs) so the Unit Cost column opens with a basis rather than blank; null when no cost exists. Overridable per row, and negative adjustments ignore it (cost is taken from consumed FIFO layers at finalization). Full counts are not seeded here — they capture cost at count initiation.

Returns the new stock_take_id.

Request

Responses

Successful response