«Не удалось получить ключ True API» — частая ошибка DataMobile при работе с маркированным товаром. На самом деле проблема не в ТСД и не в DataMobile — ключ получает 1С от серверов «Честного знака» через УКЭП, а DataMobile только забирает готовый токен. Разбираем по официальным источникам (docs.data-mobile.ru, scanport.ru, docs.crpt.ru), где ломается цепочка и как её чинить за 5-10 минут без обращения в техподдержку.
Что такое «ключ True API» — термин без мистики
True API — это не DataMobile и не 1С. Это официальный программный интерфейс государственной системы маркировки «Честный Знак» (ГИС МТ), оператор — ЦРПТ. Через True API участники оборота отправляют запросы: проверить код маркировки, ввести товар в оборот, вывести из оборота, получить историю кода.
Официальная документация ЦРПТ: docs.crpt.ru/gismt/True_API. Промышленные адреса:
https://markirovka.crpt.ru/api/v3/true-apihttps://markirovka.crpt.ru/api/v4/true-api- Порт 443 (HTTPS)
- Аутентификация через УКЭП (усиленная квалифицированная электронная подпись)
- Токен сессии — JWT со сроком действия не более 10 часов
Как это работает в связке DataMobile + 1С:
- На компьютере с 1С установлен КриптоПРО CSP + вставлен токен УКЭП с сертификатом участника оборота
- 1С обращается к серверу «Честный Знак», авторизуется подписью и получает JWT-токен True API
- DataMobile по REST API просит у 1С этот токен через метод
GET /api/crpt/key - ТСД с DataMobile использует токен, чтобы при сканировании DataMatrix проверять статус кода в «Честном знаке»
Цепочка: УКЭП → 1С → ЦРПТ → JWT → HTTP-сервис DataMobileExch → ТСД. Ошибка «не удалось получить ключ» — это сбой на одном из звеньев, чаще всего на шаге 1-2.
Причины ошибки — по официальной документации DataMobile
В FAQ DataMobile есть две парные статьи («Для проверки требуется ключ True API» и «Не удалось получить ключ сессии ИСМП»), которые описывают одну и ту же бизнес-проблему:
| Причина | Как проявляется |
|---|---|
| В АРМ Диспетчера DataMobile не указана Организация или не запрошен ключ сессии | На ТСД при проверке КМ всплывает «Для проверки требуется ключ True API» |
| Не включена галка «Запросить ключ сессии» или не задана периодичность обновления | Ключ не обновляется автоматически, через 10 часов токен истекает, проверки кода перестают работать |
| В 1С не проверен сертификат УКЭП, не введён пароль сеанса | 1С не может получить JWT от «Честного знака» |
| 1С была перезапущена | Токен привязан к активному сеансу 1С. После перезапуска шаги с сертификатом нужно повторить |
| Сервер 1С не видит markirovka.crpt.ru:443 (прокси, брандмауэр) | 1С не может достучаться до ЦРПТ, ошибка при проверке сертификата |
| Нет КриптоПРО CSP или просрочен УКЭП | 1С не может подписать авторизационный запрос. Проверка сертификата падает |
| В лицензии DataMobile нет модуля «Маркировка» | Модуль доступен только на «Стандарт PRO» и выше |
Источники: FAQ True API, FAQ ИСМП, Модуль Маркировка.
Пошаговое решение — по шагам из официальной документации
Шаг 1. Настройка на стороне 1С (главное, решает 90% случаев)
- Откройте конфигурацию в 1С: «НСИ и администрирование» → «Интеграция с ИС МП (обувь, одежда, табак...)»
- Перейдите в «Сертификаты для подписания сообщений и авторизации на сервере»
- Откройте сертификат УКЭП → нажмите «Проверить»
- В появившемся окне введите пароль к контейнеру УКЭП
- Установите галку «Запомнить на время сеанса»
- Нажмите «ОК», дождитесь сообщения об успешной проверке
Для контроля — откройте справочник «Штрихкоды упаковок и товаров» → команда «Проверка кода маркировки». Если работает — ключ получен успешно.
⚠️ Важно: после каждого перезапуска 1С шаги 3-5 нужно повторять. Это не баг, а особенность: токен привязан к активному сеансу 1С и не сохраняется между перезапусками.
Шаг 2. Настройка в АРМ Диспетчера DataMobile
- Откройте АРМ Диспетчера → раздел «Устройства»
- Выберите ваше устройство (ТСД) → вкладка «Маркировка»
- Укажите Организацию (участника оборота «Честный знак»)
- Нажмите «Получить ключ сессии» — модуль запросит JWT у 1С
- Перейдите в «Проверки» → «Маркировка»
- Поставьте галку «Запросить ключ сессии»
- Укажите «Периодичность запроса» — как часто ключ обновлять автоматически (рекомендуется раз в 8 часов, так как JWT живёт 10)
Источник: docs.data-mobile.ru.
Шаг 3. Проверка сети
С сервера 1С должны быть открыты:
- Исходящий HTTPS (TCP 443) к
markirovka.crpt.ru - Если есть корпоративный прокси — он должен быть прописан в настройках КриптоПРО и 1С
- В хранилище Windows должны быть установлены корневые сертификаты Минцифры (ГОСТ)
Быстрая проверка доступности из PowerShell:
Test-NetConnection markirovka.crpt.ru -Port 443
Если TcpTestSucceeded = True — сеть в порядке.
Шаг 4. Проверка HTTP-сервиса DataMobile
В браузере откройте:
http://<IP_сервера_1С>/<имя_публикации>/hs/DataMobileExch
При правильной настройке откроется окно авторизации Apache/IIS. После ввода логина и пароля пользователя 1С должно появиться сообщение «Соединение с сервером установлено!».
Прямая проверка метода получения ключа:
http://<IP>/DM/hs/DataMobileExch/api/crpt/key?username=<user>&device_id=<id>
Должен вернуться JSON {"data": "key_value"} с непустым data. Если вернулась ошибка — 1С не получила токен на своей стороне (вернитесь к шагу 1).
Источник: REST API метод crpt/key.
Связанные частые ошибки DataMobile + 1С
Чаще всего ошибки True API сопровождаются другими проблемами подключения. Разбираем типовые по официальной документации.
| Ошибка | Причина | Решение |
|---|---|---|
| 401 Unauthorized | Неверный логин/пароль в профиле обмена, неподдерживаемый тип аутентификации, кириллица в логине 1С | Проверить логин пользователя 1С (желательно латиницей), выбрать правильный тип аутентификации (Basic или NTLM) в настройках DataMobile |
| 403 Forbidden | Недостаточно прав у пользователя 1С, ограничения на стороне веб-сервера | Назначить пользователю профиль прав «Менеджер» или «Консультант», проверить default.vrd / .htaccess |
404 на /hs/DataMobileExch |
HTTP-сервис не опубликован, Apache не перезапущен после публикации | В Конфигураторе → «Администрирование» → «Публикация», отметить DataMobileExch и «Публиковать HTTP-сервисы расширений по умолчанию», перезапустить Apache / службу веб-сервера |
| «Не могу подключиться к базе 1С» | Брандмауэр Windows блокирует порт Apache, ТСД в другой подсети | Пробросить порт публикации Apache в брандмауэре Windows, либо добавить Apache в список доверенных программ |
| «Ошибка при интеграции расширения» / не прошло объединение конфигурации | Объект в вашей конфигурации отличается от того, что в расширении DataMobile. Различия в контролируемых свойствах | В Конфигураторе → «Конфигурация» → «Проверка возможности применения». Использовать «Выбрать соответствие», «Очистить соответствие» или «Удалить объект» |
| «Текст XML содержит недопустимый символ в позиции N» | Управляющие символы или кириллица в логине / пароле | Убрать спецсимволы из логина и пароля пользователя обмена, использовать латиницу |
| «Неверный сертификат» / не подключается HTTPS | У 1С самоподписанный SSL-сертификат | В профиле обмена DataMobile активировать «Разрешить любые сертификаты», выбрать TLS 1.2 или 1.3 |
| «Ошибка лицензии» при активации DataMobile | Триал-лицензия уже выдавалась на этот аккаунт DMcloud; бессрочная привязана к другому Device ID | Проверить Device ID устройства и количество выданных триалов в DMcloud. Привязать корректную лицензию |
Источники: Настройки обмена 1С Online, Настройки учётной системы, FAQ: интеграция расширения, Блог Сканпорт.
Системные требования для работы с True API
| Компонент | Требование |
|---|---|
| Лицензия DataMobile | Стандарт PRO / Online Lite / Online (с модулем «Маркировка») |
| Поддерживаемые 1С | Розница 1/2/3, УНФ, УТ 10/11, КА/КА2, ERP 2, Альфа-Авто 5/6, Трактиръ, ДАЛИОН ТРЕНД, Штрих-М 5/7, БП3 |
| Веб-сервер | Apache (в документации пример с 2.2) или IIS. На Linux + Apache 2.4 пользователи иногда отмечают проблемы (неофициально) |
| Криптография | КриптоПРО CSP + УКЭП (токен или флешка) |
| УКЭП | На имя организации-участника оборота «Честный знак», действующая |
| Сеть | Исходящий HTTPS (TCP 443) с сервера 1С до markirovka.crpt.ru |
| Локальная сеть | Порт Apache (80 по умолчанию) открыт с ТСД до сервера 1С |
Источники: Changelog DataMobile 1C, data-mobile.ru — Маркировка, Блог Сканпорт — версии лицензий.
Диагностика: порядок действий если всё ещё не работает
Если прошли шаги 1-4 и ошибка сохраняется, идите по цепочке:
- УКЭП: откройте КриптоПРО CSP → «Установленные сертификаты». Ваш сертификат должен быть виден, срок действия не истёк
- Сеть: с сервера 1С выполните
Test-NetConnection markirovka.crpt.ru -Port 443. Должен пройти - Корневые сертификаты: в Windows → «Сертификаты» → проверить наличие сертификатов Минцифры (ГОСТ-2012)
- 1С: проверьте сертификат, введите пароль. Тестовая проверка через справочник «Штрихкоды» должна пройти
- HTTP-сервис: в браузере откройте
/hs/DataMobileExch— авторизация должна появиться - Метод получения ключа: в браузере или Postman —
/hs/DataMobileExch/api/crpt/keyдолжен вернуть JSON с ключом - АРМ Диспетчера: настроен, организация указана, галка «Запросить ключ сессии» активна, период 8 часов
- Логи: журнал обмена в АРМ Диспетчера, технологический журнал 1С, логи Apache
access.log/error.log
Если найдёте первое место в цепочке где «сломано» — проблему уже легко изолировать и починить.
Помощь B2CMSK — когда сами не хотите разбираться
Мы — официальный партнёр Сканпорт (DataMobile) и 1С. Решаем проблемы с True API и интеграцией DataMobile + 1С:
- Диагностика ошибок «Не удалось получить ключ True API», 401/403/404 и других
- Настройка КриптоПРО CSP + УКЭП для работы с «Честным знаком»
- Проверка сети и брандмауэров на сервере 1С
- Публикация HTTP-сервиса DataMobileExch, настройка Apache/IIS
- Объединение расширения DataMobile с вашей конфигурацией 1С
- Настройка АРМ Диспетчера: лицензии, устройства, маркировка
- Обучение персонала работе с маркированным товаром на ТСД
Опишите симптом ошибки — диагностируем по логам и вернёмся с решением в течение часа.
Получить консультациюИсточники
- docs.data-mobile.ru — FAQ: Для проверки требуется ключ True API
- docs.data-mobile.ru — FAQ: Не удалось получить ключ сессии ИСМП
- docs.data-mobile.ru — REST API метод crpt/key
- docs.data-mobile.ru — Настройки обмена с 1С Online
- scanport.ru — ТСД с DataMobile: подключение к 1С
- scanport.ru — Версии лицензий DataMobile
- docs.crpt.ru — True API (официальная документация ЦРПТ)
MAX