Добавить продукт / Продажа по свободной цене
const url = 'https://api-admin.billz.ai/v2/order-product/example?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: '{"sold_measurement_value":1,"product_id":"2ce40c63-4527-4898-a975-7c30c255fd50","used_wholesale_price":false,"is_manual":false,"seller_ids":["90219ac7-88b7-43f6-bed9-5c6761aefa71"]}'};
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/order-product/example?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 '{ "sold_measurement_value": 1, "product_id": "2ce40c63-4527-4898-a975-7c30c255fd50", "used_wholesale_price": false, "is_manual": false, "seller_ids": [ "90219ac7-88b7-43f6-bed9-5c6761aefa71" ] }'Асинхронный метод. Чтобы получить результат синхронно по 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»Path Parameters
Заголовок раздела «Path Parameters»Берётся из пути; значение из тела игнорируется
Header Parameters
Заголовок раздела «Header Parameters»Идентификатор платформы. Для интеграций используется статичное значение.
HTTP — дождаться результата обработки события и вернуть его в HTTP-ответе. Без заголовка метод вернёт только correlation_id опубликованного события.
Query Parameters
Заголовок раздела «Query Parameters»То же, что заголовок Billz-Response-Channel, — для клиентов, которые не могут передать свой заголовок. Если переданы оба, действует заголовок.
Request Bodyrequired
Заголовок раздела «Request Bodyrequired»object
Товар
Продаваемое количество; не более 99 999 999
Возвращаемое количество; не более 99 999 999
Считать по оптовой цене
Продажа по свободной цене
Значение свободной цены
Штрихкод
Продавцы позиции
Ручное изменение позиции
Отсканированные коды маркировки
Снятые коды маркировки
То же, что заголовок Billz-Response-Channel: HTTP: дождаться результата и вернуть его в ответе
Examples
{ "sold_measurement_value": 1, "product_id": "2ce40c63-4527-4898-a975-7c30c255fd50", "used_wholesale_price": false, "is_manual": false, "seller_ids": [ "90219ac7-88b7-43f6-bed9-5c6761aefa71" ]}{ "sold_measurement_value": 1, "product_id": "1b5e3f0d-ad00-44e5-981a-2c88af848ba3", "used_wholesale_price": false, "use_free_price": true, "free_price": 35000, "is_manual": true, "seller_ids": [ "aade9196-0eb4-4511-80c1-085c746a30f3" ]}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
Внутренний id сессии подключения
Код результата обработки события (200 при успехе)
Id сообщения-ответа
Id компании
Внутренний код/сообщение ошибки
object
Полезная нагрузка ответа
object
object
object
object
object
object
object
object
object
object
object
object
Идентификатор запроса
Тип ответного события, например <event_type>.success
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": {}}