API documentation - baselinker.com

The method allows you to add items to an existing inventory document, or to update the quantity and price of an existing item by item_id. The document must be in draft status.

document_id	int	Document identifier
items	array	List of document 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 provided, only quantity and price can be updated, at least one of them is required
\| - product_id	int	The product ID, required when item_id is not provided
\| - quantity	int	The quantity of this line item in the document, required when item_id is not provided
\| - price	decimal(10,2)	(optional) Item unit price
\| - location_name	varchar(255)	(optional) Source storage location
\| - target_location_name	varchar(255)	(optional) Target storage location (only for Internal Transfer documents)
\| - expiry_date	varchar(10)	(optional) The expiry date. Date format YYYY-MM-DD (ISO 8601)
\| - batch	varchar(128)	(optional) Batch number
\| - serial_no	varchar(128)	(optional) The product serial number
\| - comments	varchar(255)	(optional) Item comments or notes

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 document items
\| - item_id	int	Item identifier
\| - position	int	Item position in document

Input data:
Output data:
A sample request in PHP:

<?php
$methodParams = '{
    "document_id": 101,
    "items": [
        {
            "product_id": 5432,
            "quantity": 5,
            "price": 10.99,
            "location_name": "A-1-2",
            "target_location_name": "B-1-2",
            "expiry_date": "2023-12-31",
            "batch": "LOT2021",
            "serial_no": "SN20211231001",
            "comments": "Important item"
        },
        {
            "product_id": 5433,
            "quantity": 3,
            "price": 24.5,
            "location_name": "A-2-1"
        },
        {
            "item_id": 1001,
            "quantity": 8,
            "price": 12.5
        }
    ]
}';
$apiParams = [
    "method" => "addInventoryDocumentItems",
    "parameters" => $methodParams
];

$curl = curl_init("https://api.base.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);