Перейти к содержимому

МойСклад

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

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

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

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

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