Почему запрос в партнёрскую программу ритейла дважды падал с ошибкой 500 и как мы её исправили
В течение двух дней команда столкнулась с тем, что заявка в партнёрскую сеть крупного ритейла отклонялась ошибкой 500. Техническая «тёмная зона» сервера оказалась причиной проблем, а не очевидные ошибки ввода. Мы выяснили, что виноваты были файлы‑приложения, и нашли простое решение, которое сэкономило часы переписки.
Первый отказ: ограничение на символы в поле «сфера деятельности»
23 октября в 15:23 по МСК первая попытка была отклонена с кодом 400. В поле «сфера деятельности» мы указали «Курьерский парк: подключение и сопровождение курьеров», а система запретила двоеточие. После замены его на запятую («Курьерский парк, подключение и сопровождение курьеров») запрос прошёл без проблем. Это типичный пример, когда валидация формы даёт понятный ответ.
Внутренние ошибки сервера: два отказа с кодом 500
Следующие две попытки (15:24 и 15:27 по МСК) завершились одинаковой ошибкой 500. Форма приняла все поля, но на этапе отправки сервер партнёрки «упал» без пояснения. Мы проверили телефон, район и текст анкеты — всё совпадало с первой успешной заявкой. Оставалось лишь предположить, что проблема кроется в приложенных файлах.
Какие файлы отправлялись
В заявке были четыре вложения: анкета контрагента, анкета квалификации, PDF‑подпись и выписка ЕГРИП. Два первых документа представляли собой файлы xlsx, сгенерированные скриптом на основе библиотеки openpyxl. Формат открывался без ошибок в Excel и Google Таблицах, но сервер партнёрки использовал собственный парсер, который оказался более строгим.
Как мы решили проблему: пере‑сохранение файлов в оригинальном редакторе
24 октября в 11:19 по МСК мы открыли оба xlsx‑файла в настольном Excel, сохранили их заново (без изменения содержимого) и отправили заявку без выписки ЕГРИП. На этот раз сервер ответил кодом 201: «Письмо отправлено успешно». Пересохранение изменило внутреннюю структуру файла так, что парсер партнёрки смог его обработать.
Почему это работает
Библиотеки‑генераторы часто создают файлы, соответствующие спецификации, но не учитывают «придирчивые» детали, которые внедряют производители офисных пакетов (например, скрытые метаданные, порядок XML‑элементов). Обычный пользователь не замечает разницы, а автоматический парсер может её воспринимать как ошибку.
Выводы и рекомендации для всех, кто работает с чужими формами
Если внешний сервис возвращает «голый» код 500 без текста ошибки, скорее всего проблема находится вне видимых полей формы. Прежде чем менять содержание анкеты или звонить в поддержку, проверьте вложения: откройте их в оригинальном приложении (Excel для xlsx, Word для docx), пересохраните и попробуйте снова. Это займет считанные минуты, но может избавить от дней переписки.
Сейчас мы ждём звонка менеджера ритейлера, чтобы уточнить дальнейшие шаги по подключению.