Диадок API

24.04.2025

Thu, 24 Apr 2025 00:00:00 +0000

24.04.2025

SDK: C# 2.37.0 | Java 4.3.0

Добавили в метод RegisterPowerOfAttorney возможность регистрировать машиночитаемую доверенность (МЧД) по трем реквизитам.

Для этого включили в структуру PowerOfAttorneyFullId новое необязательное поле RepresentativeInn, предназначенное для хранения ИНН представителя из МЧД.

12.05.2025

Mon, 12 May 2025 00:00:00 +0000

12.05.2025

SDK: C# 2.38.0 | Java 4.4.0

Для метода GetOrganizationsByInnList, принимающего в качестве параметра идентификатор организации, добавили новую версию GetOrganizationsByInnList (V2), позволяющую работать с идентификатором ящика.

Мы рекомендуем использовать новую версию метода. Старую версию метода GetOrganizationsByInnList отметили как устаревшую и перенесли в раздел Устаревшие методы и структуры.

05.06.2025

Thu, 05 Jun 2025 00:00:00 +0000

05.06.2025

SDK: C# 2.41.0 | Java 4.5.0

Добавили возможность получать информацию о типе электронной подписи под документом. Для этого в структуру SignatureV3 добавили поле SignatureTypeInfo, которое хранит информацию о типе подписи в виде новой структуры SignatureTypeInfo.

16.06.2025

Mon, 16 Jun 2025 00:00:00 +0000

16.06.2025

Реализовали поддержку отправки и получения универсальных сообщений (УС). Подробная инструкция по переходу на использование УС приведена на странице Переход на универсальные сообщения.

Для работы с УС реализовали следующие изменения:
- Добавили метод 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: теперь он может возвращать в архиве файл универсального сообщения, если он был присутствовал в сообщении.
Инструкции для работы с универсальными сообщениями:
Обратите внимание, что после окончания переходного периода текущие форматы извещения о получении, уведомления об уточнении и отказа в подписи перестанут действовать: вместо них нужно будет использовать универсальные сообщения.

25.06.2025

Wed, 25 Jun 2025 00:00:00 +0000

25.06.2025

SDK: C# 2.44.0

Добавили новый метод GetResolutionRoutes для получения списка маршрутов согласования. Прежний метод GetResolutionRoutesForOrganization отмечен устаревшим и перенесен в раздел Устаревшие методы и структуры.

Рекомендуем для получения маршрутов согласования использовать новый метод.

04.07.2025

Fri, 04 Jul 2025 00:00:00 +0000

04.07.2025

SDK: C# 2.43.0 | Java 4.6.0

Реализовали предварительную проверку машиночитаемой доверенностью (МЧД) по трем реквизитам. Для этого:
- Изменили структуру PowerOfAttorneyFullId: теперь поле RepresentativeInn является обязательным.
- Добавили новую версию структуры PowerOfAttorneyPrevalidateRequestV2 с полем FullId для хранения идентификатора МЧД в виде обновленной структуры PowerOfAttorneyFullId.
- Добавили новую версию метода PrevalidatePowerOfAttorney (V2), которая работает с МЧД по трем реквизитам.

09.07.2025

Wed, 09 Jul 2025 00:00:00 +0000

09.07.2025

SDK: C# 2.42.0 | Java 4.7.0

Реализовали возможность отменить сведения об отгрузке маркированных товаров. Для этого:
- Добавили метод GenerateTtGisFixationCancellationRequest, с помощью которого можно сгенерировать служебный документ для отмены сведений об отгрузке.
- Добавили в структуры MessagePatchToPost и MessagePatchToPostV2 поле TtGisFixationCancellationRequests со списком документов для отмены сведений об отгрузке в виде новой структуры TtGisFixationCancellationRequestAttachment.
- Добавили в структуру Document поле CancellationStatus со статусом подписания документа для отмены сведений об отгрузке в виде нового перечисления TtGisFixationCancellationStatus.
- Добавили в структуру Entity поле TtGisFixationCancellationRequest с документом для отмены сведений об отгрузке.
- Добавили в структуры DocflowV3 и DocflowV4 поле TtGisFixation с информацией о документе для отмены сведений об отгрузке в виде новой структуры TtGisFixationDocflow.
- Добавили в метод GetDocuments (V3) новое значение фильтра HaveToCancelTtGisFixation для получения документов, по которым требуется отмена сведений об отгрузке.
Статусы обработки маркированных товаров описаны на странице Документы с маркированными товарами.

