Method list

Test your request

Changelog

The method allows you to add items to an existing stocktake in draft status. Entering a product with the same ID and matching parameters updates the previously saved position. If any parameter differs, a new item will be added.

stocktake_id	int	Stocktake identifier
items	array	List of items to add to the stocktake
| - product_id	int	Product identifier
| - quantity	int	Expected quantity. Must be a non-negative integer.
| - location_name	varchar(255)	(optional) Storage location name
| - expiry_date	varchar(10)	(optional) Expiry date in YYYY-MM-DD format (ISO 8601)
| - batch	varchar(128)	(optional) Batch number
| - serial_no	varchar(128)	(optional) Serial number

The method returns the data in JSON format.

status	varchar(30)	SUCCESS - request executed correctly ERROR - an error occurred during an API request. Error details will be described in 2 additional returned fields: error_message and error_code
items	array	List of created/updated stocktake items
| - item_id	int	Item identifier
| - position	int	Item position in stocktake

Input data:
{ "stocktake_id": 789, "items": [ { "product_id": 5432, "quantity": 10, "location_name": "A-1-2", "expiry_date": "2026-12-31", "batch": "LOT2026A", "serial_no": "" }, { "product_id": 5433, "quantity": 25, "location_name": "B-3-1" } ] } Output data:
{ "status": "SUCCESS", "items": [ { "item_id": 1001, "position": 1 }, { "item_id": 1002, "position": 2 } ] } A sample request in PHP:
<?php $methodParams = '{ "stocktake_id": 789, "items": [ { "product_id": 5432, "quantity": 10, "location_name": "A-1-2", "expiry_date": "2026-12-31", "batch": "LOT2026A", "serial_no": "" }, { "product_id": 5433, "quantity": 25, "location_name": "B-3-1" } ] }'; $apiParams = [ "method" => "addInventoryStocktakeItems", "parameters" => $methodParams ]; $curl = curl_init("https://api.baselinker.com/connector.php"); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-BLToken: xxx"]); curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($apiParams)); $response = curl_exec($curl);