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

Для взаимодействия с АРМ используются XML-файлы, содержащие описание передаваемых документов (расположение и типы документов).

Внутренняя ИС, например, 1С должна сформировать отправляемый документ и создать файл описания с расширением .CF1 в папке указанной на странице "Настройки\Папки обмена\". 
АРМ проверяет наличие новых файлов описаний, выполняет проверку и отправку документов. 
При обработке файла описания к полному имени файла добавляется расширение .work, 
после завершения обработки расширение меняется на .OK. 
ИС должна периодически проверять наличие ответных файлов (*.CF1.ok) от АРМ и анализировать результаты (атрибуты resultcode и resultmsg) для каждой записи в файле описания.

Если файл описания некорректен, например, нет описания важных полей, файл описания переименовывается, к имени файла добавляется.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.

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

 Атрибут Описание Примечание Тип ТОРГ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_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]


 + *


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

 primedoctype Тип документа Требование к имени файла (file_name)
 1 Счет-фактура - до 01.07.2017 ON_SFAKT_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 2 Корректировочный счет-фактура - до 01.07.2017 ON_KORSFAKT_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 3 Исправленный счет-фактура - до 01.07.2017 ON_SFAKT_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 4 Исправленный корректировочный счет-фактура - до 01.07.2017 ON_KORSFAKT_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 10 Подтверждение от оператора о дате отправки DP_PDOTPR_IdRecipient_2hx_YYYYMMDD_GUID.xml
 11 Подтверждение от оператора о дате получения DP_PDPOL_IdRecipient_2hx_YYYYMMDD_GUID.xml
 30 АКТ (Титул исполнителя) - до 01.07.2017 DP_IAKTPRM_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 31 АКТ (Титул заказчика) - до 01.07.2017 DP_ZAKTPRM_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 32 АКТ (В подписи отказано) DP_UVUTOCH_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml



 50 ТОРГ12 (титул продавца) - до 01.07.2017 DP_OTORG12_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 51 ТОРГ12 (титул покупателя) - до 01.07.2017 DP_PTORG12_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 52 ТОРГ12 (В подписи отказано)

 DP_UVUTOCH_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml




 70 Уведомление об уточнении к документу DP_UVUTOCH_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 71 Предложение об аннулировании (в роуминге) DP_PRANNUL_IdRecipient_IdAuthor.xml
 80

 Произвольный тип документа (doc\xls\pdf) или  
 Извещение о получении

  • имя документа.расширение
  • DP_IZVPOL_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 81 Подпись под файлом, расширение: (.sig\.p7s\.sgn) имя документа или UUID.расширение
 Заполняется только АРМ-ом, тип файла используется в роуминге
 82 Извещение о получении DP_IZVPOL_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 83 Приглашение к обмену. Используется в роуминге GUID.ZIP
 84 Запрос на разрыв обмена. Используется в роуминге GUID.ZIP
 90 Уведомление о принятии документа (УОП) – электронная подпись Получателя в формате CMS, фиксирующая факт принятия (согласия с условиями) полученного электронного документа. GUID, АРМ не отправляет исходный документ, а только созданную подпись


 Форматы добавленные в АРМ в 2017г.



 ПРИКАЗ от 13 апреля 2016 г. N ММВ-7-15/189@
 25 УКД (КСЧФ). Корректировочный счёт-фактура.Продавец ON_KORSCHFDOPPR_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 26 УКД(КСЧФДИС) Продавец ON_KORSCHFDOPPR_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 27 УКД(КСЧФДИС) Покупатель ON_KORSCHFDOPPOK_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 28 УКД(ДИС) Продавец ON_KORSCHFDOPPR _IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 29 УКД(ДИС) Покупатель ON_KORSCHFDOPPOK_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml




  ПРИКАЗ от 24 марта 2016 г. N ММВ-7-15/155@


 20 УПД(СЧФ) Счёт-фактура. Продавец ON_SCHFDOPPR_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 21 УПД(СЧФДОП) Продавец ON_SCHFDOPPR_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 22 УПД(СЧФДОП) Покупатель ON_SCHFDOPPOK_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 23 УПД(ДОП) Продавец ON_SCHFDOPPR_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 24 УПД(ДОП) Покупатель ON_SCHFDOPPOK_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml




Приказ ФНС России от 30.11.2015 N ММВ-7-10/552@
 33 АКТ. Файл обмена Исполнителя  DP_REZRUISP_Id(Заказчика)_Id(Исполнителя)_YYYYMMDD_GUID.xml
 34 АКТ. Файл обмена Заказчика DP_REZRUZAK_Id(Исполнителя)_Id(Заказчика)_YYYYMMDD_GUID.xml




  ПРИКАЗ от 30 ноября 2015 г. N ММВ-7-10/551@
 58* Товарная накладная. Продавец. Формат в дальнейшем будет заменен на УПД DP_TOVTORGPR_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml
 59* Товарная накладная. Покупатель. Формат в дальнейшем будет заменен на УПД DP_TOVTORGPOK_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml




 Для обмена в Роуминге
 91 Заказ
 92 Договор
 93 Платежное поручение
 94 АктСверки
 95 Акт
 96 ТТН 
 97 ТН
 98 СтруктурированныеДанные
 99 ОтказПодписи
 100 КС-11
 101 КС-2
 102 КС-3
 103 Ведомость
 104 ДокументОПередачеРезультатовРаботИсполнитель  
 Рекомендуется использовать формат УПД
  ПРИКАЗ от 30 ноября 2015 г. N ММВ-7-10/552@
 105 ДокументОПередачеРезультатовРаботЗаказчик
 Рекомендуется использовать формат УПД
  ПРИКАЗ от 30 ноября 2015 г. N ММВ-7-10/552@





Примечания:
* - уточните у Оператора и получателя возможность использования данного формата.

IdAuthor и IdRecipient - идентификаторы участников ЭДО, состоящие из 3х символов кода оператора ЭДО и до 43 символов идентификатора участника. 
Например: 
2hxАБВГД, где 2hx - идентификатор оператора ЭДО - ООО "Криптэкс".
В роуминге один из участников имеет другой идентификатор оператора ЭДО. 

Внимание.
Для титулов заказчика\покупателя (формат ФНС действует до 01.07.2017 ) в ИдФайл:  префикс_IdRecipient_IdAuthor
где IdRecipient - это идентификатор получателя АКТ-а или получателя ТОРГ-12, а не идентификатор отправителя первого титула АКТ\ТОРГ12

Пример: 

 Участник ЭДО Титул Пример ИдФайл
 Исполнитель 2hx100 АКТ. Титул исполнителя DP_IAKTPRM_2hx112_2hx100_YYYYMMDD_GUID 
 Заказчик: 2hx112 АКТ. Титул заказчика DP_ZAKTPRM_2hx112_2hx100_YYYYMMDD_GUID

 ТОРГ12. Титул продавца DP_OTORG12_2hx112_2hx100_YYYYMMDD_GUID 

 ТОРГ12. Титул покупателя DP_PTORG12_2hx112_2hx100_YYYYMMDD_GUID