Method list

Test your request

Changelog

The method allows you to add items to an existing stocktake in draft status, or to update the quantity of an existing item by item_id. 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 or update. At most 1000 items with item_id can be updated at a time
| - item_id	int	(optional) Existing item identifier. When set, quantity is required and is the only field that can be updated
| - product_id	int	Product identifier, required when item_id is not provided
| - quantity	int	Expected quantity. Must be a non-negative integer. Required when item_id is not provided.
| - 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" }, { "item_id": 1001, "quantity": 12 } ] } 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" }, { "item_id": 1001, "quantity": 12 } ] }'; $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);