МойСклад#

Скилл для работы с МойСклад через 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