Ошибка 502 в ГИС МТ — это техническая ошибка обмена, а не ошибка конкретного кода маркировки. Она не означает, что товар поддельный, код маркировки неверный или УПД заполнен неправильно. Чаще всего ошибка 502 появляется, когда сервис, шлюз, прокси, кассовое ПО, оператор ЭДО или другая промежуточная система не получила корректный ответ от ГИС МТ или связанного сервиса.
Проще говоря, запрос был отправлен, но нормальный ответ от системы не вернулся.
Что означает ошибка 502
Код 502 относится к серверным HTTP-ошибкам. В контексте маркировки это значит, что обмен с ГИС МТ временно нарушен: система или промежуточный шлюз не смогли корректно обработать запрос.
Такую ошибку можно увидеть:
- при отправке документов в ГИС МТ;
- при обмене через API;
- при работе личного кабинета;
- при отправке УПД из учетной системы;
- при проверке маркировки на кассе;
- при работе кассового ПО, ОФД, ЭДО или интеграционного модуля.
Если в журнале указано «ГИС МТ ошибка 502», сначала нужно проверять не коды маркировки, а техническую сторону обмена.
Ошибка отправки в ГИС МТ 502: основные причины
- Временная недоступность ГИС МТ.
Сервис может быть недоступен из-за технических работ, аварийного сбоя или высокой нагрузки. - Сбой промежуточного шлюза.
Запрос может проходить через прокси, балансировщик, CDN, оператора ЭДО, ОФД, кассовый модуль или интеграционную платформу. Если один из этих элементов не отвечает корректно, появляется 502. - Проблемы с интернетом или корпоративной сетью.
Ошибка может быть связана с DNS, VPN, firewall, прокси-сервером или нестабильным подключением. - Таймаут при обработке запроса.
Система не успевает получить ответ за допустимое время, особенно при массовой отправке документов или проверок. - Сбой в учетной системе или кассовом ПО.
Иногда проблема не в ГИС МТ, а в модуле обмена, который некорректно обрабатывает ответ сервиса. - Слишком частые повторные запросы.
Если интеграция автоматически отправляет один и тот же документ много раз подряд, это может усилить проблему и создать риск дублей.
Как исправить ошибку 502
Сначала не нужно менять УПД, коды маркировки или карточки товаров. Ошибка 502 обычно не связана с содержанием документа.
Порядок действий:
- Подождать и повторить запрос позже.
- Проверить интернет-соединение, DNS, VPN, прокси и firewall.
- Уточнить, возникает ли ошибка только у одного пользователя или у всех.
- Проверить, не ведутся ли технические работы или нет ли массовой недоступности сервиса.
- Если ошибка появилась в учетной системе, проверить журнал обмена и ответ сервера.
- Если ошибка возникла на кассе, проверить кассовое ПО, ОФД, локальный модуль и доступ к сервисам проверки.
- Не отправлять один и тот же документ много раз подряд.
- После восстановления связи проверить статус документа: он мог быть принят в ГИС МТ, даже если пользователь увидел ошибку на своей стороне.
Что сохранить для поддержки
Если ошибка повторяется, лучше сразу подготовить технические данные:
- дату и время ошибки;
- ИНН организации;
- номер документа или чека;
- endpoint или метод API, если используется интеграция;
- текст ошибки полностью;
- HTTP-код 502;
- лог запроса и ответа;
- сведения о кассовом ПО, ОФД, операторе ЭДО или учетной системе.
Эти данные помогут быстрее понять, где именно возник сбой: на стороне ГИС МТ, сети, оператора, кассы или интеграционного модуля.
Решение других ошибок в «Честном знаке» подробно рассмотрели в статье "Ошибки в «Честном знаке»: что делать, если система не принимает код или документ"
Вывод
Ошибка 502 в ГИС МТ означает временный сбой при обмене с системой маркировки или промежуточным сервисом. Чаще всего причина связана с недоступностью ГИС МТ, сетевой проблемой, ошибкой шлюза, кассового ПО, ОФД, ЭДО или API-интеграции.
Если появилась ошибка отправки в ГИС МТ 502, сначала нужно проверить связь и статус обмена, не создавать дубли документов и повторить операцию после восстановления доступа. Если ошибка повторяется, следует сохранить логи и обратиться в техническую поддержку.
