Форматы документов¶
Формат № 820¶
Формат №820, утвержденный Приказом ФНС России от 19.12.2018 № ММВ-7-15/820@, пришел на смену формату №155 и распространяется на типы документов:
счета-фактуры,
накладные, акты и другие первичные документы,
УПД.
Работа в Диадоке¶
Для Диадока документ в формате №820 — это контейнер, внутри которого лежит информация о сделке, совершенной клиентом. Диадок ничего не знает о том, как выглядит учетная политика клиентов, и не может угадать дали ему ЭСФ, акт, накладную или УПД. По содержанию документа также нельзя однозначно отличить один тип документа от другого.
Примечание
При отправке документа участник ЭДО всегда сам выбирает показатель «тип документа».
Пример¶
Если продавец выставит счет-фактуру по формату согласно Приказу №820, укажет в документе функцию СЧФ, но тип документа в API укажет UniversalTransferDocument
, то Диадок визуализирует документ как УПД. Чтобы визуализация счета-фактуры была привычной, при отправке документа в API нужно указать тип Invoice
.
Генерация и парсинг¶
Для документов в формате №820 используйте методы GenerateTitleXml для генерации и ParseTitleXml для парсинга.
Веб |
API |
Форматы |
Функция |
Печатная форма |
---|---|---|---|---|
СФ |
Invoice |
приказ №93 (устарел) |
— |
СФ |
приказ №155 (устарел) |
СЧФ |
|||
приказ №820 |
СЧФ |
|||
Исправление СФ |
InvoiceRevision |
приказ №93 (устарел) |
— |
СФ |
приказ №155 (устарел) |
СЧФ |
|||
приказ №820 |
СЧФ |
|||
КСФ |
InvoiceCorrection |
приказ №93 (устарел) |
— |
КСФ |
приказ №189 (устарел) |
КСЧФ |
|||
приказ №736 |
КСЧФ |
|||
Исправление КСФ |
InvoiceCorrection |
приказ №93 (устарел) |
— |
КСФ |
приказ №189 (устарел) |
КСЧФ |
|||
приказ №736 |
КСЧФ |
|||
Накладная |
XmlTorg12 |
приказ №172 (устарел) |
— |
Накладная |
приказ №155 (устарел) |
ДОП |
|||
приказ №820 |
ДОП |
|||
приказ №551 |
— |
|||
Акт |
XmlAcceptanceCertificate |
приказ №172 (устарел) |
— |
Акт |
приказ №155 (устарел) |
ДОП |
|||
приказ №820 |
ДОП |
|||
приказ №552 |
— |
|||
УПД |
UniversalTransferDocument |
приказ №155 (устарел) |
СЧФ ДОП СЧФДОП |
УПД |
приказ №820 |
СЧФ ДОП СЧФДОП СвРК (для версии utd820_05_01_02_hyphen) СвЗК (для версии utd820_05_01_02_hyphen) |
|||
Исправление УПД |
UniversalTransferDocumentRevision |
приказ №155 (устарел) |
СЧФ |
УПД |
приказ №820 |
СЧФ ДОП СЧФДОП СвРК (для версии utd820_05_01_02_hyphen) СвЗК (для версии utd820_05_01_02_hyphen) |
|||
УКД |
UniversalCorrectionDocument |
приказ №189 (устарел) |
КСЧФ ДИС КСЧФДИС |
УКД |
приказ №736 |
КСЧФ ДИС КСЧФДИС СвИСРК (для версии ucd736_05_01_02) СвИСЗК (для версии ucd736_05_01_02) |
|||
Исправление УКД |
UniversalCorrectionDocumentRevision |
приказ №189 (устарел) |
КСЧФ ДИС КСЧФДИС |
УКД |
приказ №736 |
КСЧФ ДИС КСЧФДИС СвИСРК (для версии ucd736_05_01_02) СвИСЗК (для версии ucd736_05_01_02) |
Возможные форматы¶
Документ может быть в разных форматах, поэтому в интеграционных решениях нужно различать формат пришедшего документа, чтобы корректно обработать его на своей стороне.
Для получения акутальной информации о XSD-схеме документа введено специальное поле Version
. Оно есть в структурах Document и Entity.
Ниже приведен неполный список версий документов. Актуальные версии документа вы можете получить с помощью метода GetDocumentTypes
Важно
Поле AttachmentVersion
устарело, вместо него используйте поле Version
.
Тип документа |
Структура |
Возможные версии |
---|---|---|
Счет-фактура |
Invoice |
Приказ №93 (устарел)
Приказ №155 (устарел)
Приказ №820
|
Исправление СФ |
InvoiceRevision |
Приказ №93 (устарел)
Приказ №155 (устарел)
Приказ №820
|
Корректировочный СФ |
InvoiceCorrection |
Приказ №93 (устарел)
Приказ №189 (устарел)
Приказ №736
|
Исправление КСФ |
InvoiceCorrectionRevision |
Приказ №93 (устарел)
Приказ №189 (устарел)
Приказ №736
|
Формализованный ТОРГ-12 |
XmlTorg12 |
Приказ №172 (устарел)
Приказ №155 (устарел)
Приказ №820
Приказ №551
|
Формализованный акт |
XmlAcceptanceCertificate |
Приказ №172 (устарел)
Приказ №155 (устарел)
Приказ №820
Приказ №552
|
УПД |
UniversalTransferDocument |
Приказ №155 (устарел)
Приказ №820
|
Исправление УПД |
UniversalTransferDocumentRevision |
Приказ №155 (устарел)
Приказ №820
|
УКД |
UniversalCorrectionDocument |
Приказ №189 (устарел)
Приказ №736
|
Исправление УКД |
UniversalCorrectionDocumentRevision |
Приказ №189 (устарел)
Приказ №736
|
КС-2 |
PerformedWorkAcceptanceCertificate |
Приказ №820
Приказ №691
|
Торг-2 |
Torg2 |
Приказ №423
|
Формализованный акт сверки |
ReconciliationAct |
Приказ №405
|
Тип документа |
Структура |
Возможные версии |
---|---|---|
Неформализованный документ |
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
при обновлениях форматов формализованных документов ФНС. Поэтому мы рекомендуем в интеграционных решениях обрабатывать ситуации, когда методы API вернут новое значение Version
.