API Didox: как связать электронный документооборот с учётной системой

Didox — оператор электронного документооборота, которым пользуются многие компании Узбекистана для обмена счетами-фактурами, актами, доверенностями, договорами и другими документами. Работать можно через веб-интерфейс, но при большом документообороте ручное создание документов в кабинете оператора отнимает много времени и дублирует работу в учётной системе. API позволяет передавать документы между Didox и вашими системами автоматически.

Что можно автоматизировать через API

• Создание исходящих документов на основе данных учётной системы или CRM
• Получение входящих документов от контрагентов
• Отслеживание статусов: отправлен, подписан, отклонён, аннулирован
• Получение подписанных документов для архива
• Поиск и выгрузку документов за период

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

Типовая схема интеграции

1. В учётной системе проводится реализация
2. Интеграция формирует документ в формате, который требует API
3. Документ подписывается электронной цифровой подписью
4. Документ отправляется через API
5. Интеграция периодически запрашивает статусы или получает уведомления
6. Статус отображается в учётной системе, подписанный документ сохраняется

Для входящих документов схема обратная: интеграция получает новые документы, загружает их в учётную систему и создаёт черновики документов поступления для проверки бухгалтером.

Электронная подпись

Юридически значимые документы подписываются ЭЦП. В Узбекистане для работы с ключами используется программный комплекс E-IMZO. Важный архитектурный вопрос — где происходит подписание:

• На компьютере пользователя — сотрудник подписывает документы своим ключом, интеграция лишь готовит их. Безопаснее, но требует участия человека
• На сервере — подходит для массовой отправки, но требует особенно строгой защиты ключа и регламента его использования

Выбор зависит от объёма документов, требований безопасности и внутренних правил компании. Ключ подписи руководителя — критически важный актив, и доступ к нему должен быть строго ограничен.

Сопоставление данных

Главная сложность интеграции — не вызов API, а соответствие данных:

• Контрагенты — идентифицируются по ИНН; справочник контрагентов в учётной системе должен содержать корректные ИНН
• Товары и услуги — для счетов-фактур нужны коды по классификатору и единицы измерения; их нужно заранее сопоставить с номенклатурой
• Договоры — номера и даты должны совпадать с указанными в документах
• Суммы и НДС — расчёты в учётной системе должны соответствовать требованиям к электронным документам

Перед запуском проведите ревизию справочников: большинство ошибок интеграции связаны с данными, а не с кодом.

Какие системы подключают

• 1С — самый частый случай; для популярных конфигураций существуют готовые модули обмена с операторами ЭДО, для доработанных конфигураций нужна интеграция через API
• CRM — например, для отправки договоров и актов из сделки
• Собственные системы — биллинг, ERP, складские программы

Обработка ошибок

Интеграция должна сообщать о проблемах понятно: документ не отправлен из-за неверного ИНН, истёк срок действия ключа, документ отклонён контрагентом с комментарием. Ошибки нужно показывать ответственному сотруднику в учётной системе или отправлять уведомление, а не только записывать в технический журнал. Предусмотрите повторную отправку после исправления.

Тестирование

Используйте тестовую среду, если оператор её предоставляет. Проверьте сценарии: успешная отправка, отклонение, аннулирование, исправленный документ, большой документ с множеством позиций, входящие документы с незнакомыми товарами. Только после этого переходите на рабочие документы, начиная с небольшого объёма.

Частые ошибки

• Запуск без ревизии справочников контрагентов и номенклатуры
• Хранение ключей подписи в незащищённом месте
• Параллельное создание документов вручную в кабинете и через интеграцию — появляются дубли
• Отсутствие контроля статусов

Если нужно связать Didox с вашей 1С, CRM или другой системой, напишите — оценим интеграцию и подготовим план работ.