return_id	int	Order return identifier. Field required. Other fields are optional.
storage	varchar(9)	Type of product source storage (available values: "db" - BaseLinker internal catalog, "shop" - online shop storage, "warehouse" - the connected wholesaler)
storage_id	varchar(50)	The identifier of the storage (inventory/shop/warehouse) from which the product comes.
product_id	varchar(50)	Product identifier in BaseLinker or shop storage. Blank if the product number is not known
variant_id	varchar(30)	Product variant ID. Blank if the variant number is unknown
auction_id	varchar(20)	Listing ID number (if the order comes from ebay/allegro)
name	varchar(200)	Product name
sku	varchar(50)	Product SKU number
ean	varchar(32)	Product EAN number
location	varchar(50)	Product location
warehouse_id	int	Product source warehouse identifier. Only applies to products from BaseLinker inventory. By default warehouse_id is determined based on the warehouse identifiers in the existing products of the return. If no such product exist, it will be determined based on the source of the return
attributes	varchar(350)	The detailed product attributes, e.g. "Colour: blue" (Variant name)
price_brutto	float	Single item gross price
tax_rate	float	VAT tax rate e.g. "23", (value from range 0-100, EXCEPTION values: "-1" for "EXPT"/"ZW" exempt from VAT, "-0.02" for "NP" annotation, "-0.03" for "OO" VAT reverse charge)
quantity	int	Number of pieces
weight	float	Single piece weight
status_id	int	Identifier of return item status. The list can be retrieved with getOrderReturnReasons method.
return_reason_id	int	Identifier of return reason. The list can be retrieved with getOrderReturnProductStatuses method.

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_return_product_id	int	Identifier of the item added to the return.

Input data:
{ "return_id": 60, "storage": "db", "storage_id": 0, "product_id": "5434", "variant_id": 52124, "auction_id": "1234567890", "name": "Harry Potter and the Chamber of Secrets", "sku": "LU4235", "ean": "1597368451236", "location": "A1-13-7", "attributes": "colour red", "price_brutto": 20.00, "tax_rate": 23, "quantity": 2, "weight": 1, "status_id": 1003, "return_reason_id": 1006 } Output data:
{ "status": "SUCCESS", "order_return_product_id": "591571" } A sample request in PHP:
<?php $methodParams = '{ "return_id": 60, "storage": "db", "storage_id": 0, "product_id": "5434", "variant_id": 52124, "auction_id": "1234567890", "name": "Harry Potter and the Chamber of Secrets", "sku": "LU4235", "ean": "1597368451236", "location": "A1-13-7", "attributes": "colour red", "price_brutto": 20, "tax_rate": 23, "quantity": 2, "weight": 1, "status_id": 1003, "return_reason_id": 1006 }'; $apiParams = [ "method" => "addOrderReturnProduct", "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);