Создание одного товара
const url = 'https://api-admin.billz.ai/v2/product?Billz-Response-Channel=HTTP';const options = { method: 'POST', headers: { 'platform-id': '7d4a4c38-dd84-4902-b744-0488b80a4c01', 'Billz-Response-Channel': 'HTTP', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"barcode":"24409390003634","category_ids":[],"company_id":"17a36439-d140-454d-aedb-ae1585681db1","has_expiration_date":false,"images":[],"free_price":false,"is_auto_delivery":true,"is_auto_tax":true,"is_divisible":false,"is_variative":false,"measurement_unit_id":"c5336f71-d684-4e2e-b5bc-307138593543","name":"from api, shorten 3","product_type_id":"69e939aa-9b8f-46a9-b605-8b2675475b7b","retail_price":11000,"shipments":[{"has_trigger":false,"measurement_value":1,"shop_id":"6f244db4-75d6-4fac-9841-14867d45e36a","small_left_measurement_value":0}],"shop_prices":[{"shop_id":"6f244db4-75d6-4fac-9841-14867d45e36a","retail_price":11000,"supply_price":1,"wholesale_price":0,"min_price":0,"max_price":0},{"shop_id":"70919136-9481-4c7e-8581-685d750d67a9","retail_price":11000,"supply_price":1,"wholesale_price":0,"min_price":0,"max_price":0},{"shop_id":"803b542d-51e5-41ea-9124-51f248536286","retail_price":11000,"supply_price":1,"wholesale_price":0,"min_price":0,"max_price":0}],"sku":"JSI-62299","supplier_ids":[],"supply_price":1,"variants":[],"is_marked":false}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://api-admin.billz.ai/v2/product?Billz-Response-Channel=HTTP' \ --header 'Authorization: Bearer <token>' \ --header 'Billz-Response-Channel: HTTP' \ --header 'Content-Type: application/json' \ --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01' \ --data '{ "barcode": "24409390003634", "category_ids": [], "company_id": "17a36439-d140-454d-aedb-ae1585681db1", "has_expiration_date": false, "images": [], "free_price": false, "is_auto_delivery": true, "is_auto_tax": true, "is_divisible": false, "is_variative": false, "measurement_unit_id": "c5336f71-d684-4e2e-b5bc-307138593543", "name": "from api, shorten 3", "product_type_id": "69e939aa-9b8f-46a9-b605-8b2675475b7b", "retail_price": 11000, "shipments": [ { "has_trigger": false, "measurement_value": 1, "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a", "small_left_measurement_value": 0 } ], "shop_prices": [ { "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 }, { "shop_id": "70919136-9481-4c7e-8581-685d750d67a9", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 }, { "shop_id": "803b542d-51e5-41ea-9124-51f248536286", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 } ], "sku": "JSI-62299", "supplier_ids": [], "supply_price": 1, "variants": [], "is_marked": false }'Асинхронный метод. Чтобы получить результат синхронно по HTTP, передайте заголовок Billz-Response-Channel: HTTP — иначе ответ будет 200 {"message": "<correlation_id>"}. Максимальное ожидание — 600 секунд, далее 408 с error.code = TIMEOUT.
Коды ошибок: 400 — ошибка валидации входных данных; 404 — объект не найден; 408 — таймаут ожидания асинхронного ответа; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.
Authorizations
Заголовок раздела «Authorizations»Parameters
Заголовок раздела «Parameters»Header Parameters
Заголовок раздела «Header Parameters»Идентификатор платформы. Для интеграций используется статичное значение.
HTTP — дождаться результата обработки события и вернуть его в HTTP-ответе. Без заголовка метод вернёт только correlation_id опубликованного события.
Query Parameters
Заголовок раздела «Query Parameters»То же, что заголовок Billz-Response-Channel, — для клиентов, которые не могут передать свой заголовок. Если переданы оба, действует заголовок.
Request Bodyrequired
Заголовок раздела «Request Bodyrequired»object
Тип товара
Название; не более 1000 символов
Артикул; не более 1000 символов
Штрихкод; не более 1000 символов
Начальный приход по магазинам
object
Цены по магазинам
object
Генерируется сервером
Дополнительные штрихкоды
object
Описание; не более 10 000 символов
Поставщик
COUNTABLE|UNCOUNTABLE
Вариации; при превышении лимита — 400
object
object
object
Состав набора; при превышении лимита — 400
object
Весовой товар
object
Значение HTTP — синхронный ответ. Работает и как заголовок, и как query-параметр ?Billz-Response-Channel=HTTP
Example
{ "barcode": "24409390003634", "category_ids": [], "company_id": "17a36439-d140-454d-aedb-ae1585681db1", "has_expiration_date": false, "images": [], "free_price": false, "is_auto_delivery": true, "is_auto_tax": true, "is_divisible": false, "is_variative": false, "measurement_unit_id": "c5336f71-d684-4e2e-b5bc-307138593543", "name": "from api, shorten 3", "product_type_id": "69e939aa-9b8f-46a9-b605-8b2675475b7b", "retail_price": 11000, "shipments": [ { "has_trigger": false, "measurement_value": 1, "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a", "small_left_measurement_value": 0 } ], "shop_prices": [ { "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 }, { "shop_id": "70919136-9481-4c7e-8581-685d750d67a9", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 }, { "shop_id": "803b542d-51e5-41ea-9124-51f248536286", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 } ], "sku": "JSI-62299", "supplier_ids": [], "supply_price": 1, "variants": [], "is_marked": false}Responses
Заголовок раздела «Responses»Успех. С заголовком Billz-Response-Channel: HTTP — конверт асинхронного ответа, без него — {"message": "<correlation_id>"}.
Конверт асинхронного ответа. Возвращается, когда передан заголовок Billz-Response-Channel: HTTP. Итоговый HTTP-код запроса берётся из поля status_code.
object
Идентификатор сессии клиента
Статус обработки события (он же итоговый HTTP-код ответа)
object
Код ошибки, пустая строка если ошибки нет
Текст ошибки, пустая строка если ошибки нет
Идентификатор запроса, совпадает с ID опубликованного события
Тип ответного события, например <event_type>.success
Результат операции, если метод его возвращает
object
Ответ асинхронного метода без заголовка Billz-Response-Channel — событие опубликовано.
object
Correlation_id опубликованного события
object
Без Billz-Response-Channel: HTTP — correlation_id
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
Examplegenerated
{ "session_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "status_code": 1, "error": { "code": "example", "message": "example" }, "correlation_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "topic": "example", "data": {}}