- name
- moysklad
- description
- МойСклад ERP — управление товарами, контрагентами, заказами, складами, остатками и документами через REST API. Используй когда нужно получить данные из МойСклад, создать или обновить записи, сформировать отчёты по остаткам или продажам.
- license
- MIT
- compatibility
- Requires Node.js 18+. Set MOYSKLAD_TOKEN, or MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD env vars.
- metadata
- version
- 1.0
МойСклад
Скилл для работы с МойСклад через JSON API 1.2. Используй для чтения и записи данных: товары, контрагенты, заказы покупателей, счета, склады, остатки.
Настройка
- Задай переменные окружения (один из вариантов):
Вариант А — токен (предпочтительно):
export MOYSKLAD_TOKEN='<токен>'Токен создаётся в МойСклад → Настройки → Безопасность → Токены.
Вариант Б — логин/пароль:
export MOYSKLAD_LOGIN='логин@email.com'
export MOYSKLAD_PASSWORD='пароль'- Проверь подключение:
node scripts/moysklad.mjs meБыстрый старт
# Список товаров
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-запросы
# 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— запись не найдена, проверь ID429— превышен лимит (45 req/s)- Код
1003в теле — неверный формат данных
Справочные материалы
- Обзор API и аутентификация:
references/api-overview.md - Основные сущности и поля:
references/entities.md - Примеры кода:
references/examples.md