Интеграция с 1С в Трумарке: как подключить обработку и токен

Интеграция с 1С переносит УПД, сформированные в Трумарке, в вашу учётную программу — вместе с кодами маркировки и всей иерархией упаковок. Нужны две вещи: обработка, которую вы добавляете в 1С, и токен, по которому она обращается к Трумарку. Сертификаты, КриптоПро и СУЗ в самой 1С настраивать не нужно: подпись и обмен с Честным ЗНАКом остаются в Трумарке.

Что нужно для интеграции с 1С #

• Конфигурация 1С: Управление торговлей 11, 1С:ERP, Комплексная автоматизация или Бухгалтерия предприятия КОРП 3.0.
• Тариф «Опти» или «Макси». В «Мини» интеграция с 1С не входит — что входит в тарифы.
• Доступ 1С в интернет к адресу api.truemark.ru: обработка получает данные оттуда.
• УПД в Трумарке. В 1С загружаются документы из раздела «Отгрузка УПД» — как создать УПД.

Шаг 1. Скачайте обработку для 1С #

Нажмите на значок профиля в правом верхнем углу → «Настройки» → вкладка «API». В карточке «Integration API» нажмите «Скачать обработку 1С» — сохранится файл truemark1c.epf.

Шаг 2. Создайте токен #

В той же карточке нажмите «Сгенерировать». Появится блок «Скопируйте токен сейчас» с токеном целиком — нажмите «Скопировать» и сохраните токен там, где его не увидят посторонние.

Шаг 3. Добавьте обработку в 1С #

Файл truemark1c.epf — это дополнительная обработка. Она подключается штатным механизмом 1С «Дополнительные отчёты и обработки»; в типовых конфигурациях он находится в разделе администрирования, в пункте «Печатные формы, отчёты и обработки». Саму конфигурацию при этом менять не нужно.

1. Откройте список дополнительных отчётов и обработок и добавьте в него файл truemark1c.epf.
2. Сохраните обработку. У неё появится команда «Интеграция с TrueMark» — запустите её.

Шаг 4. Введите токен в обработке #

При первом запуске обработка откроет окно «Авторизация в TrueMark». Вставьте токен из шага 2 в поле «Токен доступа» и нажмите «Авторизация». Токен сохранится в 1С, вводить его при каждом запуске не придётся.

Шаг 5. Загрузите УПД в 1С #

После авторизации обработка показывает список УПД вашей компании из Трумарка: дата, контрагент, номер, сумма, количество кодов маркировки, статус УПД и отметка «Отражен» или «Не отражен» — загружен ли документ в 1С. Список можно отобрать по периоду и статусу.

1. Дважды щёлкните по строке нужного УПД. Откроется окно «Загрузка ЭД».
2. Выберите «Загрузить новый документ». Вариант «Перезаполнить существующий» нужен, если УПД уже загружали и он изменился в Трумарке.
3. Нажмите «Выполнить».

1С создаст документ «Реализация (акты, накладные, УПД)». Во время загрузки обработка получает из Трумарка полную иерархию кодов маркировки — транспортные и групповые упаковки с вложенными единицами — и добавляет штрихкоды упаковок в базу 1С. У загруженного УПД в списке появится отметка «Отражен».

Документ в 1С — учётный: в самом окне загрузки сказано, что загружаемые документы не являются юридически значимыми. Контрагенту УПД вы отправляете из 1С через своего оператора ЭДО либо подписываете и отправляете из Трумарка.

Если что-то пошло не так #

• «Ошибка авторизации на сервере. Получите токен доступа в личном кабинете и запустите обработку заново» или «Токен отсутствует, некорректен или отозван». Токен введён с ошибкой, отозван или заменён новым. Создайте токен в кабинете кнопкой «Перегенерировать» и введите его в обработке.
• В списке нет нужного УПД. Проверьте отбор по периоду и статусу. Токен привязан к одной компании: УПД другой компании по нему не видны — для неё нужен токен из её кабинета.
• «Идёт проверка кодов УПД. XML будет доступен, когда она завершится». Трумарк ещё проверяет коды документа в Честном ЗНАКе. Дождитесь конца проверки в разделе «Отгрузка УПД» и загрузите документ снова.
• «УПД ещё собирается: товары переносятся из ввода в оборот. Повторите запрос позже». Документ ещё создаётся в Трумарке. Повторите загрузку через несколько минут.
• Документ не загружается, сообщение о незаполненном номере, типе или подписанте. Черновик УПД заполнен не до конца. Откройте его в Трумарке и заполните реквизиты первого шага — как создать УПД.
• «Активный GIS MT токен компании недоступен». В кабинете истекла авторизация в ГИС МТ, и Трумарк не может получить иерархию кодов. Продлите авторизацию и повторите загрузку.
• «Превышен лимит запросов». По одному токену принимается не больше 120 запросов в минуту. Подождите минуту и повторите.
• «Внешний сервис временно недоступен». Честный ЗНАК не ответил на запрос об иерархии кодов. Повторите загрузку позже.

Связанные статьи #

• Токен API Трумарка: как создать, заменить и отозвать
• Как создать УПД в Трумарке: реквизиты, адреса сторон и товары
• Как скачать XML УПД из Трумарка: файл документа, PDF и архив
• Как подписать и отправить УПД: проверка кодов и статусы документа
• Что входит в тариф Трумарка и как считается остаток кодов
• Настройки кабинета Трумарка: что где лежит
• Маркировка в 1С через Трумарк: как это устроено