Как подключить МойСклад и просматривать остатки

1. Что проверить до подключения

• У вас есть права администратора выбранного магазина в Мастер Поставки.
• У вас есть API-токен МойСклад с доступом к отчёту об остатках.
• Вы выбрали нужный магазин: подключение и ключ сохраняются отдельно для каждого магазина.

Для обновления локального остатка артикул МойСклад должен совпадать с артикулом товара (SKU) выбранного магазина. Если артикул в МойСклад пустой, используется код. Регистр букв и пробелы по краям не учитываются. При неоднозначном совпадении или отсутствии соответствия локальный остаток не меняется.

2. Получите API-ключ МойСклад

Если подходящий ключ уже есть, переходите к подключению. В поле API-ключа используется токен доступа к JSON API МойСклад.

1. Войдите в нужный аккаунт МойСклад.
2. Откройте Меню пользователя → Настройки → Токены.
3. Нажмите «+Токен» и скопируйте полученный токен.
4. Вставьте его в настройки Мастер Поставки на следующем шаге. Не добавляйте слово Bearer, кавычки или пробелы.

Путь к разделу токенов приведён в официальной справке МойСклад (раздел о получении токена). Если раздел недоступен, обратитесь к администратору аккаунта.

3. Подключите ключ в настройках магазина

1. Выберите нужный магазин в Мастер Поставки.
2. Откройте Настройки магазина.
3. Найдите блок «Интеграция с МойСклад» рядом с блоком 1С.
4. Вставьте токен в поле «API-ключ МойСклад» и нажмите «Подключить».
5. Дождитесь статуса «Подключено · получение остатков». Ключ проверяется запросом на чтение остатков и сохраняется зашифрованным.

Отдельно нажимать «Сохранить настройки» для этой интеграции не нужно. После подключения поле ключа очищается: сохранённый ключ повторно не показывается.

4. Проверьте остатки

1. Подождите первую автоматическую загрузку — обычно до 5 минут после подключения.
2. В том же блоке нажмите «Получить остатки».
3. Проверьте время получения над таблицей и несколько знакомых товаров. Сравнивайте с суммарным отчётом по всем складам МойСклад, доступным ключу.
4. Для просмотра следующих позиций используйте кнопки «Назад» и «Далее». На странице — до 100 позиций.

Например, остаток −2 в МойСклад будет показан у нас как 0. Исходное значение в МойСклад останется −2. Отчёт включает нулевые остатки; выбор отдельного склада в этой версии не предусмотрен.

5. Как работает обновление каждые 5 минут

• Расписание включается автоматически после подключения. Держать браузер открытым не требуется.
• После получения всех страниц одновременно сохраняются отчёт и локальные остатки сопоставленных товаров. Записывается колонка «Остаток»; отрицательные значения заменяются на 0.
• Под блоком подключения показано число обновлённых, не найденных и неоднозначных позиций. Пропущенные товары и товары, отсутствующие в отчёте, не обнуляются.
• Открытая таблица перечитывает сохранённый отчёт каждые 5 минут. Кнопка «Обновить остатки» сразу перечитывает последнюю сохранённую версию, не запускает внеочередной обмен.
• При ошибке остаются предыдущие данные с прежним временем получения и предупреждением. Следующая попытка — по расписанию.

Ориентируйтесь на время над таблицей. При недоступности МойСклад или длительной загрузке данные могут быть старше 5 минут.

6. Замените ключ или отключите интеграцию

Для замены вставьте новый токен и нажмите «Заменить ключ». Если проверка не пройдёт, прежнее подключение сохранится. После успешной замены дождитесь нового отчёта на ближайшем автоматическом обновлении.

Кнопка «Отключить» удаляет подключение и сохранённый отчёт из Мастер Поставки. Уже записанные локальные остатки сохраняются, но перестают обновляться из МойСклад. Токен в МойСклад не отзывается, данные самого МойСклад не изменяются.

7. Частые ошибки