RetailCRM API v5: GET /api/v5/orders — Список заказов

Параметр	Где	Тип	Обяз.	Описание
apiKey	query	string	да	API-ключ
filter	query	object	нет	Фильтр: filter[numbers][], filter[externalIds][], filter[customerId], filter[email], filter[minPrice], filter[maxPrice], filter[trackNumber] и др.
limit	query	integer	нет	Количество записей на странице
page	query	integer	нет	Номер страницы, по умолчанию 1

Базовые URL

• Боевой: https://{your-subdomain}.retailcrm.ru/api/v5/

Авторизация

Тип: API-ключ

API-ключ создаётся в аккаунте RetailCRM и передаётся в параметре apiKey (GET или POST). Если ключ даёт доступ к нескольким магазинам, части методов нужен параметр site — символьный код магазина. Запросы — только по HTTPS, кодировка UTF-8.

Нюансы

• POST-запросы отправляются как application/x-www-form-urlencoded, а вложенные структуры (order, customer, offers) — JSON-строкой внутри поля формы.
• Для ключа с доступом к нескольким магазинам часть методов требует site.
• Ответы списков содержат метаданные пагинации: limit, totalCount, currentPage, totalPageCount.
• Для синхронизации изменений используйте /orders/history и /customers/history, а не полную перевыгрузку списков.
• Код 460 при пакетной загрузке означает, что часть заказов загружена с ошибками; загруженные перечислены в uploadedOrders.

Сценарии с этим методом

• Забирать изменения заказов без полной перевыгрузки

---

Если этого недостаточно — официальная документация: https://rest-api-docs.retailcrm.ru/v5/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/retailcrm.md