Upload a full catalog

Uploading a full catalog

Upload a full catalog

Uploading a full catalog is recommended only if you are syncing your product catalog for the first time during your onboarding with ESW.

For full catalog uploads, in addition to the parameters listed above, the parameters listed in the following table are also needed. If any of these parameters are not sent in the API request, failure event notifications are sent to ESW Trade Compliance and you might be required to resubmit the product data.


Parameter Type Description
category String The ESW category ID to which the product should be mapped.
Example: ApparelClothingNotKnitted
gender String The gender for which the product is intended.
Example: Female
ageGroup String The age group for which the product is intended.
Example: Female
size String The size of the product.
Example: 12
weight Number The weight of the product in the associated weightUnit.
Example: 5
weightUnit String The unit in which the weight of the product is calculated.
Example: Lb
unitPrice Object An object containing the amount and currency parameters.
amount (Number): The amount of the product.
Example: 89.99
currency (String): The currency in which the amount is set.
Example: USD
dangerousGoods Boolean Indicates if the product is classified as a dangerous good or HazMat.
Accepted values: true, false
additionalProductCode String Additional product code or unique identifier such as manufacturer’s SKU.
Example: 11160296020015
variantProductCode String Another version of the brand's unique master identifier or SKU.
Example: 516165167

Request Example

The following payload shows parameters that must be sent for all full catalog upload requests.

Required Example
[
     {
       "productCode": "11160296020014",
       "name": "JACKET",
       "description": "JACKET",
       "material": "FABRIC 53% cotton, 21% polyester, 21% acrylic, 4% viscose, 1% polyester, lining 100% polyester",
       "countryOfOrigin": "IT",
       "hsCode": "62043290",
       "hsCodeRegion": "EU",
       "category": "ApparelClothingNotKnitted",
       "gender": "Female",
       "ageGroup": null,
       "size": "12",
       "weight": "5",
       "weightUnit": "Lb",
       "unitPrice": {
            "amount": "89.99",
            "currency": "USD"
        },
       "dangerousGoods": "false",
       "additionalProductCode": null,
       "variantProductCode": null
     },
 ]
Checkout API Features
The Checkout API offers additional features.
Add New Products to Existing Catalog
Adding new product types to your catalog