v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB

Products

Create a batch of products

Batch process helps to add multiple products in one request. ⚠️ If a product already exists, an update is applied. Missing parameters in update will be ignored and will not change. Erasing values is not possible. ⚠️ Adjust batch sizes based on processing times. We recommended use maximum amount of 1000 records and adjust the batch size based on processing time. ⚠️ Endpoint is available only in the Enterprise interface.

post/products/batch

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Request body

error_processing1 | 2

The parameter describes the batch method behavior in case of error occurs. Possible values are: 1 - It returns the first error found and rollback all previous changes (this is also the default behavior if the parameter is not set) / 2 - It creates all valid records and creates an error report from failed attempts.

Example request

{
  "products": [
    {
      "product_id": "81c14010c101966aefbb4738fc",
      "name": "Custom product N12",
      "code": "64912",
      "plu_ids": [
        {
          "list_code": "GLOBAL",
          "code": "abc"
        }
      ],
      "product_group_id": "83d1d11ea3884a5d33253fe214",
      "product_group_external_id": "23",
      "product_brand_id": "82db62087b0f79a6e14e5747e7",
      "product_brand_external_id": "71",
      "store_id": "83d1d11ea3884a5d33253fe214",
      "partner_id": "86e05affc7a7abefcd513ab400",
      "property_records": [
        {
          "property_record_id": "docasna_blokace_darce_do:8ea2591121e636086a4a9c0992",
          "property_id": "docasna_blokace_darce_do",
          "property_name": "Property #6",
          "last_change": "2023-02-02 00:00:00"
        }
      ],
      "prices": [
        {
          "currency_id": "86e05affc7a7abefcd513ab400",
          "value": 650
        }
      ],
      "tags": [
        {
          "tag_id": "838b73aacb5ac326cec4030c80",
          "name": "Recommended",
          "text_id": "recommended_tag",
          "state": 1,
          "last_change": "2019-01-04 10:31:56"
        }
      ]
    }
  ]
}

Response

No Content