Перейти к содержимому

Добавление товаров

PUT
/v2/supplier-order/add-item
curl --request PUT \
--url 'https://api-admin.billz.ai/v2/supplier-order/add-item?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 '{ "ordered_measurement_value": 1, "product_id": "aba9d9ad-5d37-4836-81a4-9a60648d087e", "retail_price": 110000, "supplier_order_id": "e8f19b80-6b2c-41ec-ad0f-0f4fe60aa191", "supply_price": 1 }'

Асинхронный метод. Чтобы получить результат синхронно по HTTP, передайте заголовок Billz-Response-Channel: HTTP — иначе ответ будет 200 {"message": "<correlation_id>"}. Максимальное ожидание — 600 секунд, далее 408 с error.code = TIMEOUT. > ⚠️ Синхронный успешный ответ недостижим. С заголовком Billz-Response-Channel: HTTP запрос завершится 408 TIMEOUT через 600 секунд, хотя операция будет выполнена. Результат нужно проверять отдельным запросом на чтение.

Коды ошибок: 400 — ошибка валидации входных данных; 404 — объект не найден; 408 — таймаут ожидания асинхронного ответа; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.

platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Идентификатор платформы. Для интеграций используется статичное значение.

Billz-Response-Channel
string
Allowed values: HTTP

HTTP — дождаться результата обработки события и вернуть его в HTTP-ответе. Без заголовка метод вернёт только correlation_id опубликованного события.

Billz-Response-Channel
string
Allowed values: HTTP

То же, что заголовок Billz-Response-Channel, — для клиентов, которые не могут передать свой заголовок. Если переданы оба, действует заголовок.

Media typeapplication/json
object
supplier_order_id
required
string
product_id
required
string
ordered_measurement_value
required

От 0 до 10^15, иначе 400

number format: double
retail_price
number format: double
supply_price
number format: double
wholesale_price

Оптовая цена

number format: double
company_id
string
Example
{
"ordered_measurement_value": 1,
"product_id": "aba9d9ad-5d37-4836-81a4-9a60648d087e",
"retail_price": 110000,
"supplier_order_id": "e8f19b80-6b2c-41ec-ad0f-0f4fe60aa191",
"supply_price": 1
}

Событие принято: {"message": "<correlation_id>"}. С заголовком Billz-Response-Channel: HTTP успешного ответа нет — запрос завершится 408, хотя операция будет выполнена; синхронно приходят только ошибки.

Media typeapplication/json

Ответ асинхронного метода без заголовка Billz-Response-Channel — событие опубликовано.

object
message

Correlation_id опубликованного события

string format: uuid
Examplegenerated
{
"message": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}