Форматы документов

Формат №155

Формат, утвержденный Приказом ФНС России от 24.03.2016 №ММВ-7-15/155@, позволяет сформировать 3 разных типа документов:

  • счета-фактуры,
  • накладные, акты, другие первичные документы,
  • УПД.

В XML-файле документа необходимо заполнить поле «функция», которая определит тип документа:

  • счет-фактура ( СЧФ ),
  • первичный документ ( ДОП ),
  • УПД ( СЧФДОП ).

Формат № 820

Формат №820, утвержденный Приказом ФНС России от 19.12.2018 № ММВ-7-15/820@, пришел на смену формату №155 и распространяется на те же типы документов:

  • счета-фактуры,
  • накладные, акты и другие первичные документы,
  • УПД.

Примечание

До конца 2019 года действующими являются оба формата - №155 и №820, с 1 января 2020 года формат №155 утратит свою силу.

Работа в Диадоке

Для Диадока документ в формате №155 или №820 – это контейнер, внутри которого лежит информация о сделке, совершенной клиентом.

Диадок ничего не знает о том, как выглядит учетная политика клиентов, и, соответственно, не может угадать дали ему ЭСФ/АКТ/Накладную/УПД.

Более того, по содержанию документа так же нельзя однозначно отличить один тип документа от другого.

Примечание

При отправке документа участник ЭДО всегда сам выбирает показатель «тип документа».

Пример

Если продавец выставит счет-фактуру по формату согласно Приказу №155 или Приказу №820, укажет в документе функцию СЧФ, но тип документа в API укажет UniversalTransferDocument, то Диадок визуализирует документ, как УПД.

Чтобы визуализация счета-фактуры была привычной, при отправке документа необходимо указывать тип в API Invoice.

Особенности и ограничения

Есть различия в работе с форматами №155 и №820, они касаются генерации и парсинга документов.

Для генерации документов в формате №155 можно использовать универсальные методы генерации GenerateSenderTitleXml и GenerateRecipientTitleXml, а также специальные методы для документов в формате УПД GenerateUniversalTransferDocumentXmlForSeller и GenerateUniversalTransferDocumentXmlForBuyer.

Для парсинга документов в формате №155 можно использовать универсальный метод ParseTitleXml, а также специальные методы для документов в формате УПД ParseUniversalTransferDocumentSellerTitleXml и ParseUniversalTransferDocumentBuyerTitleXml.

Для генерации и парсинга документов в формате №820 можно использовать только универсальные методы: GenerateSenderTitleXml и GenerateRecipientTitleXml для генерации, ParseTitleXml для парсинга

Соответствие типов документов и форматов документов
Веб API Форматы Функция Печатная форма
СФ Invoice
  • приказ №93
  • приказ №155
  • приказ №820
  • СЧФ
  • СЧФ
СФ
Исправление СФ InvoiceRevision
  • приказ №93
  • приказ №155
  • приказ №820
  • СЧФ
  • СЧФ
СФ
КСФ InvoiceCorrection
  • приказ №93
  • приказ №189
  • КСЧФ
КСФ
Накладная XmlTorg12
  • приказ №172
  • приказ №155
  • приказ №820
  • приказ №551
  • ДОП
  • ДОП
Накладная
Акт XmlAcceptanceCertificate
  • приказ №172
  • приказ №155
  • приказ №820
  • приказ №552
  • ДОП
  • ДОП
Акт
УПД UniversalTransferDocument
  • приказ №155
  • приказ №820
  • СЧФ
  • ДОП
  • СЧФДОП
УПД
Исправление УПД UniversalTransferDocument Revision
  • приказ №155
  • приказ №820
  • СЧФ
  • ДОП
  • СЧФДОП
УПД
УКД UniversalCorrectionDocument
  • приказ №189
  • КСЧФ
  • ДИС
  • КСЧФДИС
УКД

Возможные форматы

В связи с тем, что документ может быть в разных форматах – интеграционным решениям необходимо понимать в каком формате пришел документ, что бы корректно обработать его на своей стороне.

Для получения акутальной информации о XSD-схеме документа введено специальное поле Version. Оно есть в структурах данных Document, Entity и DocumentInfo.

Примечание

Ниже приведен неполный список версий документов. Актуальные версии документа следует получать с помощью метода GetDocumentTypes

Примеры типов и значений Version для формализованных документов
Тип документы Структура Возможные версии
Счет-фактура (СФ) Invoice

