Форматы документов
Диадок позволяет работать с различными форматами документов — как формализованных, так и неформализованных.
Формат электронного документа — это набор определенных требований к структуре и реквизитам файла, в который записана информация для дальнейшей передачи. Для формализованных документов структура и формат утверждены ФНС. Неформализованные не имеют единого утвержденного формата и создаются в произвольном формате исходя из нужд организации.
Чтобы Диадок мог различать и корректно обрабатывать разные форматы документов, каждому формату документа в Диадоке присваивается тип, функция и версия. Каждому формату соответствует собственная структура и вид документооборота, который определяет поведение документа. Получить все доступные типы, функции и версии документов можно с помощью метода 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 - utd970_05_03_01 - utd970_05_02_01 (устарела) |
| Есть |
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd820_05_01_01 |
| |||
| Приказ №970, приложение 2 (устарел) - utd820_05_01_03_hyphen |
| |||
| Приказ №155 (устарел) - utd_05_02_01 - utd_05_01_05 - utd_05_01_04 - utd_05_01_02 - utd_05_01_01 |
| |||
| Исправление УПД | UniversalTransferDocumentRevision | Приказ №970 - utd970_05_03_01 - utd970_05_02_01 (устарела) |
| Есть |
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd820_05_01_01 |
| |||
| Приказ №970, приложение 2 (устарел) - utd820_05_01_03_hyphen |
| |||
| Приказ №155 (устарел) - utd_05_02_01 - utd_05_01_05 - utd_05_01_04 - utd_05_01_02 - utd_05_01_01 | СЧФ | |||
| Универсальный корректировочный документ (УКД) | UniversalCorrectionDocument | Приказ №ЕД-1-26/29@ - ucd29_05_02_01 |
| Есть |
| Нет | |||
| Приказ №736 - ucd736_05_01_02 - ucd736_05_01_01 |
| Есть | ||
| Приказ №736 - ucd736_05_01_03 |
| Нет | ||
| Приказ №189 (устарел) - ucd_05_02_01 - ucd_05_01_02 - ucd_05_01_01 |
| Есть | ||
| Исправление УКД | UniversalCorrectionDocumentRevision | Приказ №ЕД-1-26/29@ - ucd29_05_02_01 |
| Есть |
| Нет | |||
| Приказ №736 - ucd736_05_01_02 - ucd736_05_01_01 |
| Есть | ||
| Приказ №736 - ucd736_05_01_03 |
| Нет | ||
| Приказ №189 (устарел) - ucd_05_02_01 - ucd_05_01_02 - ucd_05_01_01 |
| Есть | ||
| УКД на перемещение | UniversalCorrectionDocumentInternal | Приказ №ЕД-1-26/29@ - ucd29_05_02_01 | default | Есть |
| Приказ №736 - ucd736_05_01_02 | default | |||
| Счет-фактура (СФ) | Invoice | Приказ №970 - utd970_05_03_01 - utd970_05_02_01 (устарела) | default | Есть |
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd820_05_01_01 | default | |||
| Приказ №155 (устарел) - utd_05_02_01 - utd_05_01_05 - utd_05_01_04 - utd_05_01_02 - utd_05_01_01 | default | |||
| Приказ №93 (устарел) - invoice_05_02_01 - invoice_05_01_03 - invoice_05_01_01 | default | |||
| Исправление СФ | InvoiceRevision | Приказ №970 - utd970_05_03_01 - utd970_05_02_01 (устарела) | default | Есть |
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd820_05_01_01 | default | |||
| Приказ №155 (устарел) - utd_05_02_01 - utd_05_01_05 - utd_05_01_04 - utd_05_01_02 - utd_05_01_01 | default | |||
| Приказ №93 (устарел) - invoice_05_02_01 - invoice_05_01_03 - invoice_05_01_01 | default | |||
| Корректировочный СФ (КСФ) | InvoiceCorrection | Приказ №ЕД-1-26/29@ - ucd29_05_02_01 | default | Есть |
| Приказ №736 - ucd736_05_01_02 - ucd736_05_01_01 | default | |||
| Приказ №189 (устарел) - ucd_05_02_01 - ucd_05_01_02 - ucd_05_01_01 | default | |||
| Приказ №93 (устарел) - invoicecor_05_02_01 - invoicecor_05_01_03 | default | |||
| Исправление КСФ | InvoiceCorrectionRevision | Приказ №ЕД-1-26/29@ - ucd29_05_02_01 | default | Есть |
| Приказ №736 - ucd736_05_01_02 - ucd736_05_01_01 | default | |||
| Приказ №189 (устарел) - ucd_05_02_01 - ucd_05_01_02 - ucd_05_01_01 | default | |||
| Приказ №93 (устарел) - invoicecor_05_02_01 - invoicecor_05_01_03 | default | |||
| Товарная накладная (ТОРГ-12) | XmlTorg12 | Приказ №970 - utd970_05_03_01 - utd970_05_02_01 (устарела) | default | Есть |
| Приказ №551 (устарел) - tovtorg_05_02_01 - tovtorg_05_01_04 - tovtorg_05_01_03 - tovtorg_05_01_02 | default | |||
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd820_05_01_01 | default | |||
| Приказ №155 (устарел) - utd_05_02_01 - utd_05_01_05 - utd_05_01_04 - utd_05_01_02 - utd_05_01_01 | default | |||
| Приказ №172 (устарел) - torg12_05_01_02 - torg12_05_01_01 | default | |||
| Акт о выполнении работ/оказании услуг | XmlAcceptanceCertificate | Приказ №970 - utd970_05_03_01 - utd970_05_02_01 (устарела) | default | Есть |
| Приказ №552 (устарел) - rezru_05_02_01 - rezru_05_01_02 - rezru_05_01_01 | default | |||
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd820_05_01_01 | default | |||
| Приказ №155 (устарел) - utd_05_02_01 - utd_05_01_05 - utd_05_01_04 - utd_05_01_02 - utd_05_01_01 | default | |||
| Приказ №172 (устарел) - act_05_01_02 - act_05_01_01 | default | |||
| Акт приемки выполненных работ (КС-2) | PerformedWorkAcceptanceCertificate | Приказ №691 - performedworkacceptancecertificate691_01_00_01 | default | Нет |
| Приказ №970, приложение 2 (устарел) - utd820_05_01_02_hyphen - utd820_05_01_01_hyphen - utd_05_02_01 | default | |||
| Акт сверки взаимных расчетов | ReconciliationAct | Приказ №405 - reconciliationact405_05_01_01 | default | Нет |
| Акт об установленном расхождении (ТОРГ-2) | Torg2 | Приказ №423 - torg2_05_01_01 |
| Нет |
| Счет на оплату | XmlProformaInvoice | Приказ №29 - proformainvoice29_05_01_01 | default | Есть |
| Счет-оферта | XmlInvoiceOffer | Приказ №29 - invoiceoffer29_05_01_01 | default | Есть |
| Электронная транспортная накладная | LogisticsWaybill | Приказ №1065 - kl_trn_mt_05_01 |
| Нет |
| Авианакладная | LogisticsAirWaybill | Приказ №276 - kl_awb_05_02_01 |
| Нет |
| Железнодорожная накладная | LogisticsRailwayWaybill | Приказ №297 - kl_rw_05_01_02 |
| Нет |
| Электронный путевой лист | LogisticsEpl | Приказ №116 - kl_epl_05_01_01 |
| Нет |
| Заказ-заявка | LogisticsOrderRequest | Приказ №108 - zakzvper_05_01_01 | default | Есть |
| Поручение экспедитору | LogisticsForwardingOrder | Приказ №277 - kl_porek_wt3_05_02_01 | default | Есть |
| Экспедиторская расписка | LogisticsForwardingReceipt | Приказ №277 - kl_fr_05_01_02 | default | Есть |
| Складская расписка | LogisticsWarehouseReceipt | Приказ №277 - kl_wr_05_01_01 | default | Есть |
— ПФ — печатная форма.
XSD-схемы
Для каждого формата документа с помощью метода GetDocumentTypes (V3) можно получить XSD-схему и UserDataXsd. Эти схемы используются для генерации титулов. UserDataXsd — упрощенная схема: в ней есть только те поля, которые заполняет пользователь, остальные обязательные для титула данные формирует Диадок.
Ниже приведены XSD-схемы и UserDataXsd для самых популярных форматов документов, действительные на момент публикации. Актуальные XSD-схемы и UserDataXsd, а также схемы для других форматов документов можно получить с помощью метода GetDocumentTypes (V3). Инструкция о получении данных для титула из метода GetDocumentTypes приведена в разделе Данные для генерации титула.
XSD-схемы
| Документ | Версия / Функция | Номер титула (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 | скачать | скачать |
| Универсальный корректировочный документ (УКД) | ucd29_05_02_01 | 0 | скачать | скачать |
| 1 | скачать | скачать | ||
| Корректировочный СФ (КСФ) | ucd29_05_02_01 | 0 | скачать | скачать |
| ucd736_05_01_02 | 0 | скачать | скачать | |
| ucd736_05_01_01 | 0 | скачать | скачать | |
| ucd736_05_01_03 | 0 | скачать | скачать | |
| Товарная накладная (ТОРГ-12) | utd970_05_03_01 | 0 | скачать | скачать |
| 1 | скачать | скачать | ||
| tovtorg_05_02_01 | 0 | скачать | скачать | |
| 1 | скачать | скачать | ||
| Акт о выполнении работ/оказании услуг | utd970_05_03_01 | 0 | скачать | скачать |
| 1 | скачать | скачать | ||
| rezru_05_02_01 | 0 | скачать | скачать | |
| 1 | скачать | скачать | ||
| Акт приемки выполненных работ (КС-2) | performedworkacceptancecertificate691_01_00_01 | 0 | скачать | — |
| 1 | скачать | — | ||
| Акт сверки взаимных расчетов | reconciliationact405_05_01_01 | 0 | скачать | скачать |
| 1 | скачать | скачать | ||
| Акт об установленном расхождении (ТОРГ-2) | 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_awb_05_02_01 / reception_carrier | 0 | скачать | — |
| kl_awb_05_02_01 / reception_consignor | 0 | скачать | — | |
| kl_awb_05_02_01 / delivery_consignee | 0 | скачать | — | |
| kl_awb_05_02_01 / delivery_carrier | 0 | скачать | — | |
| Железнодорожная накладная | kl_rw_05_01_02 / reception_consignor | 0 | скачать | — |
| kl_rw_05_01_02 / reception_carrier | 0 | скачать | — | |
| kl_rw_05_01_02 / delivery_carrier | 0 | скачать | — | |
| kl_rw_05_01_02 / delivery_consignee | 0 | скачать | — | |
| kl_rw_05_01_02 / cost_carrier | 0 | скачать | — | |
| Электронный путевой лист | 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-схема подтверждения оператора о дате отправки СФ, ИСФ, КСФ или ИКСФ (выдается отправителю);
- 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 |
| Протокол разногласий | ContractDisagreements | nonformalizedcontractdisagreements_01_01 |
| Детализация | ServiceDetails | v1 |
| Доп. соглашение | SupplementaryAgreement | v1 |
Для обеспечения информационной безопасности API Диадока выполняет проверку имен файлов, расширений и наличия вредоносного ПО в передаваемых документах. Меры безопасности в отношении документов приведены в разделе Информационная безопасность.