Отправка документов
Для взаимодействия с АРМ используются 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) или |
|
81 | Подпись под файлом, расширение: (.sig\.p7s\.sgn) | имя документа или UUID.расширение Заполняется только АРМ-ом, тип файла используется в роуминге |
82 | Извещение о получении | DP_IZVPOL_IdRecipient_IdAuthor_YYYYMMDD_GUID.xml |
83 | Приглашение к обмену. Используется в роуминге | GUID.ZIP |
84 | Запрос на разрыв обмена. Используется в роуминге | GUID.ZIP |
90 | Уведомление о принятии документа (УОП) – электронная подпись Получателя в формате CMS, фиксирующая факт принятия (согласия с условиями) полученного электронного документа. | GUID, АРМ не отправляет исходный документ, а только созданную подпись |
| ||
ПРИКАЗ от 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 |
EDI документы | ||
154 | DELFOR - прогноз заказов в формате XML | DELFOR_guid.XML |
155 | DELJIT- заказ в формате XML | DELJIT_guid.XML |
156 | DESADV - уведомление об отгрузке в формате XML | DESADV_guid.XML |
Примечания:
* - уточните у Оператора и получателя возможность использования данного формата.
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 |