Приказ №93

  • invoice_05_01_01
  • invoice_05_01_03
  • invoice_05_02_01

Приказ №155

  • utd_05_01_01
  • utd_05_01_02
  • utd_05_01_04
  • utd_05_01_05
  • utd_05_02_01

Приказ №820

  • utd820_05_01_01
  • utd820_05_01_01_Hyphen
Исправление СФ InvoiceRevision

Приказ №93

  • invoice_05_01_03
  • invoice_05_02_01

Приказ №155

  • utd_05_01_01
  • utd_05_01_02
  • utd_05_01_04
  • utd_05_01_05
  • utd_05_02_01

Приказ №820

  • utd820_05_01_01
  • utd820_05_01_01_Hyphen
Корректировочный СФ (КСФ) InvoiceCorrection

Приказ №93

  • invoicecor_05_01_03
  • invoicecor_05_02_01

Приказ № 189

  • ucd_05_01_01
  • ucd_05_01_02
  • ucd_05_02_01
Исправление КСФ InvoiceCorrectionRevision

Приказ № 93

  • invoicecor_05_01_03
  • invoicecor_05_02_01

Приказ №189

  • ucd_05_01_01
  • ucd_05_01_02
  • ucd_05_02_01
Формализованный ТОРГ-12 XmlTorg12

Приказ №172

  • torg12_05_01_01
  • torg12_05_01_02

Приказ №155

  • utd_05_01_01
  • utd_05_01_02
  • utd_05_01_04
  • utd_05_01_05
  • utd_05_02_01

Приказ №820

  • utd820_05_01_01
  • utd820_05_01_01_Hyphen

Приказ № 551

  • tovtorg_05_01_02
  • tovtorg_05_01_03
  • tovtorg_05_02_01
Формализованный акт XmlAcceptanceCertificate

Приказ №172

  • act_05_01_01
  • act_05_01_02

Приказ №155

  • utd_05_01_01
  • utd_05_01_02
  • utd_05_01_04
  • utd_05_01_05
  • utd_05_02_01

Приказ №820

  • utd820_05_01_01
  • utd820_05_01_01_Hyphen

Приказ №552

  • rezru_05_01_01
  • rezru_05_02_01
УПД UniversalTransferDocument

Приказ № 155

  • utd_05_01_01
  • utd_05_01_02
  • utd_05_01_04
  • utd_05_01_05
  • utd_05_02_01

Приказ №820

  • utd820_05_01_01
  • utd820_05_01_01_Hyphen
Исправление УПД UniversalTransferDocumentRevision

Приказ №155

  • utd_05_01_01
  • utd_05_01_02
  • utd_05_01_04
  • utd_05_01_05
  • utd_05_02_01

Приказ №820

  • utd820_05_01_01
  • utd820_05_01_01_Hyphen
УКД UniversalCorrectionDocument

Приказ №189

  • ucd_05_01_01
  • ucd_05_01_02
  • ucd_05_02_01
Исправление УКД UniversalCorrectionDocumentRevision

Приказ №189

  • ucd_05_01_01
  • ucd_05_01_02
  • ucd_05_02_01

Важно

AttachmentVersion = UniversalTrnsaferDocument для СФ/ИСФ и AttachmentVersion = UniversalCorrectionDocument для КСФ/ИКСФ считаются устаревшими. Поле AttachmentVersion устарело. Вместо него используйте Version.

Типы и значения Version для неформализованных документов
Тип документы Структура Возможные версии
Неформализованный документ Nonformalized v1
Приглашение к ЭДО TrustConnectionRequest v1
Неформализованный ТОРГ-12 Torg12 v1
Неформализованный акт AcceptanceCertificate v1
Счет ProformaInvoice v1
Ценовой лист PriceList v1
Протокол согласования цены PriceListAgreement v1
Реестр сертификатов CertificateRegistry v1
Акт сверки ReconciliationAct v1
Договор Contract v1
Накладная Torg13 v1
Детализация ServiceDetails v1
Доп. соглашение SupplementaryAgreement v1

Добавление новых версий

При обновление форматов формализованных документов ФНС, в Диадоке будут добавляться новые значения Version, соответствующие новым версиям формата.

Интеграционным решениям нужно быть готовыми к тому, что может прийти новое значение Version. Рекомендуется уметь обрабатывать такие ситуации.