Создать товар

POST https://mrp.zolotenkov.ru/api/external/v1/products

Требуемое право ключа: write:catalog.product.create

Заводит карточку товара вместе с вариантами. Обязателен Idempotency-Key: повтор с тем же ключом вернет прежний ответ и второй карточки не создаст.

Заголовки

Idempotency-Key строка обязателен

Обязателен, до 200 символов. Повтор с тем же ключом возвращает прежний ответ и второй карточки не создает. Ответ на повтор помечен заголовком Idempotency-Replayed: true — по коду ответа повтор от первичного вызова не отличается.

Тело запроса

Формат — application/json.

can_buy флаг необязателен
can_make флаг необязателен
can_sell флаг необязателен
category_id целое число необязателен может быть пустым
cost_price десятичная дробь необязателен может быть пустым

Явная плановая себестоимость. Для покупного товара обязательна: отсутствие значения не должно превращаться в неотличимый от настоящего ноль.
is_kit флаг необязателен

Пометить товар комплектом. Задается только при создании: у уже заведенной карточки признак этой ручкой не меняется.
sku строка необязателен может быть пустым
title строка обязателен
unit_id целое число необязателен может быть пустым

Ответы

201 Карточка товара создана
400 Некорректное тело запроса
401 Ключ не передан, недействителен или отозван
402 Исчерпан лимит артикулов тарифа Free (SUBSCRIPTION_LIMIT)
403 У ключа нет права write:catalog.product.create
409 Idempotency-Key повторен с другим телом запроса
429 Превышена частота обращений (rate_limited) либо исчерпан суточный предел документов ключа (document_quota_exceeded). Задержка до повтора — в заголовке Retry-After

curl --request POST \ --url 'https://mrp.zolotenkov.ru/api/external/v1/products' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{ "can_buy": true, "can_make": true, "can_sell": true, "category_id": 42, "cost_price": 850, "is_kit": false, "sku": "ART-001", "title": "Название", "unit_id": 42 }'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/products", { method: "POST", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({ "can_buy": true, "can_make": true, "can_sell": true, "category_id": 42, "cost_price": 850, "is_kit": false, "sku": "ART-001", "title": "Название", "unit_id": 42 }), }); const data = await response.json();

import requests response = requests.post( "https://mrp.zolotenkov.ru/api/external/v1/products", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={ "can_buy": True, "can_make": True, "can_sell": True, "category_id": 42, "cost_price": 850, "is_kit": False, "sku": "ART-001", "title": "Название", "unit_id": 42 }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/products'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", "Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type: application/json", ], CURLOPT_POSTFIELDS => <<<'JSON' { "can_buy": true, "can_make": true, "can_sell": true, "category_id": 42, "cost_price": 850, "is_kit": false, "sku": "ART-001", "title": "Название", "unit_id": 42 } JSON, ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "archived": false, "can_buy": true, "can_make": true, "can_sell": true, "category_id": "42", "created_at": "2026-08-01T09:00:00Z", "id": "42", "is_kit": false, "sku": "ART-001", "title": "Название", "unit_id": "42", "updated_at": "2026-08-01T09:00:00Z", "variants": [ { "cost_price": 850, "id": "42", "sku": "ART-001", "title": "Название" } ] }

{ "error": "document_quota_exceeded", "message": "Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.", "request_id": "req_cyX5W3UaT8KsYDN7GUEkdW" }