TOtopi
ops
ops-sellers

Import products

Changed on

Add a batch of products to the catalog

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

Request

  • Base URL
    https://api.topi-staging.eu
  • URL
    https://api.topi-staging.eu/ops/sellers/{seller_id}/catalog/import
  • Auth
    OAuth 2
    Authorization code: /oauth2/authorize
    Token URL: /oauth2/token scopes: catalog:edit

Path parameters

seller_idstring regexp required

Seller ID

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

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
  }
}

Changes

  • 0802da91479fRevision changes
    • warning

      the //// request property's maxLength was set to 255

    • warning

      the //// request property's maxLength was set to 255

    • warning

      the //// request property's maxLength was set to 255

    • warning

      the //// request property's maxLength was set to 255

  • ac6979514123Revision changes
    • info

      api operation id catalog.importProducts removed and replaced with catalog#importProducts