Список заказов поставщикам

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

Требуемое право ключа: read:purchase

Заказы поставщикам постранично, по курсору, с фильтрами по статусу, состоянию приемки, поставщику и дате.

Параметры запроса

limit целое число необязателен

Сколько записей вернуть: от 1 до 200, по умолчанию 50
cursor строка необязателен

Курсор из поля next_cursor предыдущего ответа. Без него чтение начинается сначала
status строка необязателен

Статус заказа: OPEN — открыт, DONE — закрыт, CANCELLED — отменен, DRAFT — черновик. Без фильтра черновики не отдаются
delivery_status строка необязателен

Состояние приемки: NOT_RECEIVED, PARTIALLY_RECEIVED или RECEIVED
supplier_id целое число необязателен

Только заказы этому поставщику
created_after строка необязателен

Заведенные не раньше даты: date >= значение. ISO-8601 — дата 2026-08-01 (начало суток UTC) либо момент 2026-08-01T00:00:00Z
created_before строка необязателен

Заведенные раньше даты: date < значение. ISO-8601 — дата 2026-08-01 (начало суток UTC) либо момент 2026-08-01T00:00:00Z

Ответы

200 Страница списка заказов поставщикам
400 Недопустимое значение фильтра или курсора
401 Ключ не передан, недействителен или отозван
403 У ключа нет права read:purchase
429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After

curl --request GET \ --url 'https://mrp.zolotenkov.ru/api/external/v1/purchase-orders?limit=1' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Accept: application/json'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/purchase-orders?limit=1", { method: "GET", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, }); const data = await response.json();

import requests response = requests.get( "https://mrp.zolotenkov.ru/api/external/v1/purchase-orders?limit=1", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/purchase-orders?limit=1'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", ], ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "data": [ { "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 } ], "next_cursor": "eyJpZCI6NDJ9" }