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.stage.ananastest.com/order/api/v1/supplier-integration/products/import

Production

https://api.ananas.rs/order/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
ean	String	EAN (European Article Number)
externalId	String	Unique ID in supplier's system
name	String	Product name
description	String	Product description
brand	String	Product brand
specifications	String	Product specifications
coverImage	String	URL to the image
gallery	String	List of URLs to the images
stockLevel	Integer	Stock level
purchasePrice	BigDecimal	Purchase price of product
sku	String	SKU

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://img.gigatron.rs/img/products/large/5a65fe2f19ae6db91133f3c143a15e24.png",
            "gallery": [
                "https://img.gigatron.rs/img/products/large/5a65fe2f19ae6db91133f3c143a15e24.png"
            ],
            "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."
        ]
    }
]