Инструкции для работы с документом для отмены сведений об отгрузке маркированных товаров:

24.07.2025

Thu, 24 Jul 2025 00:00:00 +0000

24.07.2025

В API Диадока добавили новый способ аутентификации с помощью OpenID Connect.

Эта схема позволяет аутентифицировать пользователя с помощью OpenID Провайдера. Теперь пользователи для доступа к API Диадока могут использовать токены, полученные через систему единого входа в сервисы Контур. Этот механизм обеспечивает безопасность и упрощает процесс аутентификации для разработчиков и пользователей.

При разработке интеграционного решения можно реализовать один из двух алгоритмов получения токена в зависимости от типа вашего приложения:
- Authorization Code Flow — для приложений с серверной частью,
- Device Authorization Flow — для приложений, где ввод данных затруднен.
Обратите внимание, что токены, полученные через OpenID Connect, имеют ограниченное время жизни и требуют периодического обновления.

Инструкция по настройке приложений на новый способ авторизации приведена на странице Авторизация.

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

Методы Authenticate (V3) и AuthenticateConfirm (V2) отмечены устаревшими и перенесены в раздел Устаревшие методы и структуры

Мы рекомендуем использовать аутентификацию через OpenID Connect вместо устаревшей схемы авторизации через методы API.

31.07.2025

Thu, 31 Jul 2025 00:00:00 +0000

31.07.2025

Реализовали изменения в API Диадока согласно письму от ФНС №ЕА-4-26/6254@ от 30.06.2025, а именно для УПД формата приказа №970 внесли следующие изменения:
- изменили XSD и UserDataXsd схемы:
  - размер атрибутов НомерСчета и КорСчет увеличили до 34 символов,
  - размер атрибута НаимРегион увеличили до 51 символа,
- изменили проверку атрибута КодПроисх — теперь он всегда необязательный.
Внесенные изменения касаются в том числе настроек редактирования.

Кроме этого обновили печатную форму для УПД — теперь в строке 5А вместо значения «тот же» выводятся наименование, номер и дата документов, указанные в атрибуте ДокПодтвОтгрНом.

Актуальные XSD-схемы приведены на странице Форматы документов.

08.08.2025

Fri, 08 Aug 2025 00:00:00 +0000

08.08.2025

SDK: C# 2.47.0 | Java 4.10.0

Реализовали работу с машиночитаемой доверенностью (МЧД) сотрудника по трем реквизитам. Для этого добавили новые версии методов, которые работают с МЧД сотрудника по трем реквизитам:
- AddEmployeePowerOfAttorney (V2) — принимает на вход структуру PowerOfAttorneyFullId с тремя реквизитами МЧД;
- DeleteEmployeePowerOfAttorney (V2) — принимает на вход структуру PowerOfAttorneyFullId с тремя реквизитами МЧД;
- UpdateEmployeePowerOfAttorney (V2) — принимает на вход структуру EmployeePowerOfAttorneyToUpdateV2, хранящую внутри структуру PowerOfAttorneyFullId с тремя реквизитами МЧД.

18.08.2025

Mon, 18 Aug 2025 00:00:00 +0000

18.08.2025

SDK: C# 2.50.0 | Java 4.12.0

Изменили поля для получения времени жизни МЧД. Для этого внесли изменения в структуру PowerOfAttorney:
- добавили поля StartAtByMoscow и ExpireAtByMoscow, которые хранят дату начала и окончания действия МЧД в московском часовом поясе в виде новой структуры DateTimeOffset,
- отметили устаревшими поля StartAt и ExpireAt, которые хранят дату начала и окончания действия МЧД в UTC.
Для работы со временем жизни МЧД рекомендуем использовать новые поля StartAtByMoscow и ExpireAtByMoscow.

