Интеграционное решение по True API — это связка вашей системы с ГИС МТ для обмена данными о маркировке

Что значит интеграционное решение по True API

«Интеграционное решение по True API» — это не отдельная программа, а настроенная связка между учётной системой, сервисом или внутренним приложением и ГИС МТ. Она определяет, какие данные система получает, как формирует запрос, как проходит авторизация, куда записывается ответ и что делает сотрудник при ошибке.

Есть два базовых направления обмена: предоставление сведений, при котором данные могут менять реестры ГИС МТ, и запрос сведений, при котором система получает данные из реестров без внесения изменений. Через API можно, например, автоматизировать проверку статуса КИ, если соответствующий метод доступен для роли и сценария.

Как работает обмен через API

Работа интеграции обычно включает несколько этапов: система получает задачу, собирает данные в требуемом формате, проходит аутентификацию и авторизацию, передаёт запрос в ГИС МТ, разбирает ответ и сохраняет результат или ошибку.

При спорном результате система может передать операцию сотруднику на проверку. Это рекомендуемый порядок проектирования, а не утверждение о встроенном поведении любого продукта. Перед разработкой нужно сопоставить бизнес-процесс с конкретным методом True API и ролями доступа.

Что нужно для подключения

Для работы нужен личный кабинет ГИС МТ с подключённой товарной группой, по которой планируется передача сведений. Доступ к методам определяется ролевой моделью. Документация указывает на применение УКЭП; при автоматическом создании или проверке подписей должны быть определены ответственные лица.

В зависимости от операции применяются JSON, CSV или XML. Для JSON требуется кодировка UTF-8 и соответствие правилам конкретного метода, для XML используются XSD-схемы. Максимальный размер документа по API — 30 МБ, а число кодов маркировки в одном загружаемом документе — не более 30 000.

Ограничения и типичные риски

При проектировании учитывайте ограничение в 50 запросов в секунду от одного участника оборота товаров. Документация также описывает демонстрационный и промышленный контуры для версий v3 и v4; конкретную версию и срок поддержки нужно проверять для используемого метода.

Методы могут возвращать JSON, ZIP или двоичное содержимое, поэтому заголовок Accept должен учитывать ожидаемые типы ответа. Ошибки могут иметь JSON- или XML-представление. Важны также кодировка и экранирование параметров для URL, JSON, CSV и XML.

Наличие API само по себе не означает готовую совместимость CRM или ERP с нужным обменом.

Как проверить результат на практике

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

1. Подготовьте тестовые данные с известным ожидаемым результатом.
2. Получите пару UUID и data через метод авторизации, подпишите данные УКЭП и запросите токен предусмотренным способом.
3. Отправьте один корректный запрос с нужными заголовками и форматом.
4. Сверьте HTTP-код, тело ответа, идентификаторы и запись в своей системе.
5. Проверьте пропущенный обязательный параметр, неверный формат и ошибку доступа.
6. Убедитесь, что ошибка попадает в журнал, а повторная попытка не создаёт нежелательный дубль.

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

Если нужна разработка интеграции

Paramiko предлагает разработку интеграционных решений и автоматизации под конкретный процесс. Рабочий подход: выбрать один поток, описать входные данные и ожидаемый результат, согласовать доступы, действия человека и обработку ошибок, затем проверить ограниченный пилот на примерах заказчика.

Это предложение метода работы, а не утверждение о готовом коннекторе, подтверждённом кейсе, сроках или гарантированном результате. На старте потребуется уточнить учётную систему, товарную группу, нужные операции True API и правила участия сотрудника.

Итог и рабочее определение

Интеграционное решение по True API — это автоматизированный обмен между вашей системой и ГИС МТ с учётом авторизации, форматов документов, ролей, лимитов и обработки ошибок. Чтобы понять, готова ли конкретная схема к запуску, опишите один процесс, проверьте его на тестовых данных и зафиксируйте критерии успешного ответа до перехода в промышленный контур.