Интеграция с Диадок

Диадок — система для обмена электронными документами между организациями. Электронные документы имеют такую же юридическую силу, что и бумажные с подписями руководителей. Такие документы вы можете использовать при сдаче налоговой отчётности. 

Вы можете интегрировать BILLmanager с Диадок. Это позволит подключать компании к системе Диадок, выполнять поиск контрагентов в этой системе, отправлять и подтверждать запросы на установление отношений с контрагентами. 

Клиент может получать финансовые документы из BILLmanager в личном кабинете Диадок. Для этого средствами биллинговой платформы:

1. Выполните поиск плательщика в Диадок.
2. Назначьте плательщику способ получения документов Через систему электронного документооборота:
   в левом меню перейдите Клиенты → Плательщики → выберите нужного плательщика → Изменить → поле Получать документы.

После выполнения данной настройки вы сможете выбрать для плательщика ящик организации в Диадок.

Для отправки актов выполненных работ в Диадок BILLmanager использует формат, утверждённый приказом ФНС №552.
Для отправки универсальных передаточных документов (УПД) и универсальных корректировочных документов (УКД):

• если дата создания документа 01.10.2024 или позже — используется формат, утверждённый постановлением Правительства РФ от 16.08.2024 № 1096;
• если дата создания документа 30.09.2024 или раньше — используется формат, утверждённый приказом ФНС № 155. 

Интеграция BILLmanager с Диадок состоит из трёх этапов:

1. Установка средств шифрования CSP CryptoPro (клиентское программное обеспечение). 
2. Установка ключей и сертификатов компании. 
3. Подключение компаний и клиентов. 

Установка CSP CryptoPro

Для установки CSP CryptoPro на операционные системы Unix следуйте инструкциям поставщика программного обеспечения. Процесс установки включает следующие этапы:

1. Покупка и установка лицензии на CSP CryptoPro. 
2. Установка компонентов LSB (Linux Standart Base). LSB — набор пакетов, обеспечивающий интерфейс для работы продукта в различных Unix-системах. 
3. Загрузка дистрибутива. Текущая сертифицированная версия доступна на сайте производителя. 
4. Распаковка и установка архива. Для установки используется скрипт install.sh. 
5. Установка закрытых ключей и сертификатов. 

Установка ключей и сертификатов

При подключении к системе Диадок пользователь получает закрытые ключи и сертификаты. Они используются для авторизации в сервисах компании СКБ Контур и предоставляются в виде файлов или на защищённом носителе.

Для переноса в систему семейства Unix скопируйте файлы ключей и сертификатов на внешний носитель. При этом контейнер не должен быть защищён паролем. В именах контейнеров используйте только символы латиницы.  

Установка ключей

После копирования ключей имена файлов будут иметь вид XXXXXXXX.000, где XXXXXXXX — наименование файла, сокращённое до восьми символов. 

Скопированные файлы поместите в каталог для хранения ключей каждого пользователя системы. Для учётной записи суперпользователя (root) по умолчанию используется каталог /var/opt/cprocsp/keys/root/. 

/opt/cprocsp/bin/amd64/csptest -keyset -enum_cont -verifycontext -fqcn

Команда выводит имена установленных ключей в виде \\.\HDIMAGE\xxxxxxxx. Эти имена потребуются для установки сертификатов. 

Установка сертификатов

Перед установкой разместите файлы сертификатов на сервере. Это можно сделать одним из следующих способов:

• скопировать имеющиеся файлы на сервер; 
• скачать файлы из личного кабинета КриптоПро; 
• сохранить файлы на диск средствами CSP CryptoPro. 

/opt/cprocsp/bin/amd64/certmgr -inst -file <ФАЙЛ> -cont '<КОНТЕЙНЕР>'

ФАЙЛ — полный путь до файла сертификата. 

КОНТЕЙНЕР — имя установленного ключа в виде \\.\HDIMAGE\xxxxxxxx. Обязательно помещается в одинарные кавычки. 

/opt/cprocsp/bin/amd64/certmgr -list

Если сертификат установлен корректно, то он содержит свойство PrivateKey Link : Yes. 

Если список установленных сертификатов пуст, то рекомендуем выполнить установку сертификата корневого центра СКБ Контур:

/opt/cprocsp/bin/amd64/certmgr -inst -store root -file ФАЙЛ

Подключение компаний

Подключить компанию в BILLmanager к системе Диадок можно в разделе Интеграция → Документооборот → Создать. Мастер подключения состоит из двух шагов.

Шаг 1. Выбор модуля для подключения

• Компания — компания провайдера, для которой создаётся подключение; 
• Модуль подключения — модуль работы с системой электронного документооборота; 
• Тип документов — тип документа, отправляемого через систему ЭДО; 
• Автопоиск — опция автоматического поиска плательщика в системе ЭДО. Если опция активна, то при подключении нового плательщика к компании система выполнит его поиск в системе ЭДО и отправит приглашение к обмену документами;
• Учитывать признак активности организации — опция для учёта флага активности организации в Диадок. Если отключена, то документы будут отправляться без учёта флага активности. 

