Skip to main content

Overview

Retrieve all SKUs of a single product. Use this endpoint to check the current state of a product within e-CROSS and identify its status in each connected sales channel.

Get SKU by Product ID

List all SKUs of a specific product identified by productId.
curl -X GET 'https://product.api.e-cross.tech/ext/merchant/products/1234567' \
  -H 'Authorization: Bearer YOUR_TOKEN'
[
  {
    "merchantProductId": "ACME-1234567",
    "localizedSalePriceWithTaxes": 9.99,
    "skuId": "1234567891",
    "name": "USB charger type C",
    "weight": 0.1,
    "ean": "0799439112767",
    "length": 19,
    "width": 4,
    "height": 4,
    "images": [
      "https://image-host/1234567/1.jpeg",
      "https://image-host/1234567/2.jpeg"
    ],
    "main": true,
    "globalSaleChannelData": {
      "size": "1 meter",
      "color": "silver",
      "active": true,
      "brand": "ChargerW",
      "category": "Telefones e Celulares/Acessórios/Carregadores",
      "attributes": [
        {
          "name": "Connection Type",
          "value": "USB-C"
        }
      ]
    },
    "description": "Beautiful and reliable super fast USB Type C charger.",
    "id": "ACME-1234567891",
    "productId": "1234567",
    "merchantId": "ACME",
    "salesChannelStatus": {
      "ECOM": {
        "statusDate": "2024-09-06T11:13:30.533Z",
        "statusMessage": "Integration successful",
        "status": "SALES_CHANNEL_APPROVED"
      }
    }
  }
]

Path Parameters

productId
string
required
The product identifier that groups all SKUs together.

Response Fields

The response is an array of SKU objects. Each SKU contains the same fields as described in the Catalog Integration endpoint, including:
id
string
required
The unique identifier of the SKU within e-CROSS.
merchantId
string
required
The unique identifier of the merchant in the e-CROSS platform.
productId
string
required
The product identifier that groups all the SKUs.
skuId
string
required
The SKU identifier provided by the merchant.
name
string
required
The title of the SKU in the original language.
description
string
required
The description of the SKU in the original language.
weight
number
required
The weight of the SKU in kilograms.
length
integer
required
The length of the SKU in centimeters.
width
integer
required
The width of the SKU in centimeters.
height
integer
required
The height of the SKU in centimeters.
images
array
required
Array containing URLs for the images of the SKU.
ean
string
required
EAN-13 code of the SKU.
main
boolean
required
Boolean indicating if this SKU is the main variation among all SKUs of the product.
localizedListPriceWithTaxes
number
List price of the SKU in USD. This is the “origin list price” used as the basis for localization.
localizedSalePriceWithTaxes
number
Sale price of the SKU in USD. This is the “origin sale price” used as the basis for localization.
globalSaleChannelData
object
required
Sales channel data used to map SKU data to all connected sales channels. See Catalog Integration endpoint for detailed structure.
salesChannelStatus
object
required
A complex object where the key is the sales channel identifier and the value contains the integration status.
This endpoint is useful for verifying the current state of your products and checking their integration status across different sales channels.

Price Update

Next: Learn how to update product prices