Создать заказ покупателя

POST https://mrp.zolotenkov.ru/api/external/v1/sales-orders

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

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

Заголовки

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

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

Тело запроса

Формат — application/json.

created_date дата и время необязателен может быть пустым

Дата документа. Не прислали — «сейчас».
currency строка необязателен может быть пустым
customer_id целое число обязателен
delivery_date дата и время необязателен может быть пустым
items массив объектов обязателен

Хотя бы одна строка. Заказ без строк не документ, а заготовка: завести его извне и оставить пустым значит положить в учет бумагу без товара.
items.item_variant_id целое число обязателен
items.price десятичная дробь обязателен

Цена за единицу без НДС.
items.quantity десятичная дробь обязателен
items.storage_place_id целое число необязателен может быть пустым
items.tax_rate десятичная дробь необязателен может быть пустым

Ставка НДС в процентах; отсутствие поля и ноль означают «налога нет».
notes строка необязателен может быть пустым
number строка необязателен может быть пустым

Номер документа. Не прислали — система выдает следующий сама, тем же счетчиком, что и интерфейс.
priority целое число необязателен может быть пустым

Ответы

201 Заказ создан
400 Некорректное тело либо ссылка на строку другого клиента
401 Ключ не передан, недействителен или отозван
403 У ключа нет права write:sales.order.create
409 Номер заказа уже занят (document_number_taken) либо Idempotency-Key повторен с другим телом
422 Дата документа попадает в закрытый учетный период (inventory_period_closed)
429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений

curl --request POST \ --url 'https://mrp.zolotenkov.ru/api/external/v1/sales-orders' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{ "created_date": "2026-08-01T09:00:00Z", "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "number": "0001", "priority": 1 }'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/sales-orders", { method: "POST", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({ "created_date": "2026-08-01T09:00:00Z", "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "number": "0001", "priority": 1 }), }); const data = await response.json();

import requests response = requests.post( "https://mrp.zolotenkov.ru/api/external/v1/sales-orders", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={ "created_date": "2026-08-01T09:00:00Z", "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "number": "0001", "priority": 1 }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/sales-orders'); 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' { "created_date": "2026-08-01T09:00:00Z", "currency": "RUB", "customer_id": 42, "delivery_date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "price": 1200, "quantity": 10, "storage_place_id": 42, "tax_rate": 20 } ], "notes": "Комментарий", "number": "0001", "priority": 1 } JSON, ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "cancel_reason": "Покупатель отказался от остатка", "cancelled_at": "2026-08-01T09:00:00Z", "cancelled_by_user_id": "42", "cancelled_by_user_name": "Анна Петрова", "created_date": "2026-08-01T09:00:00Z", "currency": "RUB", "customer": { "country_code": "RU", "id": "42", "title": "Название" }, "delivery_date": "2026-08-01T09:00:00Z", "delivery_status": "NOT_SHIPPED", "id": "42", "notes": "Комментарий", "number": "0001", "priority": 1, "shipped_at": "2026-08-01T09:00:00Z", "status": "OPEN", "tax_amount": 2400, "total_amount": 12000, "total_amount_with_tax": 14400, "items": [ { "id": "42", "item_id": "42", "item_variant_id": "42", "line_amount": 12000, "line_amount_with_tax": 14400, "line_tax_amount": 2400, "price": 1200, "quantity": 10, "sku": "ART-001", "storage_place_id": "42", "tax_rate": 20, "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" }