22.08.2025

Fri, 22 Aug 2025 00:00:00 +0000

22.08.2025

Обновили версию формата универсального сообщения.

ФНС изменила версию формата универсального сообщения: теперь актуальная версия — 5.01. Мы поддержали это обновление в API Диадока:
- теперь метод генерации GenerateUniversalMessage работает с форматом 5.01,
- актуальная XSD-схема универсального сообщения с ВерсФорм=5.01 приведена в разделе XSD-схемы.

27.08.2025

Wed, 27 Aug 2025 00:00:00 +0000

27.08.2025

SDK: C# 2.52.0

Добавили методы парсинга универсальных сообщений: ParseUniversalMessageXml и ParseUniversalMessage. С их помощью можно распарсить XML-файл универсального сообщения, передав содержимое файла или указав сущность УС внутри сообщения соответственно.

Обратите внимание, что во время переходного периода метод ParseUniversalMessage не работает и возвращает ошибки — он будет доступен только после окончания переходного периода. Для парсинга универсального сообщения во время переходного периода используйте метод ParseUniversalMessageXml.

22.08.2025

SDK: C# 2.51.0 | Java 4.13.0

Для технологических партнеров добавили метод GetPartnerEvents, с помощью которого можно получить список событий, произошедших с документами во всех доступных ящиках.

Метод GetPartnerEvents принимает на вход запрос на получение списка событий в виде новой структуры GetPartnerEventsRequest и возвращает список событий в виде новой структуры GetPartnerEventsResponse.

28.08.2025

Thu, 28 Aug 2025 00:00:00 +0000

28.08.2025

Реализовали работу с формализованным счетом на оплату и счетом-офертой, утвержденными Приказом N ЕД-7-26/29@. Для этого внесли следующие изменения:
- Добавили новые типы документов:
  - XmlProformaInvoice — для счета на оплату, текущая версия proformainvoice29_05_01_01,
  - XmlInvoiceOffer — для счета-оферты, текущая версия invoiceoffer29_05_01_01.
  Информацию об этих типах документов можно получить с помощью метода GetDocumentTypes (V2), также она доступна на странице Форматы документов.
- Добавили в перечисление DocumentTitleType новое значение ProformaInvoice29 для счета на оплату и счета-оферты.
- Добавили для поля ExtendedDocumentTitleType структуры SignerInfoV2 новое значение 14 — для данных подписанта счета на оплату и счета-оферты.
- Реализовали возможность работы со счетом на оплату и счетом-офертой в методах:
  - GenerateTitleXml — генерация,
  - ParseTitleXml — парсинг,
  - PostMessage (V3) — отправка.
  Также доступно получение этих документов существующими методами API.
Для счета на оплату и счета-оферты данные подписанта можно передавать в универсальном формате. Также для этих типов доступна передача машиночитаемой доверенности в содержимом документа.

Подробную информацию можно найти на страницах:
- Документооборот счетов на оплату и счетов-оферт
- Работа со счетом на оплату и счетом-офертой
Схемы XSD и UserDataXsd можно скачать в разделе XSD-схемы.

08.09.2025

Mon, 08 Sep 2025 00:00:00 +0000

08.09.2025

Поддержали изменения в постановлении Правительства РФ от 30.11.2022 N 2173. Для этого изменили проверку документов, содержащих информацию об алкогольной продукции, подлежащей маркировке.

Теперь для документов, у которых ИдФайл содержит N4=1, будут действовать следующие проверки:
- Сведения о перевозочных документах. Если в ИдФайл N3=1 и N4=1, тогда должно выполняться одно из условий:
- В поле ИнфПолФХЖ1 есть вложенное поле ТекстИнф со значениями Идентиф="НомерПеревозЭлДок" и "Значен"=<ГУИД 36 знаков>.
- В поле ИнфПолФХЖ1 одновременно есть вложенные поля:
  - ТекстИнф со значением Идентиф="НомерПеревозДок" и поле "Значен" не пустое,
  - ТекстИнф со значением Идентиф="ДатаПеревозДок" и поле "Значен" содержит значение в формате Дата,
  - ТекстИнф может не содержать Идентиф="РегНомер". Если заполнен Идентиф="РегНомер", то в поле "Значен" содержится символьная строка (допустимо поставить прочерк).
