Sign in

v2

latestOpenAPI 3.0.32026-08-05174296703.4 KB
ops

importProducts catalog

Add a batch of products to the catalog

post/ops/sellers/{seller_id}/catalog/import

Path parameters

seller_idstring regexp required

Seller ID

Example:739b63c2-9e58-4964-b38d-4ebb424de242

Seller ID

Request body

Example request

{
  "products": [
    {
      "base_rental_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "description": "aaa",
      "extra_details": [
        {
          "property": "memory",
          "value": "16GB DDR5"
        }
      ],
      "image": {
        "url": "https://example.com/foo"
      },
      "is_active": false,
      "list_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "manufacturer": "abc123",
      "origin_seller": "abc123",
      "origin_seller_references": [
        {
          "reference": "123ab-5343",
          "source": "sap"
        }
      ],
      "pretty_id": "abc123",
      "pricing_category": "iphone_17_pro",
      "pricing_category_confidence": 1,
      "product_standard_identifiers": [
        {
          "id": "123ab-4567",
          "identifier_type": "EAN"
        }
      ],
      "publicized_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "seller_categories": [
        {
          "id": "abc123",
          "name": "abc123",
          "parent_category": "abc123"
        }
      ],
      "seller_product_references": [
        {
          "reference": "123ab-5343",
          "source": "sap"
        },
        {
          "reference": "123ab-5343",
          "source": "sap"
        }
      ],
      "seller_product_type": "software",
      "shop_product_description_url": "https://example.com/foo",
      "subtitle": "abc123",
      "title": "abc123"
    },
    {
      "base_rental_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "description": "aaa",
      "extra_details": [
        {
          "property": "memory",
          "value": "16GB DDR5"
        }
      ],
      "image": {
        "url": "https://example.com/foo"
      },
      "is_active": false,
      "list_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "manufacturer": "abc123",
      "origin_seller": "abc123",
      "origin_seller_references": [
        {
          "reference": "123ab-5343",
          "source": "sap"
        }
      ],
      "pretty_id": "abc123",
      "pricing_category": "iphone_17_pro",
      "pricing_category_confidence": 1,
      "product_standard_identifiers": [
        {
          "id": "123ab-4567",
          "identifier_type": "EAN"
        }
      ],
      "publicized_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "seller_categories": [
        {
          "id": "abc123",
          "name": "abc123",
          "parent_category": "abc123"
        }
      ],
      "seller_product_references": [
        {
          "reference": "123ab-5343",
          "source": "sap"
        },
        {
          "reference": "123ab-5343",
          "source": "sap"
        }
      ],
      "seller_product_type": "software",
      "shop_product_description_url": "https://example.com/foo",
      "subtitle": "abc123",
      "title": "abc123"
    }
  ]
}

Response

OK response.

idstring regexp required

The id of the import processing

status'created' | 'started' | 'completed' | 'failed' required

The current import status

Example response

{
  "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
  "status": "started",
  "summary": {
    "sample_products_rejected": [
      {
        "error_code": "abc123",
        "error_description": "abc123",
        "seller_product_reference": {
          "reference": "123ab-5343",
          "source": "sap"
        }
      }
    ],
    "total_products": 1,
    "total_products_imported": 1,
    "total_products_rejected": 1
  }
}