Шаг 2. Параметры подключения

• Выберите тип авторизации:

1. 1. По сертификату — выберите установленный на сервере сертификат. Используется для взаимодействия с системой ЭДО и для подписи документов;
      
   2. По логину/паролю — введите данные от учётной записи в системе Диадок. Используйте при наличии неэкспортируемого ключа;
      

• Подписывать документы — активируйте опцию, чтобы автоматически подписывать документы с помощью электронной подписи и отправлять их контрагенту;
• Указывать доверенность по умолчанию — активируйте опцию, чтобы при подписании документов указывать доверенность сотрудника, которая выбрана по умолчанию на стороне Диадок;
• IP биллинга — укажите IP-адрес BILLmanager, с которого будут отправляться запросы. 

По указанному сертификату BILLmanager идентифицирует пользователя системы ЭДО и затем запускает процесс загрузки списка организаций и почтовых ящиков этого пользователя. 

Подключение клиентов

Выполнять поиск контрагентов в Диадок через BILLmanager можно двумя способами:

• поиск по компании — поиск всех контрагентов для выбранной компании; 
• поиск по плательщику — поиск конкретного контрагента по всем компаниям. 

Поиск по компании

Для поиска по компании перейдите на форму управления контрагентами: Интеграция → Документооборот → кнопка Контрагенты. 

Кнопка Клиенты запускает поиск по системе Диадок всех плательщиков, подключённых к компании с указанным ИНН. 

Кнопка Обновить запускает проверку статуса взаимоотношений компании и плательщика в системе Диадок. 

Также на форме можно управлять взаимоотношениями с контрагентами:

• кнопка Вкл. отправляет запрос на установление взаимоотношений;
• кнопка Выкл. отправляет запрос на прекращение взаимоотношений. 

Поиск по плательщику

Поиск по плательщику выполняется на форме управления плательщиками: Клиенты → Плательщики. 

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

Кнопка Подключения открывает список подключённых компаний с указанием системы ЭДО. Также через эту форму можно управлять взаимоотношениями контрагента с компаниями. 

Отправка документов

Для отправки документов в систему ЭДО необходимо, чтобы в актах выполненных работ или УПД был указан хотя бы один плательщик, подключённый к системе ЭДО. В таком случае в списке способов отправки появится пункт, позволяющий выбрать нужную систему документооборота. 

Кнопка Отправить инициирует отправку электронных документов всем плательщикам, подключённым к системе ЭДО и компании-отправителю. Для всех отправляемых документов назначается статус "Ожидает отправки" и запускается процесс их передачи в систему ЭДО.

Для контрагентов в Диадок можно отправлять документы в формате PDF. Договоры и акты выполненных работ требуют подписи контрагента. Статус отправки документа отображается рядом с основным статусом.

Отправление документов:

• чтобы отправить платёж, перейдите в Платежи → выберите платёж → Отправить → выберите способ отправки Диадок → Отправить;
• чтобы отправить договор, перейдите в Договоры → выберите договор → Отправить → выберите способ отправки Диадок → Отправить;
• чтобы отправить акт, перейдите в Акты выполненных работ → выберите акт → Отправить → выберите способ отправки Диадок → Отправить.

Проблема с отправкой документов

Если вы используете ключ ГОСТ 34.10-2001, то после 01.01.2019 г. может нарушиться отправка документов из BILLmanager в систему ЭДО. Подробнее см. в базе знаний КриптоПро.

В BILLmanager документы зависают в статусе "Ожидает отправки" и не переходят в статус "Отправлен". Чтобы обнаружить эту ошибку, подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.

В терминале введите команду:

/usr/local/mgr5/docflow/dfdiadoc --command doc_send --connection id

Если консоль выводит следующее сообщение, воспользуйтесь одним из решений, предложенных компанией КриптоПро.

CPCSP: Signing with the use of GOST R 34.10-2001 keys is not allowed from January 1st, 2019. You should move to the use of GOST R 34.10-2012 keys instead.
Continue using the GOST R 34.10-2001 key?

Аннулирование документов

Вы можете аннулировать документ, отправленный в Диадок. Для этого нажмите кнопку Финансы → Акты вып. работ → Аннулировать. После этого BILLmanager отправит запрос в ЭДО и статус документа сменится на "Запрос на аннулирование от компании". Клиент также может отправить запрос на аннулирование документа, в этом случае статус документа сменится на "Запрос на аннулирование от клиента". 

Невозможно аннулировать документы со следующими статусами:

• Предварительный; 
• Запрос на аннулирование от компании/клиента; 
• Аннулирован. 

Документ в BILLmanager примет статус "Аннулирован" после того, как запрос будет выполнен на стороне системы Диадок. 

Логирование

Лог взаимодействия BILLmanager с Диадок записывается в файл /usr/local/mgr5/var/dfdiadoc.log.

Чтобы включить отображение расширенной информации в логе, добавьте строку "dfdiadoc.* 9" в файл /usr/local/mgr5/etc/debug.conf.