Method list

Test your request

Changelog

The method allows you to add planning items to an inventory transfer in draft status, or to update the quantity of an existing item by item_id. Entering the product with the ID updates the previously saved position only if all other parameters match. If any parameter differs (e.g. location), a new item will be added.

transfer_id	int	Transfer 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	Quantity to transfer. Must be a positive integer. Required when item_id is not provided.
| - location_name	varchar(20)	(optional) Source WMS stock unit location. Must match an existing stock unit.
| - target_location_name	varchar(20)	(optional) Target storage location name
| - expiry_date	varchar(10)	(optional) Expiry date in YYYY-MM-DD format (ISO 8601). Used for WMS unit matching.
| - batch	varchar(128)	(optional) Batch number. Used for WMS unit matching.
| - serial_no	varchar(128)	(optional) Serial number. Used for WMS unit matching.

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 or updated transfer items
| - item_id	int	Item identifier
| - position	int	Item position in transfer

Input data:
{ "transfer_id": 452, "items": [ { "product_id": 5432, "quantity": 10, "location_name": "A-1-2", "target_location_name": "B-3-1", "expiry_date": "2026-12-31", "batch": "LOT2026A", "serial_no": "" }, { "product_id": 5433, "quantity": 5, "location_name": "A-1-3", "target_location_name": "B-3-2" }, { "item_id": 1001, "quantity": 8 } ] } Output data:
{ "status": "SUCCESS", "items": [ { "item_id": 1001, "position": 1 }, { "item_id": 1002, "position": 2 } ] } A sample request in PHP:
<?php $methodParams = '{ "transfer_id": 452, "items": [ { "product_id": 5432, "quantity": 10, "location_name": "A-1-2", "target_location_name": "B-3-1", "expiry_date": "2026-12-31", "batch": "LOT2026A", "serial_no": "" }, { "product_id": 5433, "quantity": 5, "location_name": "A-1-3", "target_location_name": "B-3-2" }, { "item_id": 1001, "quantity": 8 } ] }'; $apiParams = [ "method" => "addInventoryTransferItems", "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);