getProductsData
The method allows to download detailed data of selected products from the BaseLinker storage or a shop/wholesaler storage connected to BaseLinker.
Input parameters
Output data:
A sample request in PHP:
storage_id | varchar(30) | Storage ID in format "[type:bl|shop|warehouse]_[id:int]" (e.g. "shop_2445"). |
products | array | An array of product ID numbers to download |
Output data
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 |
storage_id | varchar(30) | Storage ID in format "[type:bl|shop|warehouse]_[id:int]" (e.g. "shop_2445"). |
products | array | An array of products containig the fields listed below |
| - product_id | varchar(30) | The main Product ID. |
| - ean | varchar(32) | Product EAN number. |
| - sku | varchar(32) | Product SKU number. It can be filled with e.g. an external system product number. This will later allow you to rebuild the list of product associations in case of loss. |
| - name | varchar(200) | Product name |
| - quantity | int | Stock quantity |
| - price_netto | float | Net price |
| - price_brutto | float | Price gross |
| - price_wholesale_netto | float | Net wholesale 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) |
| - weight | float | Weight in kilograms |
| - description | text | Product description |
| - description_extra1 | text | Additional product description |
| - description_extra2 | text | Additional product description |
| - description_extra3 | text | Additional product description |
| - description_extra4 | text | Additional product description |
| - man_name | varchar(50) | Manufacturer name |
| - man_image | varchar(100) | Full manufacturer logo address |
| - category_id | int | Product category ID (the category must be created earlier with the addCategories method) |
| - images | array | An array of product photos. Each element of the array is a separate photo. |
| - features | array | An array of product features in the form of a list. Each element of the array is also an array containing two elements: 0 (varchar) - parameter name e.g. "resolution" 1 (varchar) - parameter value, e.g. "Full HD" |
| - variants | array | An array of available product variants. Each element of the array is also an array containing elements: variant_id (int) - variant identifier name (varchar) - full variant name price (float) - variant price quantity (int) - variant stock quantity sku (varchar) - variant SKU storage number ean (varchar) - EAN number |
| - [inne] | ... | The function can return additional fields created individually for a given seller in the integration file of his online store |
Sample
Input data:Output data:
A sample request in PHP: