Токен API — это ключ, по которому 1С или ваша учётная система получает из Трумарка УПД и иерархию кодов маркировки без входа по сертификату. Токен создаётся на вкладке «API» в настройках кабинета. У компании один действующий токен: его можно заменить или отозвать в любой момент.
Пройти обучение в кабинете: обработка 1С и токенДля чего нужен токен API #
По токену программа обращается к трём запросам Трумарка:
- список УПД компании — с отбором по статусу, периоду и идентификатору документа;
- XML-файл выбранного УПД;
- иерархия кодов маркировки: что вложено в транспортные и групповые упаковки.
Этими запросами пользуется обработка для 1С — как подключить интеграцию с 1С. Заказать коды, ввести товар в оборот или подписать документ по токену нельзя: такие действия выполняются только в кабинете.
Шаг 1. Откройте вкладку «API» в настройках #
Нажмите на значок профиля в правом верхнем углу → «Настройки» → вкладка «API». Пока токена нет, в карточке написано «Токен ещё не создан».
Шаг 2. Сгенерируйте токен и сразу скопируйте его #
Нажмите «Сгенерировать». В карточке появится блок «Скопируйте токен сейчас» с токеном целиком.
- Нажмите «Скопировать» — токен попадёт в буфер обмена.
- Вставьте его туда, где он нужен: в обработку 1С или в настройки своей программы.
- Нажмите «Скрыть», когда токен сохранён.
Токен целиком показывается один раз: Трумарк не хранит его в открытом виде. После кнопки «Скрыть» или перезагрузки страницы увидеть его снова нельзя — только создать новый.
Что кабинет показывает о токене #
- Сведения о токене. «Токен» — его начало и звёздочки вместо остального; «Префикс» — та же начальная часть, по ней удобно сверить, какой токен введён в 1С; «Создан» — дата создания; «Последнее использование» — дата последнего запроса с этим токеном. Если дата не меняется, интеграция к Трумарку не обращается.
- «Перегенерировать» — заменить токен новым.
- «Отозвать» — отключить токен.
- «Документация» — описание запросов для разработчиков.
Как заменить токен #
Нажмите «Перегенерировать». Кабинет сразу создаст новый токен и покажет его в блоке «Скопируйте токен сейчас», а прежний в ту же секунду перестанет работать — подтверждения кабинет не спрашивает. Поэтому меняйте токен тогда, когда готовы сразу вставить новый в 1С или в свою программу: до этого интеграция будет получать ошибку авторизации.
Заменять токен стоит, если он потерян, попал к посторонним или сменился сотрудник, который настраивал интеграцию.
Как отозвать токен #
Нажмите «Отозвать». Токен отключается сразу, без подтверждения; в карточке снова появится «Токен ещё не создан». Отзывайте токен, когда интеграция больше не нужна. Новый токен можно создать в любой момент кнопкой «Сгенерировать».
Как использовать токен в запросах #
Этот раздел — для разработчиков, которые подключают к Трумарку свою систему.
- Адрес сервиса — https://api.truemark.ru, запросы начинаются с /integration/v1.
- Токен передаётся в заголовке Authorization: Bearer и сам токен после пробела.
- По одному токену принимается до 120 запросов в минуту.
- Параметры запросов и формат ответов — на странице, которую открывает кнопка «Документация».
Если что-то пошло не так #
- «Необходимо передать действующий Bearer token». Токен в запросе неверный, отозван или заменён новым. Проверьте, что в программе введён текущий токен: сверьте его начало с полем «Префикс» в кабинете.
- «Превышен лимит запросов». За минуту отправлено больше 120 запросов. Подождите минуту; если запросы шлёт ваша программа, уменьшите частоту обращений.
- 1С перестала загружать УПД после замены токена. В обработке остался прежний токен. Введите в ней новый — шаг 4 инструкции по 1С.
- Токен не успели скопировать. Посмотреть его повторно нельзя. Нажмите «Перегенерировать» и скопируйте новый.
- Кнопка «Отозвать» серая. Действующего токена нет — отзывать нечего.
- «Последнее использование» пустое. С этим токеном ещё не было ни одного запроса: он не введён в программу или введён с ошибкой.
Частые вопросы #
Сколько токенов API может быть у компании?
Один действующий. При создании нового прежний отключается автоматически.
Есть ли у токена срок действия?
Нет. Токен работает, пока вы не замените его кнопкой «Перегенерировать» или не отзовёте.
Почему нельзя посмотреть токен ещё раз?
Трумарк хранит не сам токен, а его контрольную сумму. Поэтому показать токен повторно невозможно — можно только создать новый.
Что можно сделать по токену API?
Получить список УПД компании, скачать XML выбранного УПД и запросить иерархию кодов маркировки. Изменить данные в кабинете, заказать коды или подписать документ по токену нельзя.
Можно ли передать токен подрядчику, который настраивает 1С?
Да, но токен открывает доступ к УПД и кодам вашей компании. Передавайте его только тому, кто настраивает интеграцию, а после смены подрядчика замените токен.