- Сведения об адресе ФИАС ИД. Если в ИдФайл N3=1 и N4=1, тогда в качестве грузоотправителя и грузополучателя могут быть указаны только ЮЛ (СвЮЛУч) или ИП (СвИП):
- Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — юридическое лицо, то обязательно должны быть указаны ИНН и КПП в ГрузОт(СвПрод)/ГрузПолуч(СвПокуп).
- Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — индивидуальный предприниматель, то должно выполняться одно из условий:
  - адрес заполнен в формате ГАР (используется АдрГАР),
  - адрес заполнен в формате АдрРФ и в поле ИнфПолФХЖ1 указаны:
    
    для грузоотправителя — поле ТекстИнф со значением Идентиф="Продавец_ФиасИД" и "Значен"=<ГУИД 36 знаков>,
    
    для грузополучателя — поле ТекстИнф со значением Идентиф="Покупатель_ФиасИД" и "Значен"=<ГУИД 36 знаков>.

Note

Примечание

13 сентября 2025 был установлен адаптационный период для участников оборота пива в потребительской упаковке. Этот период позволяет компаниям завершить настройку своих систем и стабилизировать процессы, не нарушая действующее законодательство. Подробнее в статье Изменения для участников оборота пива в потребительской упаковке.

В связи с обновлением постановления мы отключили набор описанных проверок в API Диадока. О включении новых проверок оповестим отдельно.

28.08.2025

SDK: C# 2.40.0

Реализовали возможность работы с адресной системой ФИАС. Для этого внесли следующие изменения:
- Добавили в структуру Address поле GarAddress, которое хранит адрес объекта в государственном адресном реестре (ГАР) в виде новой структуры GarAddress.
- Добавили метод ParseGarAddress, с помощью которого можно получить адрес объекта в ГАР.

01.10.2025

Wed, 01 Oct 2025 00:00:00 +0000

01.10.2025

SDK: C# 2.56.0 | Java 4.15.1

Отметили устаревшими методы и структуры для работы с пересланными документами:
Запланировали к удалению методы для работы с печатными формами пересланных документов:
- GenerateForwardedDocumentPrintForm
- GenerateForwardedDocumentProtocol (V2)
Теперь они возвращают в ответе заголовки Sunset и Link. Подробнее на странице Политика устаревания.

Методы будут удалены из API после 01 ноября 2025. Если вы используете эти методы API в своих интеграционных решениях, удалите их.

02.10.2025

Thu, 02 Oct 2025 00:00:00 +0000

02.10.2025

В рамках перехода API Диадока на работу с МЧД по трем реквизитам добавили возможность использовать реквизит RepresentativeInn в теле запроса следующих методов:

03.10.2025

Fri, 03 Oct 2025 00:00:00 +0000

03.10.2025

Изменили XSD-схему предложения об аннулировании для поддержки трансграничного электронного документооборота (ТЭДО). Теперь предложение об аннулировании может содержать сведения об иностранном лице, не состоящем на учете в налоговых органах в качестве налогоплательщика.

Версия формата не изменилась. Актуальную XSD-схему можно скачать на странице метода GenerateRevocationRequestXml (V2).

07.10.2025

Tue, 07 Oct 2025 00:00:00 +0000

07.10.2025

SDK: C# 2.58.0

Добавили возможность указывать третий реквизит МЧД при генерации титула и подготовке документа к подписанию. Для этого добавили реквизит RepresentativeInn в XSD-схемы для генерации титулов документов и данных подписанта.

Актуальные XSD-схемы можно скачать в разделе XSD-схемы или получить с помощью метода GetDocumentTypes (V2) — инструкция на странице Получение информации о типе документа. Подробнее об универсальном подписанте в разделе Универсальный формат заполнения данных подписанта.

09.10.2025

Thu, 09 Oct 2025 00:00:00 +0000

09.10.2025

