Method list

Test your request

Changelog

The method allows you to add planning items to an inventory transfer in draft status. 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 to the transfer
| - product_id	int	Product identifier
| - quantity	int	Quantity to transfer. Must be a positive integer.
| - 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 transfer items
| - item_id	int	Created item identifier
| - position	int	Line item number within the 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" } ] } 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" } ] }'; $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);