Import Products

POST REST API request for suppliers, requiring a JSON body and an authorization token, in order to import products.

Request

HTTP Method

POST

URL

Stage

https://api.qa2.ananastest.com/ws-inventory/api/v1/supplier-integration/products/import

Production

https://api.ananas.rs/ws-inventory/api/v1/supplier-integration/products/import

HTTP Headers

Header name	Header value
Authorization	Bearer {access_token}

Request Body:

Fields name	Type	Description
productsForImport	List<ImportProductRequest>	List of products for import

ImportProductRequest

Fields name	Type	Description	Mandatory
ean	String	EAN (European Article Number)	Yes
externalId	String	Unique ID in supplier's system	Yes
name	String	Product name	Yes
description	String	Product description	Yes
brand	String	Product brand	Yes
specifications	String	Product specifications	No
coverImage	String	URL to the image	Yes
gallery	String	List of URLs to the images	Yes
stockLevel	Integer	Stock level	Yes
purchasePrice	BigDecimal	Purchase price of product	Yes
sku	String	SKU	No

Example of the request:

Click to copy

Success!

{
    "productsForImport":[
        {
            "ean": "700222111331",
            "externalId": "samsungevoakvafor1",
            "name": "Samsung EVO",
            "description": "SSD disk.",
            "brand": "Samsung",
            "specifications": "{\"color\": \"Red\", \"size\": \"M\"}",
            "coverImage": "https://ananas.rs/_next/image?url=https%3A%2F%2Fstatic.ananas.rs%2Fassets%2FProduct_Images%2F8718863041659_1.png&w=1648&q=75",
            "gallery": [
                "https://ananas.rs/_next/image?url=https%3A%2F%2Fstatic.ananas.rs%2Fassets%2FProduct_Images%2F8718863041659_1.png&w=1648&q=75"
            ],
            "stockLevel": 100,
            "purchasePrice": 6999,
            "sku": "sku1"
        }
    ]
}

Response

Response is a collection of responses for each product sent for import.

Field Name	Type	Description
ean	String	EAN (European Article Number)
externalId	String	Unique ID in supplier's system
sku	String	SKU
success	Boolean	Indicates if import is successful
errors	List<String>	List of error messages in case of failed product import

Example of response:

JSON:

Click to copy

Success!

[
    {
        "ean": "700222111331",
        "externalId": "externalId1",
        "sku": "sku1",
        "success": true,
        "errors": null
    },
    {
        "ean": "123123123123",
        "externalId": "externalId2",
        "sku": "sku2",
        "success": false,
        "errors": [
            "Product name is required."
        ]
    }
]