Золотенков
Выпустить ключ

Список заказов покупателей

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

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

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

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

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

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

  • cursor строка необязателен

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

  • status строка необязателен

    Статус заказа: OPEN — открыт, DONE — выполнен, CANCELLED — сделка не состоялась (ZOL-11323). Отмененные заказы из потребностей и резервов выпадают, но из учета не исчезают: отгруженное по ним остается отгруженным

  • delivery_status строка необязателен

    Состояние отгрузки: NOT_SHIPPED, PACKED, PARTIALLY_PACKED, PARTIALLY_SHIPPED или SHIPPED

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

    Только заказы этого покупателя

  • created_after строка необязателен

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

  • created_before строка необязателен

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

Ответы

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