﻿---
title: МойСклад
description: "Облачный торговый и складской учёт с JSON API 1.2: товары, модификации, цены, остатки, заказы покупателей и документы отгрузки."
---

МойСклад — облачная учётная система для торговли: в интеграции с магазином она владеет товарами,
ценами, остатками и документами, а магазин — витриной и оформлением заказа.

## Интеграции

### Проверенные связки

- [МойСклад и WooCommerce: витрина на данных учёта](https://wpcraft.ru/integrations/moysklad/woocommerce.md) — Каталог, цены и остатки
  приходят в магазин, а заказы уходят в учёт документами.

### Возможные связки

- [WordPress](https://wpcraft.ru/integrations/wordpress.md) (Платформы) — возможная связка: сценарии и ограничения ещё не
  проверены. [Обсудить
  интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,wordpress)
- [Битрикс24](https://wpcraft.ru/integrations/bitrix24.md) (CRM) — возможная связка: сценарии и ограничения ещё не
  проверены. [Обсудить
  интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,bitrix24)
- [MAX](https://wpcraft.ru/integrations/max.md) (Коммуникации) — возможная связка: сценарии и ограничения ещё не проверены.
  [Обсудить интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,max)
- [ВКонтакте](https://wpcraft.ru/integrations/vk.md) (Коммуникации) — возможная связка: сценарии и ограничения ещё не
  проверены. [Обсудить интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,vk)
- [Telegram Bot API](https://wpcraft.ru/integrations/telegram.md) (Коммуникации) — возможная связка: сценарии и ограничения
  ещё не проверены. [Обсудить
  интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,telegram)
- [Яндекс Телемост](https://wpcraft.ru/integrations/yandex-telemost.md) (Коммуникации) — возможная связка: сценарии и
  ограничения ещё не проверены. [Обсудить
  интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,yandex-telemost)
- [1С](https://wpcraft.ru/integrations/1c.md) (Учёт и склад) — возможная связка: сценарии и ограничения ещё не проверены.
  [Обсудить интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,1c)
- [1С-Битрикс: Управление сайтом](https://wpcraft.ru/integrations/1c-bitrix.md) (CMS и e-commerce) — возможная связка:
  сценарии и ограничения ещё не проверены. [Обсудить
  интеграцию](https://wpcraft.ru/contacts?ref=integrations&systems=moysklad,1c-bitrix)

## Назначение

Сервис ведёт номенклатуру, модификации, цены по типам, склады и остатки, заказы покупателей, отгрузки и
оплаты. Для небольшого e-commerce это способ получить учёт без серверной 1С и без разработки
собственного складского модуля.

## Способы обмена

| Способ | Что даёт | Когда уместен | Ограничения |
| --- | --- | --- | --- |
| JSON API 1.2 | Полный CRUD по сущностям и документам, фильтры по `updated` | Основной канал синхронизации | Лимит запросов, пагинация, вложенные позиции отдельными вызовами |
| Вебхуки | Уведомление о создании или изменении документа | Быстрая реакция на отгрузку и оплату | Не заменяет реконсиляцию: событие можно потерять |
| Выгрузка файлов | Резервная копия и первичная загрузка | Массовый импорт, аудит | Нет инкрементальности |

Инкрементальная синхронизация строится на фильтре `updated>=<момент>` с сортировкой по времени
изменения и на сохранении последней обработанной метки. Без сохранённой метки каждый запуск превращается
в полную выгрузку.

## Ограничения

- **Лимит запросов.** Документация ограничивает частоту обращений (порядка 45 запросов за 3 секунды) и
  размер страницы выборки; при превышении API отвечает ошибкой, которую нельзя игнорировать.
- **Модификации товара.** Товар с модификациями — родитель и набор модификаций; цены и остатки
  хранятся на уровне модификаций, а не только родителя.
- **Позиции документа.** Заказ покупателя и отгрузка собираются из позиций: сначала документ, затем
  `positions`; частичная запись оставляет документ без состава.
- **Справочники-обязательства.** Проведение документа требует организации, склада и контрагента —
  интеграция должна создавать или находить их заранее.
- **Роли и права.** Токен доступа наследует права сотрудника: для интеграции заводится отдельный
  пользователь с минимально нужным набором прав.

## Решения

- [WooMS: связка WooCommerce и МойСклад](https://wpcraft.ru/integrations/solutions/wooms.md) — Открытый плагин, который
  переносит каталог, цены и остатки из МойСклад в WooCommerce и отправляет заказы обратно в учёт
  документами.

## Источники

- [МойСклад JSON API 1.2](https://dev.moysklad.ru/doc/api/remap/1.2/)
- [МойСклад: справочник товаров](https://dev.moysklad.ru/doc/api/remap/1.2/dictionaries/#suschnosti-towar)
- [МойСклад: заказ покупателя](https://dev.moysklad.ru/doc/api/remap/1.2/documents/#dokumenty-zakaz-pokupatela)