Форматы документов
Диадок позволяет работать с различными форматами документов — как формализованных, так и неформализованных.
Формат электронного документа — это набор определенных требований к структуре и реквизитам файла, в который записана информация для дальнейшей передачи. Для формализованных документов структура и формат утверждены ФНС. Неформализованные не имеют единого утвержденного формата и создаются в произвольном формате исходя из нужд организации.
Чтобы Диадок мог различать и корректно обрабатывать разные форматы документов, каждому формату документа в Диадоке присваивается тип, функция и версия. Каждому формату соответствует собственная структура и вид документооборота, который определяет поведение документа. Получить все доступные типы, функции и версии документов можно с помощью метода GetDocumentTypes (V3): он вернет в ответе список элементов, представленных структурой DocumentTypeDescriptionV3. Инструкция о получении данных из метода GetDocumentTypes приведена на странице Получение информации о типе документа.
Ниже в таблицах приведен список основных форматов документов, а также их типов, версий и функций, действительных на момент публикации. Актуальные форматы можно получить с помощью метода GetDocumentTypes. В столбцах таблицы приведены следующие значения структуры DocumentTypeDescriptionV3:
Тип — тип документа, хранящийся в поле
DocumentTypeDescriptionV3.Name.Версия — версия документа, хранящаяся в поле
DocumentTypeDescriptionV3.Functions[].Versions[].Version.Функция — функция документа, хранящаяся в поле
DocumentTypeDescriptionV3.Functions[].Name.
Узнать формат уже существующего в Диадоке документа можно по значению полей DocumentType, Function и Version в структурах Document и Entity.
Примечание
Так как при изменении требований ФНС Диадок может добавлять новые версии форматов, мы рекомендуем в интеграционных решениях обрабатывать ситуации, когда API вернет в качестве версии неизвестное значение.
Формализованные документы
Форматы
Ниже приведены только самые популярные типы формализованных документов. Полный список доступных форматов можно получить с помощью метода GetDocumentTypes (V3).
Документ |
Тип |
Версия |
Функция |
ПФ [1] |
|---|---|---|---|---|
UniversalTransferDocument |
|
|
Есть |
|
Приказ №970, приложение 2 (устарел)
|
|
|||
Приказ №970, приложение 2 (устарел)
|
|
|||
Приказ №155 (устарел)
|
|
|||
UniversalTransferDocumentRevision |
|
|
Есть |
|
Приказ №970, приложение 2 (устарел)
|
|
|||
Приказ №970, приложение 2 (устарел)
|
|
|||
Приказ №155 (устарел)
|
СЧФ |
|||
UniversalCorrectionDocument |
|
|
Есть |
|
|
|
|||
Приказ №189 (устарел)
|
|
|||
UniversalCorrectionDocumentRevision |
|
|
Есть |
|
|
|
|||
Приказ №189 (устарел)
|
|
|||
Invoice |
|
default |
Есть |
|
Приказ №970, приложение 2 (устарел)
|
default |
|||
Приказ №155 (устарел)
|
default |
|||
Приказ №93 (устарел)
|
default |
|||
InvoiceRevision |
|
default |
Есть |
|
Приказ №970, приложение 2 (устарел)
|
default |
|||
Приказ №155 (устарел)
|
default |
|||
Приказ №93 (устарел)
|
default |
|||
InvoiceCorrection |
|
default |
Есть |
|
Приказ №189 (устарел)
|
default |
|||
Приказ №93 (устарел)
|
default |
|||
InvoiceCorrectionRevision |
|
default |
Есть |
|
Приказ №189 (устарел)
|
default |
|||
Приказ №93 (устарел)
|
default |
|||
XmlTorg12 |
|
default |
Есть |
|
|
default |
|||
Приказ №970, приложение 2 (устарел)
|
default |
|||
Приказ №155 (устарел)
|
default |
|||
Приказ №172 (устарел)
|
default |
|||
XmlAcceptanceCertificate |
|
default |
Есть |
|
|
default |
|||
Приказ №970, приложение 2 (устарел)
|
default |
|||
Приказ №155 (устарел)
|
default |
|||
Приказ №172 (устарел)
|
default |
|||
PerformedWorkAcceptanceCertificate |
|
default |
Нет |
|
Приказ №970, приложение 2 (устарел)
|
default |
|||
ReconciliationAct |
|
default |
Нет |
|
Torg2 |
|
|
Нет |
|
XmlProformaInvoice |
|
default |
Есть |
|
XmlInvoiceOffer |
|
default |
Есть |
|
LogisticsWaybill |
|
|
Нет |
|
LogisticsEpl |
|
|
Нет |
|
LogisticsOrderRequest |
|
default |
Есть |
|
LogisticsForwardingOrder |
|
default |
Есть |
|
LogisticsForwardingReceipt |
|
default |
Есть |
|
LogisticsWarehouseReceipt |
|
default |
Есть |
XSD-схемы
Для каждого формата документа с помощью метода GetDocumentTypes (V3) можно получить XSD-схему и UserDataXsd. Эти схемы используются для генерации титулов.
Ниже приведены XSD-схемы и UserDataXsd для самых популярных форматов документов, действительные на момент публикации. Актуальные XSD-схемы и UserDataXsd, а также схемы для других форматов документов можно получить с помощью метода GetDocumentTypes (V3). Инструкция о получении данных для титула из метода GetDocumentTypes приведена в разделе Данные для генерации титула.
Документ |
Версия / Функция |
Номер титула (titleIndex) |
XSD |
UserDataXsd |
|---|---|---|---|---|
utd970_05_03_01 |
0 |
|||
1 |
||||
utd970_05_02_01 |
1 |
|||
utd820_05_01_02_hyphen |
1 |
|||
utd820_05_01_01_hyphen |
1 |
|||
utd970_05_03_01 |
0 |
|||
ucd736_05_01_02 |
0 |
|||
ucd736_05_01_01 |
0 |
|||
ucd736_05_01_03 |
0 |
|||
utd970_05_03_01 |
0 |
|||
1 |
||||
tovtorg_05_02_01 |
0 |
|||
1 |
||||
utd970_05_03_01 |
0 |
|||
1 |
||||
rezru_05_02_01 |
0 |
|||
1 |
||||
performedworkacceptancecertificate691_01_00_01 |
0 |
— |
||
1 |
— |
|||
reconciliationact405_05_01_01 |
0 |
|||
1 |
||||
torg2_05_01_01 / WithAdditionalInfo |
0 |
|||
1 |
||||
proformainvoice29_05_01_01 |
0 |
|||
invoiceoffer29_05_01_01 |
0 |
|||
kl_trn_mt_05_01 / reception |
0 |
|||
1 |
||||
kl_trn_mt_05_01 / delivery |
0 |
|||
1 |
||||
kl_trn_mt_05_01 / readdress |
0 |
— |
||
kl_trn_mt_05_01 / relay |
0 |
— |
||
kl_trn_mt_05_01 / cost |
0 |
— |
||
1 |
||||
kl_epl_05_01_01 / ShippingTerms |
0 |
— |
||
kl_epl_05_01_01 / OdometerAfter |
0 |
— |
||
kl_epl_05_01_01 / OdometerBefore |
0 |
— |
||
kl_epl_05_01_01 / CheckupAfter |
0 |
— |
||
kl_epl_05_01_01 / CheckupBefore |
0 |
— |
||
kl_epl_05_01_01 / TechInspection |
0 |
— |
||
zakzvper_05_01_01 |
0 |
|||
1 |
||||
kl_porek_wt3_05_02_01 |
0 |
|||
1 |
||||
2 |
||||
kl_fr_05_01_02 |
0 |
|||
kl_wr_05_01_01 |
0 |
— |
Форматы служебных документов утверждены приказом ФНС России от 30.01.2012 N ММВ-7-6/36@. XSD-схемы для генерации служебных документов:
XSD-схема подтверждения оператора о дате отправки СФ, ИСФ, КСФ или ИКСФ(выдается отправителю);
XSD-схема подтверждения оператора о дате доставки СФ, ИСФ, КСФ или ИКСФ(выдается получателю);
XSD-схема уведомления об уточнении СФ/ИСФ/КСФ/ИКСФ(формируется получателем).
Неформализованные документы
Ниже приведены только самые популярные типы неформализованных документов. Полный список доступных форматов можно получить с помощью метода GetDocumentTypes (V3).
Документ |
Тип |
Версия |
|---|---|---|
Неформализованный документ |
Nonformalized |
v1 |
Неформализованная накладная ТОРГ-12 |
Torg12 |
v1 |
Неформализованнвя накладная ТОРГ-13 |
Torg13 |
v1 |
Неформализованный акт |
AcceptanceCertificate |
v1 |
Неформализованный акт сверки |
ReconciliationAct |
v1 |
Приглашение к ЭДО |
TrustConnectionRequest |
v1 |
Счет |
ProformaInvoice |
v1 |
Ценовой лист |
PriceList |
v1 |
Протокол согласования цены |
PriceListAgreement |
v1 |
Реестр сертификатов |
CertificateRegistry |
v1 |
Договор |
Contract |
v1 |
Детализация |
ServiceDetails |
v1 |
Доп. соглашение |
SupplementaryAgreement |
v1 |
Предупреждение
Для обеспечения информационной безопасности API Диадока выполняет проверку имен файлов, расширений и наличия вредоносного ПО в передаваемых документах. Меры безопасности в отношении документов приведены в разделе Информационная безопасность.