· Из практики автора
За кнопкой «загрузить XML» — чужое рабочее время
Когда в системе что-то перестаёт работать, со стороны решение иногда кажется простым: «Ну заполните вручную».
Можно. Вопрос — сколько времени это займёт и кто за него заплатит.
Если в декларации несколько товаров, ручное заполнение ещё можно пережить. Если их сотни, а сертификаты относятся к разным товарам и диапазонам, это совсем другая работа. Нужно перенести номера, даты, сроки действия, страны документов и правильно связать всё с товарами.
На это может уйти полдня, иногда больше. И чем больше повторяющихся действий, тем выше риск опечатки, пропущенной записи или неправильной привязки.
А за декларацией стоит не только человек перед монитором. Там груз, транспорт, склад, клиент и сроки. Машины не начинают ехать от объяснения, почему внешняя система сегодня не ответила. Техническая задержка может превратиться в простой и дополнительные расходы бизнеса.
Что произошло
Коллеги столкнулись с тем, что XML деклараций с КЗ-сертификатами не загружались в KEDEN. Проверили исходный файл с заполненными сертификатами: загрузка не прошла. После исключения этих записей XML загружался.
Отдельно проверили сверку сертификата через интеграцию КТРМ. В одном из тестов запрос ожидал ответ около 30 секунд, после чего KEDEN возвращал HTTP 400 и техническую ошибку. Соседние запросы при этом отвечали значительно быстрее.
2 ноября повторная проверка того же сертификата через интерфейс KEDEN снова завершилась сообщением «Техническая ошибка. Обратитесь в службу поддержки». Это результат конкретной проверки, а не утверждение, что весь портал или каждый сертификат работает одинаково.
Вечером 2 ноября ещё раз запустили загрузку исходного XML. На момент подготовки публикации она оставалась в ожидании, окончательного результата ещё не было. Не смешиваем этот незавершённый повторный тест с предыдущим неуспешным импортом.
Сообщения коллег и наши тесты помогли локализовать проблемный сценарий. Но по внешним наблюдениям нельзя установить все внутренние причины или распределить ответственность между KEDEN и реестром. Для этого нужны их собственные журналы и диагностика.
Почему «это внешний реестр» не решает проблему пользователя
Интеграции могут временно не работать. Внешняя система может уйти на обслуживание, отвечать медленно или возвращать ошибку. Это нормальный риск любой интеграции, который нужно учитывать при проектировании.
Недоступность реестра и недействительность документа — разные ситуации.
Если реестр не ответил, это ещё не означает, что сертификат неправильный. Это означает, что сейчас не удалось выполнить сверку.
Для такой ситуации нужен предусмотренный рабочий сценарий: сохранить введённые сведения, понятно показать статус проверки и, где это допускают обязательные требования, повторить запрос позже. Сверку можно организовать асинхронно, не заставляя пользователя всё время ждать у заблокированной формы.
Если продолжение действительно запрещено правилами процесса, система должна ясно объяснять ограничение и дальнейшие действия. Фраза «техническая ошибка» не даёт понимания, что исправлять: номер документа, файл, интернет или вообще ничего.
Я не знаю всех внутренних ограничений KEDEN и не буду рассказывать, что исправление обязательно занимает «две строчки». Но последствия отсутствующего или неработающего резервного сценария видны: дополнительная ручная работа ложится на декларантов.
Что сделали мы
Вместо повторного ручного ввода сделали отдельный временный помощник для КЗ-сертификатов. Он разделяет работу на два этапа, между которыми вы загружаете подготовленный XML в KEDEN.
- Вы выбираете исходный XML с сертификатами.
- Помощник подготавливает два файла: XML без выбранных КЗ-сертификатов и Excel с их реквизитами и привязками к товарам.
- Новый XML загружаете в KEDEN и открываете созданный черновик.
- Возвращаетесь в помощник, выбираете Excel и проверяете привязки.
- Помощник добавляет записи сертификатов в графу 44 по соответствующим товарам.
Это не подмена сертификатов и не подтверждение их действительности. Мы разделили загрузку декларации и последующее внесение реквизитов на отдельные операции.
Обрабатываются только записи с кодами 01401, 01402 и 01403, у которых в исходном XML явно указана страна документа KZ. Другие записи остаются в XML. Исходный файл не перезаписывается.
PDF-файлы сертификатов затем прикрепляются отдельно обычным KEDEN44. Соответствие документов товарам и итоговую декларацию перед подачей, как и прежде, проверяет декларант.
Если работа прервалась
Не нужно сразу начинать всё заново или удалять уже добавленные документы. Откройте тот же черновик, вернитесь в помощник и снова нажмите «Проверить привязки».
Полностью совпадающие записи, уже существующие у всех нужных товаров, будут учтены и пропущены при добавлении. Оставшиеся можно попробовать добавить после успешной проверки.
Если обнаружено расхождение реквизитов или документ связан только с частью нужных товаров, помощник останавливается. Такой конфликт нельзя исправлять бесконечными нажатиями: сначала нужно разобраться с конкретной записью.
Подготовили подробную инструкцию со скриншотами. Начали буквально со значка пазла в браузере: не все обязаны знать, где находятся расширения. Отдельно показали обязательный переход в сам KEDEN для загрузки XML и последующее возвращение в помощник с Excel.
Где обрабатываются документы
XML и Excel обрабатываются на вашем компьютере, в браузере. На сервер KEDEN44 эти файлы не загружаются.
После вашего подтверждения реквизиты направляются непосредственно в KEDEN через действующий вход в систему. Пароли, ключи ЭЦП и токены сессии на наш сервер не передаются. Помощник не подписывает и не подаёт декларацию.
Почему бесплатно до 15 ноября
До 15 ноября 2026 года включительно помощник доступен бесплатно всем. Хочется, чтобы коллеги могли продолжать работу сейчас, пока решается проблема со штатной загрузкой.
Рассчитываем, что за это время загрузка XML с КЗ-сертификатами будет восстановлена. Обещать сроки за разработчиков KEDEN мы, конечно, не можем.
Дальше план такой: если инструмент останется нужен, с 16 ноября доступ к нему будет входить в подписку KEDEN44 без отдельной платы. Для этого потребуется обновление с проверкой подписки. Текущая временная сборка после 15 ноября прекращает операции; автоматически в подписочную версию она не превращается.
Возможно, к тому моменту помощник вообще больше не понадобится. И это будет лучший результат: штатная загрузка снова работает, дополнительные действия больше не нужны.
Бесплатно для коллег — не значит без затрат
По отзывам коллег, помощник уже выручает в работе. Это приятно: значит, потраченное время превратилось в конкретную пользу.
Обратная связь бывает разная. Кто-то пишет «спасибо, получилось», кто-то спрашивает, как открыть расширение, а кто-то сразу уточняет: «А почему бесплатно только до 15-го?»
Вопрос нормальный. Ответ тоже простой: разработка, тестирование, инструкции и поддержка требуют времени — даже когда инструмент временный.
Я сам работаю с декларациями. Такие решения появляются из знакомой рабочей ситуации: нужно оформить документы, а вместо этого приходится бороться с повторяющимися действиями и техническими сбоями. Сначала делаешь инструмент для себя, потом понимаешь, что он может помочь и коллегам.
На момент подготовки этого поста донатов — добровольных пожертвований на развитие проекта — за помощник ещё не поступало. Возможно, завтра появятся. Поддержка полностью добровольная: в бесплатный период пользоваться можно независимо от пожертвований.
Если помощник сэкономил вам часы ручной работы, можно направить небольшую сумму на развитие. Это помогает покрывать расходы на инфраструктуру и выделять время на исправления, инструкции и новые инструменты. Условия и выбранный способ поддержки на Boosty проверяйте перед оплатой: подписка там может продлеваться автоматически.
Если инструмент экономит чужие часы, труд на его создание тоже имеет ценность. Ваше рабочее время хочется беречь. Своё — тоже нужно ценить.
А с отзывами пока скромно
Иногда хочется сделать проверку: отзыв не оставил — доступ закрыт, деньги возвращаем. Шутка, конечно. Отзывы добровольные и на доступ не влияют.
Но если основное расширение KEDEN44 помогает вам в работе, найдите пару минут и расскажите о своём опыте. Что используете, что стало удобнее, сколько времени удалось сэкономить и что стоит улучшить.
Нужна не обязательная похвала, а живой и конкретный опыт. Для небольшого проекта это ощутимая поддержка, а для новых пользователей — возможность понять, нужен ли им такой инструмент.
Поделиться опытом и оставить отзыв о KEDEN44
Даже временное решение остаётся частью истории
Эта история уже зафиксирована: обращения коллег, результаты проверок, ошибки и работающий альтернативный сценарий. Без публикации чужой переписки и персональных данных.
Не ради поиска виноватого. Ради понимания того, как техническая проблема превращается в реальные затраты людей — и сколько дополнительных действий приходится придумывать вокруг обычной загрузки документов.
Для меня это ещё и дневник разработки: увидел проблему в собственной работе, проверил гипотезу, сделал инструмент, получил обратную связь и доработал инструкцию. Такие истории показывают продукт лучше, чем обещания на главной странице.
Возможно, через некоторое время мы спокойно удалим помощник за ненадобностью. Но останется пример того, почему фраза «можно заполнить вручную» не всегда является приемлемым решением.
Иногда за ней стоят сотни записей, полдня работы и ошибки, которых можно было избежать.
Скачать помощник и открыть пошаговую инструкцию
Вопросы и ошибки — в поддержку KEDEN44. По конкретному сообщению и скриншоту разобраться гораздо проще, чем по одному слову «не работает».
P. S. Небольшая явка с повинной от ИИ-помощника
Этот текст тоже помогает готовить ИИ. То есть я. Код пишу, инструкции составляю, посты помогаю выкладывать — и тоже косячу.
Иногда могу подробно объяснить сложный механизм, но пропустить простой вопрос: «Если документ один, зачем ты вообще что-то сопоставляешь?» Или написать инструкцию так, будто читатель уже знает, где расширение, какой файл выбрать и куда потом вернуться.
Поэтому за красивым словом «автоматизация» здесь стоит ещё человек, который проверяет результат и регулярно напоминает мне: «Я же просил». После чего мы делаем не просто убедительное объяснение, а работающую вещь.
Так что волшебной кнопки «ИИ, сделай всё нормально» пока нет. Есть опыт автора, мои возможности и несколько раундов «проверь ещё раз». Иногда довольно эмоциональных.