Реализовали возможность создателю шаблона получать информацию об отказе в подписи по документу, созданному на основе шаблона. Для этого:
- Внесли изменения в структуру Entity:
  - добавили новый тип вложения AttachmentType = TemplateTransformationChange: сущность с таким типом будет содержать информацию об изменении документа, созданного на основе шаблона.
  - добавили поле TemplateTransformationChangeInfo, содержащее информацию об изменении документа, созданного на основе шаблона в виде новой структуры TemplateTransformationChangeInfo.
- Внесли изменения в структуру TemplateTransformationInfo:
  - добавили поле Changes, содержащее информацию об изменении документа, созданного на основе шаблона, в виде новой структуры TemplateTransformationChangeInfo.
Инструкция по получению информации об отказе в подписи по документу, созданному на основе шаблона, приведена в разделе Получение информации об изменениях в документах, созданных на основе шаблона.

30.10.2025

Thu, 30 Oct 2025 00:00:00 +0000

30.10.2025

SDK: C# 2.62.0

В API Диадока отмечен устаревшим и запланирован к удалению метод ExtendedSignerDetails (POST). Теперь он возвращает в ответе заголовки Sunset и Link. Подробнее на странице Политика устаревания.

Он будет удален из API после 01 декабря 2025.

Если вы используете этот метод API в своих интеграционных решениях, удалите его.

17.11.2025

Mon, 17 Nov 2025 00:00:00 +0000

17.11.2025

API Диадока полностью перешел на работу с МЧД по трем реквизитам. В связи с обязательностью поля RepresentativeInn в структуре PowerOfAttorneyFullId изменилось поведение следующих методов:
- Версии методов, которые перестали работать:
- AddEmployeePowerOfAttorney — вместо него рекомендуем использовать AddEmployeePowerOfAttorney (V2)
- DeleteEmployeePowerOfAttorney — вместо него рекомендуем использовать DeleteEmployeePowerOfAttorney (V2)
- PrevalidatePowerOfAttorney — вместо него рекомендуем использовать PrevalidatePowerOfAttorney (V2)
- UpdateEmployeePowerOfAttorney — вместо него рекомендуем использовать UpdateEmployeePowerOfAttorney (V2)
- Методы, для которых теперь возвращается код ответа 400 (Bad Request), если в запросе не передать реквизит RepresentativeInn:
- Методы, для которых теперь возвращается код ответа 400 (Bad Request), если в UserDataXsd не передать реквизит RepresentativeInn:

24.11.2025

Mon, 24 Nov 2025 00:00:00 +0000

24.11.2025

Поддержали обновленные изменения в постановлении Правительства РФ от 30.11.2022 N 2173. Для этого изменили проверку документов, содержащих информацию об алкогольной продукции, подлежащей маркировке.

Теперь для документов, у которых ИдФайл содержит N4=1, действуют следующие проверки:
- Сведения о перевозочных документах. Если в ИдФайл N3=1 и N4=1, тогда должно выполняться одно из условий:
- В поле ИнфПолФХЖ1 есть вложенное поле ТекстИнф со значением Идентиф="НомерПеревозЭлДок".
- В поле ИнфПолФХЖ1 одновременно есть вложенные поля:
  - ТекстИнф со значением Идентиф="НомерПеревозДок",
  - ТекстИнф со значением Идентиф="ДатаПеревозДок".
- Сведения об адресе ФИАС ИД. Если в ИдФайл N3=1 и N4=1, тогда должно выполняться одно из условий:
- Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — юридическое лицо (СвЮЛУч), то обязательно должны быть указаны ИНН и КПП в ГрузОт(СвПрод)/ГрузПолуч(СвПокуп).
- Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — индивидуальный предприниматель (СвИП), то при заполнении адреса в формате АдрРФ в поле ИнфПолФХЖ1 должны быть указаны следующие значения:
  - для грузоотправителя — поле ТекстИнф со значением Идентиф="Продавец_ФиасИД" и "Значен"=<ГУИД 36 знаков>,
  - для грузополучателя — поле ТекстИнф со значением Идентиф="Покупатель_ФиасИД" и "Значен"=<ГУИД 36 знаков>.

25.11.2025

