МойСклад JSON API 1.2: POST /api/remap/1.2/entity/counterparty — Создание контрагента

Документация: https://dev.moysklad.ru/doc/api/remap/1.2/#/dictionaries/counterparty#2-kontragent

Параметр	Где	Тип	Обяз.	Описание
name	body	string	да	Наименование
inn	body	string	нет	ИНН
kpp	body	string	нет	КПП
legalTitle	body	string	нет	Полное наименование
legalAddress	body	string	нет	Юридический адрес
email	body	string	нет	Email
phone	body	string	нет	Телефон
tags	body	array	нет	Группы (теги)
externalCode	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/#/dictionaries/counterparty#2-kontragent Вся интеграция одним документом: https://mcp-everything.ru/integrations/moysklad.md