Page tree
Skip to end of metadata
Go to start of metadata

Подписание и отправка документов

При отправке документов необходим сам отправляемый документ(электронный документ, к примеру УПД в формате .xml) на который дополнительно формируется файл описания (.xml формат смотрите ниже на странице), содержащий указания для АРМ о том, где находится отправляемый документ и некоторую другую информацию, позволяющую АРМ выполнить подписание и отправку документа.

Последовательность при отправке: 

  1. Внутренняя ИС (далее просто ИС), например, 1С или SAP формируем отправляемый документ, сохраняет его. 
  2. Далее ИС создаёт файл описания (пример XML- файла описания можно найти здесь) с расширением .CF1 в папке указанной в настройках АРМ ("Настройки\Папки обмена\Папка для мониторинга файлов описания .CF1"), указав в файле описания, среди прочего, путь по которому был сохранён отправляемый документ.
  3. АРМ проверяет наличие новых файлов описаний (в указанной выше папке).
  4. При обнаружении новых файлов  описания к полному имени обнаруженного файла описания добавляется расширение .work (файл в процессе обработки)
  5. После окончания обработки (АРМ выполнил проверку, подписание и отправку документов указанных в файле описания) к изначальному имени файла описания добавляется .ok (в итоге будет *.CF1.ok)
  6. ИС периодически проверяет наличие ответных файлов (*.CF1.ok) от АРМ и анализировать результаты (атрибуты resultcode и resultmsg) для каждой записи в файле описания. И по необходимости реагировать
  7. Если сам файл описания некорректен, например, нет описания важных полей, файл описания переименовывается так, что к имени файла добавляется .err (*.CF1.err)


Получение документов.

АРМ выполняет периодический опрос сервера оператора ЭДО на наличие новых документов и при их наличии получает с сервера документы, электронные подписи, производит расшифровку документов (XML, произвольные документы), проверку ЭП и сохраняет файл описания принятых файлов в папку обмена, 
расширение файла: .CF2.

Обработка файлов описания в информационной системе организации.

Необходимо выполнять периодическую проверку наличия новых файлов CF2 в папке обмена.
При обработке файлов CF2 необходимо:
1) Прочитать необходимые для ИС атрибуты из файла CF2: id_author, id_recipient, filename, filesize, file_guid, file_address, file_address_sig, primedoctype, parent_type, parent_guid
2) Обработать файл, по пути указанному в атрибуте file_address: выполнить сохранение файла в базе данных или перенос файл в файловое хранилище
3) Проверить наличие подписи по заполненному атрибуту file_address_sig,
выполнить сохранение файла подписи в базу или перенос файла подписи в файловое хранилище.

4) Если атрибут file_address_sig не заполнен, файл подписи может быть получен позже, отдельным файлом CF2. Это зависит от типа документооборота.
При поступлении файла подписи отдельно: необходимо найти по parent_guid исходный документ, к которому относится файл подписи и выполнить привязку подписи к документу в базе ИС.
5) После успешной обработки файла CF2 - файл можно удалить или перенести во временное хранилище ИС.


Описание формата xml-файлов описания с расширением CF1\CF2.

В таблице символом "+" отмечены обязательные к заполнению атрибуты .

Пример XML- файла описания можно найти здесь





Обязательно к заполнению
 Атрибут Описание Примечание Тип ТОРГ12 АКТСчФ\  УПД\ УКДПроизвольные документы
(doc\pdf\jpg)
 id_authorидентификатор отправителя
(первые 3 символа: идентификатор Оператора)
должен совпадать с идентификатором пользователя, зарегистрированным в ЭДОstring [4-46]




+

 id_recipientидентификатор получателя
(первые 3 символа: идентификатор Оператора)
проверяется АРМ-ом по справочнику пользователейstring [4-46]




+

 primedoctypeтип первичного документадопустимые типы перечислены в таблице 
можно не заполнять для формализированных документов
integer




+

 file_addressполный путь к файлувозможно использование и сетевого расположенияstring [4-250]

+

+

+

+

file_address_cerполный путь к файлу с сертификатомесли заполнено, АРМ выполняет сохранение сертификата в указанный файл, применимо только для CF1 -файлов. 




 file_address_sigполный путь к файлу с электронной подписью 

необходимы права на запись,
файл не должен существовать. 
Файл
 создается в АРМ или получается с сервера.

string[255]



 id_doctypeтип документа по Приказу Министерства культуры РФ от 25 августа 2010 г. N 558 [0..1003]
можно не заполнять для формализированных документов
integer



 file_nameимя файла для отображения в ИС, может не совпадать с именем в file_addressимя файла должно соответствовать требованиям string [1-250]


+

 file_guidуникальный идентификатор связанного файла в ИС, формируется на стороне клиента36 символов, 
подробнее
string [36]


+

 file_sha1

160-битный хеш по алгоритму sha-1, заполняется АРМ-ом

если уже заполнено - будет выполнена проверкаstring [0,40]



 file_sizeразмер файла в байтах, заполняется АРМ-омесли уже заполнено - будет выполнена проверкаinteger











 parent_typeтип документа-родителя 
(primedoctype -родителя)

для связывания документов по принадлежности и подчинению

integer

+ *

+ *

+ *

+

 parent_guidуникальный идентификатор документа-родителя в ИСидентификатор, с которым связывается file_guid для возможности ЭДОstring [0,36]

+ *

+ *

+ *

+

 use_cryptиспользовать шифрование файлас использованием сертификатов автора и получателяinteger



 use_sigиспользовать подписание файлаподписание по умолчаниюinteger



 use_zipиспользовать сжатие документаустаревший атрибутinteger











 resultmsgтекстовый результат выполнения операцийвнешняя ИС должна проверить статус для указанного файла после обработки файла описания АРМ-ом. string [0..5000]



 resultcodeчисловой код результата выполнения операцийвнешняя ИС должна проверить статус для указанного файла после обработки файла описанияinteger



 dt_sendдата и время отправки на сервер (UTC)Внимание: заполняется автоматически в АРМ

dateTime(ISO 8601)





 doc_date дата документа для передачи данных между ИС о документах (PDF\XLS) date


 + *
 doc_number номер документа для передачи данных между ИС о документах (PDF\XLS) string [0,50]


 + *
 doc_sum сумма документа для передачи данных между ИС о документах (PDF\XLS), разделитель: точка, пример: 123.45 = 123 рубля 45 копеек string [0,20]


 + *
thumbprintотпечаток сертификата, которым следует проводить подписание,  40 символовИспользуется при необходимости подписания документов подписантами не связанными один к одному с идентификатор отправителя (id_author)string 40




Тип документа (primedoctype) - используется для предварительной идентификации документов в ИС и АРМ без чтения самого документа (XML) или 
при невозможности автоматически определить тип документа (сканы документов)

Перечень типов документов (primedoctype) доступен по ссылке.

  • No labels