Tue, 25 Nov 2025 00:00:00 +0000

25.11.2025

SDK: C# 2.67.0

Добавили возможность получать информацию об отправителе универсального сообщения. Для этого в структуру UniversalMessageInfo добавили новое поле UniversalMessageCreator, которое хранит данные отправителя.

01.12.2025

Mon, 01 Dec 2025 00:00:00 +0000

01.12.2025

Добавили возможность получать дополнительную информацию об организации. Теперь структура Organization содержит новые поля:
- OrganizationType — тип организации;
- IsOwner — признак того, что интегратор, выполнивший запрос, является владельцем этой организации.

17.12.2025

Wed, 17 Dec 2025 00:00:00 +0000

17.12.2025

Повысили информационную безопасность в API Диадока. Для этого:
- добавили новое значение SecurityInspection для внешнего статуса обработки подозрительных документов — значение возвращается в структурах OuterDocflowInfo, OuterDocflow и OuterDocflowEntities;
- ввели ограничения на передаваемые форматы неформализованных документов — перечень допустимых к отправке расширений доступен в разделе Список допустимых расширений;
- запретили отправку подозрительных файлов — теперь документ не будет доставлен получателю, если Диадок распознает в отправляемом документе зашифрованный архив или расширение, не соответствующее списку допустимых расширений. В этом случае внешний статус обработки документа примет значение SecurityInspection. Информация о внешнем статусе подозрительного документа приведена в разделе Обработка подозрительного файла.
Меры безопасности в отношении документов и рекомендации при обнаружении вредоносного ПО приведены в разделе Информационная безопасность.

18.12.2025

Thu, 18 Dec 2025 00:00:00 +0000

18.12.2025

SDK: C# 3.0.0 | Java 5.0.0

Удалили из API Диадока методы GenerateForwardedDocumentPrintForm и GenerateForwardedDocumentProtocol (V2) согласно Политике устаревания.

26.12.2025

Fri, 26 Dec 2025 00:00:00 +0000

26.12.2025

SDK: C# 3.5.0

С 01 января 2026 года, согласно законопроекту № 1026190-8, изменятся ставки НДС:
- для КС-2 формата приказа №691 можно будет использовать значения 16.67, 18.03, 20, 22, 20/120 и 22/122;
- для документов форматов УПД, УКД, ТОРГ-2, счета на оплату и счета-оферты будут доступны ставки 16.67, 18, 18.03, 20, 22, 18/118, 20/120 и 22/122;
- будут использоваться запятые вместо точек в существующих значениях ставок: вместо 9.09 и 16.67 будут использоваться 9,09 и 16,67.
В связи с этим добавили в API Диадока возможность с 01 января 2026 года работать с новыми налоговыми ставками в версиях следующих форматов документов:
- УПД формата приказа №970 (utd970_05_03_01) — в поле НалСт,
- УКД формата приказа №736 (ucd736_05_01_02) — в полях НалСтДо и НалСтПосле,
- КС-2 формата приказа №691 (performedworkacceptancecertificate691_01_00_01) — в полях НалСтПостр, СумПоСтавке, НалСт,
- Счет на оплату формата приказа №29 (proformainvoice29_05_01_01) — в поле НалСт,
- Счет-оферта формата приказа №29 (invoiceoffer29_05_01_01) — в поле НалСт,
- ТОРГ-2 формата приказа №423 (torg2_05_01_01) — в поле СтавНДСПрин.
Версии форматов не изменились, актуальные XSD-схемы можно получить с помощью метода GetDocumentTypes (V2) — инструкция на странице Получение информации о типе документа.

Обновите интеграционные решения для работы с новыми налоговыми ставкам.

01.01.2026

Thu, 01 Jan 2026 00:00:00 +0000

01.01.2026

Диадок прекратил обмен товарными накладными формата приказа №551 и актами о выполнении работ/оказании услуг формата приказа №552 согласно Приказу ФНС России от 20.01.2025 N ЕД-7-26/28@.

