API documentation - baselinker.com

The method allows you to create a new purchase order in BaseLinker storage. Orders are created as drafts by default.

warehouse_id	int	Warehouse identifier
supplier_id	int	Supplier identifier
payer_id	int	Payer identifier
currency	varchar(3)	Order currency (e.g. EUR, USD)
name	varchar(80)	(optional) Order name
notes	text	(optional) Order description/notes
invoice_no	varchar(50)	(optional) Related invoice number
date_delivery_expected	int	(optional) Expected delivery date as unix timestamp
additional_costs	array	(optional) List of additional costs assigned to the purchase order. Each element should contain fields listed below
\| - name	varchar(30)	Additional cost name
\| - cost	decimal(10,2)	Additional cost value (must be >= 0.01)
packages	array	(optional) List of packages with tracking information assigned to the purchase order. Each element should contain fields listed below
\| - courier_code	varchar(20)	Courier code (e.g. "dpd", "dhl", "inpost", "other"). The list of available courier codes can be retrieved using the getCouriersList method.
\| - courier_other_name	varchar(20)	(optional) Custom courier name. Required when courier_code is "other".
\| - package_number	varchar(40)	Tracking number / shipment number for the package

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
order_id	int	Created purchase order identifier
document_number	varchar(50)	Generated document number

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

<?php
$methodParams = '{
    "warehouse_id": 1,
    "supplier_id": 5,
    "payer_id": 1,
    "currency": "EUR",
    "name": "Monthly stock delivery",
    "notes": "Monthly stock delivery",
    "invoice_no": "FV\/2021\/12\/123",
    "date_delivery_expected": 1640908800,
    "additional_costs": [
        {
            "name": "Transport",
            "cost": 120.5
        },
        {
            "name": "Insurance",
            "cost": 35
        }
    ],
    "packages": [
        {
            "courier_code": "dpd",
            "package_number": "1234567890"
        },
        {
            "courier_code": "other",
            "courier_other_name": "Local Courier",
            "package_number": "LC-9876543"
        }
    ]
}';
$apiParams = [
    "method" => "addInventoryPurchaseOrder",
    "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);