RetailCRM API v5: GET /api/v5/orders/{externalId} — Получить заказ

Параметр	Где	Тип	Обяз.	Описание
externalId	path	string	да	Внешний или внутренний ID заказа
by	query	string	нет	externalId или id
site	query	string	нет	Код магазина

Базовые 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