Интеграция с платформой ПТАХ

Модуль предоставляет возможность обмена документами, пописанными цифровой подписью, между системой FossDoc и другими программными комплексами (например, M.E.Doc), которые поддерживают интеграцию с платформой "ПТАХ".

Подключение и настройка модуля

Администратору системы FossDoc необходимо подключить модуль "Интеграция с ПТАХ".

На машине, где установлен сервер FossDoc, установите ПТАХ (актуальную версию инсталляции получите у разработчика ПТАХ), имя файла инсталляции APIPtah_.exe

Также вам будет нужна лицензия для ПТАХ (в простом случае - это одна лицензия для пользователя, от имени которого фактически будут отправляться документы). Лицензия сохраняется в виде текстового файла с именем "123456789.txt" (идентификационный код). Добавьте лицензию ПТАХ с помощью программы настройки "C:\Program Files\APIPtah\APIPtah1\EdiCfg.exe".

Сертификаты цифровой подписи и шифрования

Для работы с ПТАХ необходимы сертификаты цифровой подписи и шифрования. Например, если вы используете поставщика АЦСК "Украина", ваш набор файлов будет:

В свойствах публичного сертификата, в разделе "Использование ключа" можно увидеть, что сертификат подписи имеет значение "Цифровая подпись", а сертификат шифрования - "Соглашение о ключах", это поможет вам их различать.

Приватный сертификат, который содержит в имени файла текст "DS", используется для цифровой подписи.

Приведенные выше имена файлов и описание могут измениться, уточняйте детали у поставщика.

После подключения модуля и перезапуски программы администрирования FossDoc выберите подразделение, которое будет отправлять документы, и настройте его: выберите необходимые сертификаты, заполните код и URL сервиса. На рисунке ниже URL задан в виде localhost, т.к. APIPtah установлен на той же машине, что и сервер FossDoc.

Настройка интеграции ПТАХ на подразделении

Шаблон подразделения должен быть "Главное подразделение". Создайте пользователя с ролью "Сотрудник канцелярии" (регистратора), если он еще не создан в данном подразделении.

Папка "Утверждённые документы ПТАХ" будет создана автоматически для новых подразделений. Если ваше подразделение было создано раньше, обновите его по шаблону.

Пользователю-регистратору добавьте эту папку через вкладку "Роль" (установите галочку).

Подключение интеграции ПТАХ к типу документа

Допустим, вы создали собственный тип документа "Договор" и желаете отправлять его через "ПТАХ" вашим контрагентам. Чтобы это реализовать, добавьте ему функцию "API ПТАХ" и стандартное поле "Корреспондент" из библиотеки "Документооборот".

Поле "Корреспондент" (контрагент) будет использоваться для определения получателя документа. Справочная запись должна содержэать заполненное поле "Идентификационный код".

На панели команд типа документа нажмите кнопку "ПТАХ настройки" и активируйте возможность отправлять документы данного типа:

Настройка типа документа для интеграции с ПТАХ

На рисунке ниже приведен простой вариант - использование режима "Универсальный документ". Если необходимо, чтобы кроме файлов-вложений контрагенту был передан сформированный (по правилам ПТАХ) pdf-шаблон, вы должны это настроить отдельно.

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

После подключения и настройки в документе появится вкладка, с помощью которой можно будет отправить документ:

Отправка документа через ПТАХ

Документ и его вложенные файлы подписываются ЭЦП и передаются контрагенту.