МойСклад JSON API 1.2: POST /api/remap/1.2/entity/customerorder — Создание заказа покупателя

Документация: https://dev.moysklad.ru/doc/api/remap/1.2/#/documents/customerOrder#2-zakaz-pokupatelya

Параметр	Где	Тип	Обяз.	Описание
organization.meta	body	object	да	Ваше юрлицо
agent.meta	body	object	да	Контрагент-покупатель
positions[].assortment.meta	body	object	нет	Товар, услуга или модификация
positions[].quantity	body	number	нет	Количество
positions[].price	body	number	нет	Цена в копейках
positions[].discount	body	number	нет	Скидка, %
positions[].vat	body	integer	нет	НДС, %
positions[].reserve	body	number	нет	Резерв
store.meta	body	object	нет	Склад
state.meta	body	object	нет	Статус заказа
name	body	string	нет	Номер заказа
moment	body	string	нет	Дата документа

Базовые URL

• Боевой: https://api.moysklad.ru
• Все пути начинаются с .: /api/remap/1.2

Авторизация

Тип: Bearer-токен

Два способа: Basic Auth (заголовок Authorization: Basic с логин:пароль в Base64) или токен доступа (Authorization: Bearer <AccessToken>). Токен пользователя выдаёт POST /api/remap/1.2/security/token; для решений из маркетплейса используется токен решения. Лимит запросов зависит от способа: токены решений расходуют лимит медленнее, чем логин/пароль и токен пользователя.

Нюансы

• Обязательно сжатие: заголовок Accept-Encoding: gzip, иначе 415 без тела.
• Ссылки на объекты передаются в формате meta (href, type, mediaType).
• Списки возвращают meta (size, limit, offset, nextHref, previousHref) и rows; limit — до 1000.
• Массив positions в запросе на обновление полностью заменяет позиции документа: непереданные удаляются.
• Цены и суммы — в копейках.
• Функции под заголовком X-Lognex-Remap-Beta-Feature не подпадают под гарантию неизменности структуры.
• Остаток по заголовкам: X-RateLimit-Limit, X-RateLimit-Remaining, X-Lognex-Retry-TimeInterval, X-Lognex-Reset, X-Lognex-Retry-After.
• Вебхуки работают только на платных тарифах и в пробный период; при бесплатном тарифе их нельзя создать.
• Есть MCP-сервер документации JSON API (раздел MCP-dev) — он ищет по документации и не выполняет запросы к аккаунту.

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

• Создать покупателя и заказ

---

Если этого недостаточно — официальная документация: https://dev.moysklad.ru/doc/api/remap/1.2/#/documents/customerOrder#2-zakaz-pokupatelya Вся интеграция одним документом: https://mcp-everything.ru/integrations/moysklad.md