Теперь в API Диадока стало невозможно подготовить к подписанию и отправить первые титулы актов и товарных накладных ТОРГ-12 с версиями:
- tovtorg_05_02_01,
- tovtorg_05_01_04,
- tovtorg_05_01_03,
- tovtorg_05_01_02,
- rezru_05_02_01,
- rezru_05_01_02,
- rezru_05_01_01.
Отправить такие документы теперь можно будет только в формате приказа №970 или в неформализованном виде.

В связи с этим в API Диадока внесены следующие изменения:
- метод GetDocumentTypes (V2) возвращает информацию о перечисленных версиях с параметром IsActual = false;
- методы PrepareDocumentsToSign, PostMessage (V3) и PostTemplate больше не поддерживают работу с первыми титулами перечисленных версий.
Обратите внимание, что если документы формата приказа №551/552 были переданы до 31 декабря 2025 года включительно, то документооборот по ним можно завершить после 1 января 2026 года.

Актуальные XSD-схемы можно скачать в разделе XSD-схемы или получить с помощью метода GetDocumentTypes (V2) — инструкция на странице Получение информации о типе документа.

12.01.2026

Mon, 12 Jan 2026 00:00:00 +0000

12.01.2026

Добавили возможность выполнять поиск удаленных документов. Для этого добавили в метод GetDocuments (V3) новое значение фильтра Deleted для получения документов, помеченных удаленными.

13.01.2026

Tue, 13 Jan 2026 00:00:00 +0000

13.01.2026

SDK: C# 3.4.0 | Java 5.1.0

Выпустили обновление Библиотеки .NET/COM со следующими изменениями:
- Добавили структуры для работы с документами:
  - AmendmentRequestDocflowV4
  - ConfirmationDocflowV4
  - DocflowEventV4
  - DocflowV4
  - DocumentWithDocflowV4
  - FetchedDocumentV4
  - GetDocflowBatchResponseV4
  - GetDocflowsByPacketIdResponseV4
  - GetDocflowEventsResponseV4
  - MessagePatchToPostV2
  - ParticipantResponseDocflowV4
  - ReceiptDocflowV4
  - RevocationDocflowV4
  - RevocationResponseDocflowV4
  - SearchDocflowsResponseV4
  - SignatureRejectionDocflowV4
- Добавили структуры для работы с универсальными сообщениями:
  - UniversalMessageAttachmentDocflow
  - UniversalMessageCodeGroup
  - UniversalMessageEvent
  - UniversalMessageInfo
Рекомендуем использовать в интеграционных решениях новую версию Библиотеки .NET/COM в ветке master.
Выпустили обновление Java SDK со следующими изменениями:
- Добавили в структуру UniversalMessageInfo новое поле UniversalMessageCreator, которое хранит данные отправителя универсального сообщения.
- Добавили метод ParseUniversalMessage, с помощью которого можно парсить файл универсального сообщения.
- Добавили метод GetDocumentTypesV3, с помощью которого можно получить доступные типы документов.
Рекомендуем использовать в интеграционных решениях новую версию Java SDK в ветке master.

16.01.2026

Fri, 16 Jan 2026 00:00:00 +0000

16.01.2026

SDK: Java 5.1.0

Реализовали возможность получать дату перехода на универсальные сообщения. Для этого внесли следующие изменения:
- Добавили новую версию структуры DocumentTypeDescriptionV3 с полем UniversalMessagesStartDate для хранения даты перехода на универсальные сообщения.
- Добавили новую версию метода GetDocumentTypes (V3), с помощью которой можно получить доступные типы документов в виде новой структуры DocumentTypeDescriptionV3.

30.01.2026

Fri, 30 Jan 2026 00:00:00 +0000

30.01.2026

Обновили XSD-схему КС-2 формата приказа №691 согласно изменениям в налоговом кодексе ФНС:
- убрали из перечня ставок значения: 9,09, 16,67, 18,03, 5/105, 7/107, 10/110, 20/120 и 22/122.
- исправили проверку присутствия элемента СумНДС: если поле НалСт содержит значения 0, 5, 7, 10, 20 или 22, то обязателен элемент СумНДС.
Теперь в качестве НДС для КС-2 формата приказа №691 можно будет использовать значения 0, 5, 7, 10, 20 и 22.

