В API Диадока поддержали отправку и получение универсальных сообщений

Универсальные сообщения придут на замену извещениям о получении и уведомлениям об уточнении

Минфин представил проект приказа о введении нового порядка обмена электронными счетами-фактурами. Так, форматы извещения о получении, уведомления об уточнении и отказа в подписи перестанут действовать — вместо них нужно будет использовать универсальные сообщения (УС).

Предполагалось, что приказ Минфина, который вводит новый порядок обмена документами, вступит в силу с 1 октября 2025 года. Однако срок перехода отложили. Теперь ожидается, что новый порядок начнет действовать с 1 апреля 2026 года.

Несмотря на то, что сроки перехода на универсальные сообщения сдвинули, ФНС рекомендует не прекращать работу над внедрением нового порядка обмена. В настоящее время в Диадоке уже идет поэтапная подготовка к переходу.

Интеграторы во время переходного периода смогут протестировать функциональность универсальных сообщений и перестроить свои интеграционные решения на их использование.

В API Диадока поддержали отправку и получение универсальных сообщений. Для более плавного перехода ознакомьтесь с инструкциями:

• Переход на универсальные сообщения
• Генерация и отправка универсального сообщения
• Получение универсального сообщения

Какие изменения реализовали в методах API

Добавили метод GenerateUniversalMessage, с помощью которого можно сгенерировать XML-файл УС.

Добавили новую версию метода PostMessagePatch (V4). Новая версия позволяет отправить УС вместе с текущими служебными документами.

Метод принимает на вход новую структуру MessagePatchToPostV2, в поле UniversalMessages которой можно передать XML-файл УС внутри новой структуры UniversalMessageAttachment. Помимо этого хотя бы одно из полей Receipts, CorrectionRequests или XmlSignatureRejections должно содержать текущие служебные документы. Если поле UniversalMessages не будет заполнено, Диадок при отправке сгенерирует и добавит в сообщение УС на основании переданных текущих служебных документов.

Прежняя версия метода PostMessagePatch (V3) продолжит работать с текущими форматами служебных документов до момента вступления в силу нового порядка обмена. Однако Диадок на их основании будет дополнительно генерировать и добавлять в сообщение УС.

Добавили новые версии методов GetEvent (V3), GetLastEvent (V2), GetNewEvents (V8) и GetMessage (V6). Они, наряду с текущими служебными документами, возвращают УС в виде сущности Entity:

• тип вложения сущности УС имеет новое значение AttachmentType = UniversalMessage,
• информация об УС хранится в новом поле UniversalMessageInfo виде новой структуры UniversalMessageInfo.

Прежние версии методов GetEvent (V2), GetLastEvent, GetNewEvents (V7) и GetMessage (V5) также будут работать с текущими форматами служебных документов до момента вступления в силу нового порядка обмена.

Добавили новые версии методов GetDocflows (V4), GetDocflowsByPacketId (V4), SearchDocflows (V4) и GetDocflowEvents (V4). Они так же, как и текущие форматы служебных документов, возвращают УС в виде новой структуры UniversalMessageAttachmentDocflow в поле UniversalMessage новых версий структур ReceiptDocflowV4, AmendmentRequestDocflowV4 и SignatureRejectionDocflowV4.

Прежние версии методов GetDocflows (V3), GetDocflowsByPacketId (V3), SearchDocflows (V3) и GetDocflowEvents (V3) продолжат работать до момента вступления в силу нового порядка обмена.

Изменили поведение метода GetEntityContent (V4). Теперь он может возвращать содержимое универсального сообщения. Метод GenerateDocumentZip сумеет возвращать в архиве файл универсального сообщения, если он был присутствовал в сообщении.

Отправляйте юридически значимые электронные документы через Диадок

Подключиться