Skip to main content

​
Overview

Catalog integration happens through the POST /ext/merchant/skus endpoint. This API receives one request per product, meaning all SKUs (variations) of the same product must be sent together in the same request.
SKUs previously integrated and not included in a subsequent request for a product will be considered deleted from the product and will be removed from the platform and from all connected sales channels.

​
Upsert Merchant SKUs

Creates or updates the SKUs of a product. All SKUs for a product must be sent together. 
curl -X POST 'https://product.api.e-cross.tech/ext/merchant/skus' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "skuId": "1234567890",
      "productId": "1234567",
      "main": true,
      "name": "USB charger type C",
      "description": "Beautiful and reliable super fast USB Type C charger.\nCharge your phone as never before!",
      "weight": 0.100,
      "height": 4,
      "width": 4,
      "length": 19,
      "ean": "0799439112766",
      "localizedListPriceWithTaxes": 9.99,
      "localizedSalePriceWithTaxes": 8.00,
      "globalSaleChannelData": {
        "active": true,
        "brand": "ChargerW",
        "size": "2 meters",
        "color": "silver",
        "category": "Telefones e Celulares/Acessórios/Carregadores",
        "attributes": [
          {
            "name": "Connection Type",
            "value": "USB-C"
          }
        ]
      },
      "images": [
        "https://image-host/1234567/1.jpeg",
        "https://image-host/1234567/2.jpeg"
      ]
    }
  ]'

[
  {
    "skuId": "1234567890",
    "productId": "1234567",
    "main": true,
    "name": "USB charger type C",
    "description": "Beautiful and reliable super fast USB Type C charger.\nCharge your phone as never before!",
    "weight": 0.1,
    "height": 4,
    "width": 4,
    "length": 19,
    "ean": "0799439112766",
    "localizedListPriceWithTaxes": 9.99,
    "localizedSalePriceWithTaxes": 8,
    "globalSaleChannelData": {
      "active": true,
      "brand": "ChargerW",
      "size": "2 meters",
      "color": "silver",
      "category": "Telefones e Celulares/Acessórios/Carregadores",
      "attributes": [
        {
          "name": "Connection Type",
          "value": "USB-C"
        }
      ]
    },
    "images": [
      "https://image-host/1234567/1.jpeg",
      "https://image-host/1234567/2.jpeg"
    ],
    "salesChannelStatus": {},
    "localizationStatus": "PENDING_LOCALIZATION"
  }
]

​
Request Body Parameters

​
skuId
string
required
The SKU identifier provided by the merchant. Must be unique within your catalog.
​
productId
string
required
The product identifier that groups all SKUs together. All SKUs with the same productId must be sent in the same request.
​
main
boolean
required
Indicates if this SKU is the main variation among all SKUs of the product. The main SKU is generally used by sales channels to display product information in product listing pages.
​
name
string
required
The title of the SKU in the original language.
​
description
string
required
The description of the SKU in the original language. It’s recommended to have the same description for all SKUs of the same product due to limitations on sales channels.
​
weight
number
required
The weight of the SKU in kilograms.
​
height
integer
required
The height of the SKU in centimeters.
​
width
integer
required
The width of the SKU in centimeters.
​
length
integer
required
The length of the SKU in centimeters.
​
ean
string
required
EAN-13 code of the SKU.
​
localizedListPriceWithTaxes
number
List price of the SKU in USD. This is the “origin list price” that will be used as the basis price for the localization process.
​
localizedSalePriceWithTaxes
number
Sale price of the SKU in USD. This is the “origin sale price” that will be used as the basis price for the localization process.
​
globalSaleChannelData
object
required
Sales channel data used to map SKU data to all connected sales channels.
​
images
array
required
Array containing URLs for the images of the SKU. Images should be publicly accessible.

​
Response Fields

​
id
string
The unique identifier of the SKU within e-CROSS.
​
merchantId
string
The unique identifier of the merchant in the e-CROSS platform.
​
productId
string
The product identifier that groups all the SKUs.
​
skuId
string
The SKU identifier provided by the merchant.
​
salesChannelStatus
object
A complex object (Record) where the key is the sales channel identifier within e-CROSS and the value contains the specific sales channel integration status.
​
localizationStatus
string
Status of the localization process. Returns PENDING_LOCALIZATION for newly created SKUs.
Use the GET /ext/merchant/products/:productId endpoint to retrieve the current state of a product within e-CROSS and identify its status in each connected sales channel.

List SKUs

Next: Learn how to list and retrieve your SKUs