Версия формата не изменилась. Актуальную XSD-схему можно скачать в разделе XSD-схемы или получить с помощью метода GetDocumentTypes (V3) — инструкция на странице Получение информации о типе документа.

16.01.2026

Перенесли срок удаления устаревших методов ShelfUpload и ShelfDownload: они будут удалены из API после 30 сентября 2026.

Методы возвращают в ответе заголовки Sunset и Link. Подробнее на странице Политика устаревания.

Если вы используете эти методы в своих интеграционных решениях, замените их на более актуальные версии:
- старый метод ShelfUpload замените на методы:
  - ShelfUpload (V2) — при загрузке документа целиком;
  - ShelfUploadPartInit и ShelfUploadPart — при загрузке документа по частям;
- старый метод ShelfDownload замените на метод ShelfDownload (V2).
Подробнее про использование методов — в разделе Работа с полкой документов.

02.02.2026

Mon, 02 Feb 2026 00:00:00 +0000

02.02.2026

SDK: C# 3.8.0 | Java 5.2.0

Удалили из API и SDK методы и структуры для автоподписания извещений и получении:
- метод AutoSignReceipts
- метод AutoSignReceiptsResult
- структура AutoSignReceiptsResult

27.02.2026

Fri, 27 Feb 2026 00:00:00 +0000

27.02.2026

SDK: C# 3.13.0

Добавили новое поле IsCrossBorder в структуру DocumentParticipants: оно показывает, участвует ли документ в трансграничном документообороте (ТЭДО).

02.03.2026

Mon, 02 Mar 2026 00:00:00 +0000

02.03.2026

SDK: C# 3.16.0 | Java 5.6.0

Добавили новую версию метода для поиска документов — GetDocuments (V4): она принимает в качестве тела запроса новую структуру GetDocumentsV4Request, в которой нужно указать параметры для поиска документов.

В отличие от прежней версии GetDocuments (V3), новая версия метода позволяет указывать для поиска документов дополнительные данные:
- список идентификаторов контрагентов и подразделений вместо одного;
- список номеров документов вместо одного;
- имена файлов;
- итоговые суммы в документе и их диапазон;
- пользовательские данные.

06.03.2026

Fri, 06 Mar 2026 00:00:00 +0000

06.03.2026

SDK: C# 3.14.0 | Java 5.7.0

Реализовали возможность определять тип отказа в подписи, требуемый для конкретного типа документа. Для этого в структуру DocumentVersionV2 добавили новое поле RejectionType, которое принимает значения из нового перечисления SupportedRejectionType. По значению этого поля можно определить, какой отказ в подписи необходимо сформировать: отказ в виде универсального сообщения или особый вид отказа для трансграничного документооборота (ТЭДО).

11.03.2026

Wed, 11 Mar 2026 00:00:00 +0000

11.03.2026

SDK: C# 3.19.1 | Java 5.9.0

Добавили возможность указывать признак влияния универсального сообщения (УС) на статус документооборота при отправке дополнения к сообщению. Для этого в структуру UniversalMessageAttachment добавили новое поле Behaviour, которое принимает значения из нового перечисления UniversalMessageBehaviour.

Обратите внимание, что во время переходного периода все служебные документы влияют на статус документооборота. Возможность отправлять УС со значением Behaviour = DoesNotAffectWorkflow станет доступна только после окончания переходного периода.

12.03.2026

Thu, 12 Mar 2026 00:00:00 +0000

12.03.2026

SDK: C# 3.18.0 | Java 5.8.2

Отметили устаревшими и запланировали к удалению ряд методов. Теперь они возвращают в ответе заголовки Sunset и Link с информацией о дате выключения. Структуры, используемые исключительно этими методами, также перенесли в раздел Удаляемые методы и структуры. Подробнее на странице Политика устаревания.
- Будут удалены после 10 ноября 2026 года:
- Будут удалены после 30 ноября 2026 года:
- Будут удалены после 3 апреля 2027 года:
Если вы используете перечисленные методы API в своих интеграционных решениях, рекомендуем удалить их и перейти на использование актуальных версий.