Создать заказ поставщику

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

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

Заводит заказ поставщику вместе со строками. Остаток при этом не двигается — его меняет оформление прихода.

Заголовки

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

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

Тело запроса

Формат — application/json.

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

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

Ожидаемая дата поставки.
items массив объектов обязателен

Хотя бы одна строка. Заказ без строк не документ, а заготовка.
items.batch_number строка необязателен может быть пустым

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

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

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

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

Поставщик обязателен: заказ без поставщика — не заказ, а напоминание. В базе колонка необязательная ради старых строк, но заводить такие документы извне незачем.

Ответы

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

curl --request POST \ --url 'https://mrp.zolotenkov.ru/api/external/v1/purchase-orders' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{ "currency": "RUB", "date": "2026-08-01T09:00:00Z", "expected_date": "2026-08-01T09:00:00Z", "items": [ { "batch_number": "0001", "expiry_date": "2026-08-01", "item_variant_id": 42, "price": 1200, "quantity": 10, "tax_rate": 20 } ], "number": "0001", "supplier_id": 42 }'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/purchase-orders", { method: "POST", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({ "currency": "RUB", "date": "2026-08-01T09:00:00Z", "expected_date": "2026-08-01T09:00:00Z", "items": [ { "batch_number": "0001", "expiry_date": "2026-08-01", "item_variant_id": 42, "price": 1200, "quantity": 10, "tax_rate": 20 } ], "number": "0001", "supplier_id": 42 }), }); const data = await response.json();

import requests response = requests.post( "https://mrp.zolotenkov.ru/api/external/v1/purchase-orders", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={ "currency": "RUB", "date": "2026-08-01T09:00:00Z", "expected_date": "2026-08-01T09:00:00Z", "items": [ { "batch_number": "0001", "expiry_date": "2026-08-01", "item_variant_id": 42, "price": 1200, "quantity": 10, "tax_rate": 20 } ], "number": "0001", "supplier_id": 42 }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/purchase-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' { "currency": "RUB", "date": "2026-08-01T09:00:00Z", "expected_date": "2026-08-01T09:00:00Z", "items": [ { "batch_number": "0001", "expiry_date": "2026-08-01", "item_variant_id": 42, "price": 1200, "quantity": 10, "tax_rate": 20 } ], "number": "0001", "supplier_id": 42 } JSON, ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "completed_at": "2026-08-01T09:00:00Z", "currency": "RUB", "date": "2026-08-01T09:00:00Z", "delivery_status": "NOT_RECEIVED", "expected_date": "2026-08-01T09:00:00Z", "id": "42", "notes": "Комментарий", "number": "0001", "status": "OPEN", "supplier": {}, "tax_amount": 2400, "total_amount": 12000, "total_amount_with_tax": 14400, "items": [ { "batch_number": "0001", "expiry_date": "2026-08-01", "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, "received_quantity": 4, "sku": "ART-001", "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" }