Вручную забивать сотни счетов-фактур в кабинет Didox каждый месяц — это время и ошибки. Didox API позволяет автоматизировать процесс: электронный счёт-фактура (ЭСФ) создаётся и отправляется прямо из 1С, CRM или ERP, а статус возвращается обратно в систему.
Коротко: для интеграции с Didox нужен партнёрский токен, подключение начинается на тестовом окружении, документы подписываются через E-IMZO, а товары должны быть корректно связаны с кодами ИКПУ. Остальное — правильно спроектировать, какие документы, когда и кем отправляются.
Ниже разберём, как устроена интеграция Didox, что нужно знать про сервисы Soliq и на чём чаще всего спотыкаются. Это не налоговая консультация: требования к заполнению ЭСФ проверьте со своим бухгалтером.
ЭСФ в Узбекистане и Didox: коротко
ЭСФ — электронный счёт-фактура. В Узбекистане счета-фактуры отправляются и подписываются через операторов электронного документооборота и попадают в систему Налогового комитета. Didox — один из таких операторов: через него компании отправляют, принимают и подписывают счета-фактуры и другие документы.
Маленькой компании хватает веб-кабинета Didox. Но когда документов становится много, одни и те же данные вводятся дважды: сначала в 1С или ERP, потом в Didox. Именно здесь и нужна интеграция с Didox.
Как работает Didox API
Партнёрский токен и окружения
Согласно документации Didox API, для работы с API нужен партнёрский токен — его выдаёт аккаунт-менеджер Didox. В каждый запрос передаётся заголовок партнёрской авторизации. Для разработки есть отдельный тестовый адрес, для боевой работы — партнёрский прод-адрес. Ещё у Didox есть Telegram-канал с изменениями API — разработчику, который сопровождает интеграцию, стоит на него подписаться.
Токен пользователя и E-IMZO
Для работы от имени компании получают токен пользователя. В документации описаны три способа: по ЭЦП (ключом E-IMZO), по паролю, заданному при регистрации, и вход физлица в компанию по своему токену. Токены действуют ограниченное время, поэтому система должна вовремя их обновлять.
Создание и подписание документа
Типовой поток выглядит так:
- В учётной системе создаётся документ реализации или оказания услуг.
- Интеграция собирает из него данные для ЭСФ: ИНН контрагента, товары, коды ИКПУ, единицы измерения, НДС.
- Документ отправляется в Didox и подписывается через E-IMZO.
- Контрагент принимает или отклоняет документ, статус возвращается в учётную систему.
Ключи подписи обычно стоят на компьютере ответственного сотрудника. Поэтому в начале проекта нужно решить: подписывать автоматически на сервере или сотрудник подтверждает пакет документов одной кнопкой.
Сервисы Soliq: ИКПУ и tasnif.soliq.uz
Коды ИКПУ
Каждый товар или услуга в счёте-фактуре обозначается ИКПУ — кодом из Единого электронного каталога товаров и услуг. Каталог ведётся на платформе Налогового комитета tasnif.soliq.uz. Если код и группа не совпадают с каталогом, документ придётся исправлять.
Лучшее решение для интеграции — хранить ИКПУ в карточке каждого товара. Тогда код подставляется в ЭСФ автоматически, и менеджеру не нужно каждый раз его искать.
Про Soliq API
Запросов «soliq api» и «tasnif soliq api» много. На практике компании отправляют ЭСФ через операторов ЭДО вроде Didox, а собственные сервисы Налогового комитета используются как справочники и личный кабинет. Наличие открытых API у госсервисов и условия доступа к ним со временем меняются, поэтому в начале проекта мы сверяем текущее положение с официальными источниками.
Сценарии интеграции
1С и Didox
Самый частый случай: документ реализации создаётся в 1С, а ЭСФ автоматически уходит в Didox. Входящие счета-фактуры тоже можно загружать в 1С. Про связку 1С с другими системами — в статье Интеграция 1С с сайтом, CRM и маркетплейсами.
CRM или ERP и Didox
Если продажи ведутся в CRM или собственной ERP, счёт-фактура создаётся при закрытии сделки или отгрузке. Например, в проекте Wallner мы разработали ERP и интегрировали её со Smartup — документооборот между системами строится по той же логике. Чем ERP отличается от CRM, читайте в этой статье.
Маркетплейсы и интернет-магазин
Компаниям с большим объёмом онлайн-продаж удобно, когда заказ, склад и счёт-фактура связаны в одну цепочку. Про подключение маркетплейса — в статье Интеграция с Uzum Market.
Частые ошибки
- Устаревшие данные контрагентов: неверный ИНН или название — и документ возвращается.
- Нет кода ИКПУ или он неверный: если код не хранится в карточке товара, менеджер ищет его вручную и ошибается.
- Дубли: система не дождалась ответа и отправила документ повторно. Каждая отправка должна иметь уникальный идентификатор и записываться в журнал.
- Истёкший токен: интеграция молча останавливается. Нужны автообновление токена и уведомление об ошибке в Telegram.
- Изменения API: оператор обновил интерфейс, а интеграция осталась на старом формате. Кто-то должен следить за изменениями.
Как подготовиться к интеграции
- Определите виды документов: только исходящие счета-фактуры или ещё входящие, акты и другие документы.
- Оцените объём: сколько документов уходит в месяц и в какие дни пик. Это важно для очереди и механизма повторных попыток.
- Почистите справочник: у каждого товара и услуги должны быть ИКПУ, правильная единица измерения и ставка НДС.
- Проверьте контрагентов: ИНН, название и адрес в учётной системе должны быть актуальными.
- Выберите схему подписания: кто, каким ключом и на каком этапе подписывает.
- Протестируйте: прежде чем переходить на боевой режим, прогоните несколько типовых сценариев на тестовом окружении.
- Назначьте ответственного: заранее договоритесь, кому приходит уведомление об ошибке и кто её разбирает.
Если пройти этот список вместе с бухгалтером и ответственным за IT, интеграция пройдёт заметно быстрее и спокойнее.
Интеграция Didox в SyncLab
Мы связываем 1С, CRM, ERP и интернет-магазины с Didox: создание ЭСФ, поток подписания, возврат статусов, привязка справочника к ИКПУ и мониторинг ошибок. Работа оценивается в рамках разработки ПО на заказ, стоимость считается индивидуально. Если документооборот нужно строить вместе с новой системой, посмотрите страницу разработка CRM и ERP.
Техническую часть делаем мы, а решения по заполнению ЭСФ и налоговым правилам принимайте вместе с бухгалтером.
Частые вопросы
Что такое Didox API?
Didox API — программный интерфейс сервиса электронного документооборота Didox. Через него 1С, CRM, ERP или другая система может создавать и отправлять электронные счета-фактуры и другие документы и отслеживать их статусы, не заходя в кабинет Didox.
Как подключиться к Didox API?
По документации Didox, для работы с API нужен партнёрский токен, который выдаёт аккаунт-менеджер Didox. Разработка ведётся на тестовом окружении, потом система переключается на рабочее. Условия подключения могут меняться, поэтому уточняйте их у самого Didox.
Как подписываются документы при интеграции?
Документы подписываются электронной цифровой подписью, как правило через E-IMZO. Вход в Didox API тоже возможен по ЭЦП или по паролю, заданному при регистрации. На каком этапе и чьим ключом подписывать документы, договариваются в начале проекта.
Что такое ИКПУ и где его взять?
ИКПУ — идентификационный код товара или услуги из Единого электронного каталога. Каталог ведётся на платформе Налогового комитета tasnif.soliq.uz. Код и группа в счёте-фактуре должны совпадать с каталогом, поэтому перед интеграцией стоит привязать ИКПУ к каждому товару в вашем справочнике.
Сколько стоит интеграция с Didox?
Цена зависит от вашей учётной системы, видов документов и объёма, поэтому считается после разбора требований. По налоговым и бухгалтерским вопросам консультируйтесь со своим бухгалтером.
