МойСклад

МойСклад ERP — управление товарами, контрагентами, заказами, складами, остатками и документами через REST API. Используй когда нужно получить данные из МойСклад, создать или обновить записи, сформировать отчёты по остаткам или продажам.

Скилл для работы с МойСклад через JSON API 1.2. Используй для чтения и записи данных: товары, контрагенты, заказы покупателей, счета, склады, остатки.

Настройка

1. Задай переменные окружения (один из вариантов):

   Вариант А — токен (предпочтительно):

   text

   export MOYSKLAD_TOKEN='<токен>'
   

   Токен создаётся в МойСклад → Настройки → Безопасность → Токены.

   Вариант Б — логин/пароль:

   text

   export MOYSKLAD_LOGIN='логин@email.com'
   export MOYSKLAD_PASSWORD='пароль'
   

2. Проверь подключение:

   text

   node scripts/moysklad.mjs me
   

Быстрый старт

bash

# Список товаров
node scripts/moysklad.mjs products

# Поиск товара
node scripts/moysklad.mjs products --search "Ноутбук"

# Контрагенты
node scripts/moysklad.mjs counterparties

# Остатки
node scripts/moysklad.mjs stock

# Заказы покупателей
node scripts/moysklad.mjs orders

# Создать контрагента
node scripts/moysklad.mjs create-counterparty --name "ООО Рога и Копыта" --inn "7701234567"

# Создать заказ
node scripts/moysklad.mjs create-order --counterparty-id <id> --product-id <id> --quantity 5 --price 1000

Команды CLI

Все команды поддерживают флаг --json для вывода сырого JSON.

Информация об аккаунте

• node scripts/moysklad.mjs me — текущий пользователь и организация

Товары

• node scripts/moysklad.mjs products — список всех товаров
• node scripts/moysklad.mjs products --search "текст" — поиск
• node scripts/moysklad.mjs products --limit 50 --offset 0 — пагинация
• node scripts/moysklad.mjs product-get <id> — товар по ID

Контрагенты

• node scripts/moysklad.mjs counterparties — список
• node scripts/moysklad.mjs counterparties --search "ООО" — поиск
• node scripts/moysklad.mjs create-counterparty --name "Название" [--inn ИНН] [--phone "+7..."] [--email "..."] — создать

Заказы покупателей

• node scripts/moysklad.mjs orders — список заказов
• node scripts/moysklad.mjs order-get <id> — заказ по ID с позициями
• node scripts/moysklad.mjs create-order --counterparty-id <id> --product-id <id> --quantity 1 --price 100 — создать заказ

Склады

• node scripts/moysklad.mjs stores — список складов

Остатки

• node scripts/moysklad.mjs stock — остатки по всем складам
• node scripts/moysklad.mjs stock --store-id <id> — по складу
• node scripts/moysklad.mjs stock --product-id <id> — по товару

Счета покупателям

• node scripts/moysklad.mjs invoices — список счетов
• node scripts/moysklad.mjs invoice-get <id> — счёт по ID

Прямые API-запросы

bash

# GET
node scripts/moysklad.mjs api GET /entity/product?limit=10

# POST
node scripts/moysklad.mjs api POST /entity/counterparty '{"name":"Тест"}'

# PUT
node scripts/moysklad.mjs api PUT /entity/product/<id> '{"name":"Новое имя"}'

# DELETE
node scripts/moysklad.mjs api DELETE /entity/product/<id>

Ошибки

• 401 — неверный логин/пароль
• 403 — недостаточно прав
• 404 — запись не найдена, проверь ID
• 429 — превышен лимит (45 req/s)
• Код 1003 в теле — неверный формат данных

Справочные материалы

• Обзор API и аутентификация: references/api-overview.md
• Основные сущности и поля: references/entities.md
• Примеры кода: references/examples.md