Синхронизация 1С Бухгалтерия 3.0 с МойСклад по API: настройка и проблемы

Синхронизация 1С:Бухгалтерия 3.0 с МойСклад по API позволяет автоматически переносить первичные документы из складской системы в бухгалтерию без ручного ввода. Разбираем, как правильно получить токен, какие документы поддерживаются, и что делать когда остатки после загрузки не сходятся.

Что такое синхронизация 1С с МойСклад по API

МойСклад предоставляет REST API на основе JSON 1.2 для обмена данными с внешними системами. Специальная обработка для 1С:Бухгалтерия 3.0 подключается к этому API, забирает документы и автоматически создаёт их в базе 1С. Бухгалтер получает готовые проводки без необходимости запрашивать данные у складских сотрудников вручную.

Интеграция актуальна для платформы 1С 8.3.20 и выше с конфигурацией Бухгалтерия предприятия 3.0 (любые актуальные релизы). Для ERP 2.5 и УТ 11 принципы схожи, но потребуется отдельная обработка.

Поддерживаемые документы и справочники

Обработка загружает основные справочники (номенклатура, контрагенты, склады, организации) и следующие виды документов:

• Поступления
• Реализации
• Возвраты покупателя
• Возвраты поставщику
• Оприходования
• Списания
• Перемещения
• Розничные продажи
• Розничные возвраты

Возможности обработки

• Отбор документов по конкретному складу
• Установка периода — дата начала и окончания
• Работа с несколькими складами одновременно
• Поддержка нескольких организаций в одной базе
• Установка ГТД по правилам Бухгалтерии предприятия
• Загрузка больших объёмов данных без зависаний

Способ 1: Получение токена МойСклад и первичная настройка

Перед первым запуском обработки необходимо сгенерировать токен доступа в МойСклад:

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

Способ 2: Загрузка документов с отбором

После настройки подключения можно приступать к загрузке документов:

1. Выберите организацию, от имени которой ведётся учёт в 1С.
   
2. Укажите склад или несколько складов для отбора — если оставить поле пустым, загрузятся все склады.
3. Задайте период документов: дата начала и дата окончания.
4. Выберите типы документов, которые нужно загрузить.
5. Нажмите Получить документы. Обработка обратится к API МойСклад и отобразит список найденных документов.
6. Просмотрите список, при необходимости снимите отметки с ненужных документов, затем нажмите Загрузить в 1С.

Заполнение ГТД при реализации проходит на уровне Бухгалтерии предприятия, поэтому для корректной загрузки сначала необходимо загрузить документы поступления.

Способ 3: Загрузка в правильном порядке для сходимости остатков

В 1С документы связаны цепочкой проводок: остатки на счетах формируются последовательно. Если загружать документы в произвольном порядке, возникнут отрицательные остатки и ошибки проведения.

Правильный порядок загрузки:

1. Поступления — формируют начальный приход на склад и счета учёта
2. Перемещения — перемещения между складами после поступления
3. Оприходования — излишки по инвентаризации
4. Реализации и розничные продажи — расход со склада
5. Возвраты покупателя и возвраты поставщику — после реализаций и поступлений
6. Списания — в последнюю очередь

Если остатки всё равно не сходятся после корректной загрузки, выполните перепроведение документов в 1С за нужный период: меню Операции → Проведение документов.

Типичные ошибки при синхронизации

• Ошибка 401 Unauthorized — токен введён неверно, истёк срок действия или токен был удалён в МойСклад. Сгенерируйте новый токен.
• Ошибка 403 Forbidden — у токена недостаточно прав. Проверьте настройки прав токена в МойСклад.
• Номенклатура не найдена в 1С — при первой загрузке обработка пытается сопоставить товары по наименованию или артикулу. Если сопоставление не удалось, создаётся новая позиция номенклатуры. Проверьте дубли после загрузки.
• Ошибка записи документа в 1С — проверьте журнал регистрации 1С (Все функции → Стандартные → Журнал регистрации) на предмет конкретной ошибки. Чаще всего это незаполненный обязательный реквизит.
• Таймаут при загрузке большого объёма — используйте загрузку частями: разбейте период на более короткие интервалы или загружайте по одному типу документов.

Что делать, если синхронизация не работает

• Проверьте доступность API МойСклад: откройте в браузере https://api.moysklad.ru/api/remap/1.2/ — должен вернуться JSON-ответ с доступными методами.
• Убедитесь, что платформа 1С обновлена до актуальной версии (8.3.20 и выше). Более старые версии могут не поддерживать современные TLS-протоколы, которые требует API.
• Проверьте настройки прокси и антивируса — они могут блокировать исходящие HTTPS-запросы к api.moysklad.ru.
• Изучите технологический журнал 1С для получения низкоуровневых деталей ошибки: %localappdata%\1C\1cv8\logs\.
• Если проблема не решается — обратитесь к разработчику обработки по адресу gerzoid@allerrorcodes.ru.

FAQ

Зачем синхронизировать МойСклад и 1С Бухгалтерию?

Синхронизация позволяет бухгалтерии оперативно получать первичные документы из складской программы без ручного ввода. Бухгалтер работает с уже созданными документами в 1С, не отвлекая сотрудников склада и не дублируя данные вручную.

Почему в 1С не сходятся остатки после загрузки из МойСклад?

Чаще всего причина в нарушении порядка загрузки документов. В 1С нельзя провести реализацию, если нет поступления — возникнет отрицательный остаток. Загружайте документы в правильном порядке: поступления → перемещения → реализации → возвраты → списания.

Можно ли загружать документы выборочно, не за весь период?

Да. Обработка поддерживает отбор по складу, нескольким складам и произвольному периоду. Можно загружать отдельные типы документов — например, только поступления за конкретную неделю.

Как настроить обработку для нескольких организаций?

В настройках обработки предусмотрена поддержка нескольких организаций. Для каждой организации указывается соответствующий токен МойСклад и настраивается сопоставление складов и счетов учёта.

Нужна ли лицензия МойСклад с доступом к API?

Доступ к API МойСклад включён в тарифы «Базовый» и выше. На бесплатном тарифе API недоступен. Проверьте ваш текущий тариф в разделе «Настройки → Подписка» в МойСклад.

Версии платформы 1С, с которыми работает обработка?

Обработка тестировалась на платформе 1С 8.3.20 и выше с конфигурацией Бухгалтерия предприятия 3.0. Более старые версии платформы (8.3.16 и ниже) могут не поддерживать HTTPS с современными cipher suite — рекомендуется обновить платформу до актуальной версии.