Диадок API

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 в своих интеграционных решениях, рекомендуем удалить их и перейти на использование актуальных версий.

27.04.2026

Mon, 27 Apr 2026 00:00:00 +0000

27.04.2026

Реализовали возможность генерации электронной транспортной накладной (ЭТрН). Для этого в перечисление DocumentTitleType добавили новые значения:
- LogisticsOrderRequest108 — титул грузоотправителя (Т1) заказа-заявки.
- LogisticsWaybillReception1065Sender — титул грузоотправителя (Т1) транспортной накладной.
- LogisticsWaybillReception1065Recipient — титул перевозчика о приеме груза (Т2) транспортной накладной.
- LogisticsWaybillDelivery1065Sender — титул грузополучателя (Т3) транспортной накладной.
- LogisticsWaybillDelivery1065Recipient — титул перевозчика о выдаче груза (Т4) транспортной накладной.
- LogisticsWaybillConsignorCost1065 — титул грузоотправителя о стоимости (Т6) транспортной накладной.
- LogisticsWaybillCarrierCost1065 — титул перевозчика о стоимости (Т5) транспортной накладной.
- LogisticsWaybillReaddress1065 — титул переадресации (Т7) транспортной накладной.
- LogisticsWaybillRelay1065 — титул эстафеты (Т8) транспортной накладной.

Инструкция по работе с ЭТрН приведена на странице Работа с ЭТрН.

28.04.2026

Tue, 28 Apr 2026 00:00:00 +0000

28.04.2026

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

30.04.2026

Thu, 30 Apr 2026 00:00:00 +0000

30.04.2026

С 01 сентября 2026 года команда разработки прекращает развитие и техническую поддержку внешней компоненты и COM-интерфейса SDK C# (ComDiadocApi). Если вы используете их, рекомендуем ознакомиться с актуальными вариантами интеграции и выбрать подходящий для вашего интеграционного решения.

Обратите внимание, что SDK C# продолжает поддерживаться: изменения касаются только компоненты для работы через COM-интерфейс.

01.05.2026

Fri, 01 May 2026 00:00:00 +0000

01.05.2026

SDK: C# 3.21.0 | Java 5.11.0

Для технологических партнеров реализовали возможность получить состояние документов на момент предыдущего события. Для этого:
- Добавили в структуру GetPartnerEventsRequest поле PopulatePreviousDocumentStates с признаком того, что в результат нужно включить полное состояние документа на момент предыдущего события.
- Добавили в структуру GetPartnerEventsResponse поле PreviousDocumentState, содержащее информацию о документе и состоянии его документооборота до возникновения данного события в виде структуры DocumentWithDocflowV4.

15.05.2026

Fri, 15 May 2026 00:00:00 +0000

15.05.2026

SDK: C# 3.24.0 | Java 5.13.0

Добавили возможность подписывать файлы с помощью Госключа. Для этого реализовали следующие изменения:
- Добавили новую версию метода DssSign (V2), которая поддерживает подписание файлов с помощью Госключа.
- Добавили новую структуру DssSignRequestV2, которая используется для передачи данных Госключа в метод подписания.
- Расширили перечисление DssConfirmType, добавив новое значение GosKey — оно будет возвращаться в случае подписания файлов Госключом.
Новая версия метода DssSign (V2) так же, как и прежняя версия, поддерживает подписание файлов сертификатом без носителя.

26.05.2026

Tue, 26 May 2026 00:00:00 +0000

26.05.2026

SDK: C# 3.26.0 | Java 5.16.0

Реализовали возможность получать информацию о готовности организаций обмениваться ЭПД. Для этого в структуру Organization добавили новое поле ReadyForEpdStatus со статусом готовности организации к обмену ЭПД в виде значений перечисления ReadyForEpdStatus.

Обратите внимание, что поле носит информационный характер и не блокирует отправку ЭПД организациям.

Изменить значение статуса можно только через веб-интерфейс — в разделе настроек реквизитов организации. В API возможность изменения статуса не реализована.

27.05.2026

Wed, 27 May 2026 00:00:00 +0000

27.05.2026

Реализовали возможность генерации титулов грузоотправителя (Т1) и перевозчика (Т2) для заказов-заявок.

Инструкция по работе с заказами-заявками приведена на странице Работа с заказами-заявками. Актуальные схемы XSD и UserDataXsd можно скачать в разделе XSD-схемы.

Почтовые уведомления об информационных сообщениях

Fri, 29 May 2026 00:00:00 +0000

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

Множественная отправка универсальных сообщений

Fri, 29 May 2026 00:00:00 +0000

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

Работа с перевозочными документами

Fri, 29 May 2026 00:00:00 +0000

description:: Добавили инструкции для работы с ЭТрН, ЭПЛ и заказом-заявкой.

03.06.2026

Wed, 03 Jun 2026 00:00:00 +0000

03.06.2026

Добавили возможность отличать физических лиц (ФЛ) от юридических лиц или индивидуальных предпринимателей. Для этого в структуре Organization сделали следующие изменения:
- для поля OrganizationType добавили значение PhysicalPerson;
- для поля HasCertificateToSign добавили логику, что для ящиков типа PhysicalPerson оно всегда принимает значение true.
Инструкция по работе с ФЛ приведена на странице Документооборот с физическими лицами.

04.06.2026

Thu, 04 Jun 2026 00:00:00 +0000

04.06.2026

SDK: C# 3.30.0 | Java 5.20.0

Реализовали возможность работать с правами пользователя на подписание документов сертификатом «Госключ». Для этого внесли следующие изменения:
- В структуру OrganizationUserPermissions добавили новое поле CanUseGoskeyFL, которое показывает, может ли пользователь использовать для подписания документов сертификат «Госключ» физического лица. Структуру OrganizationUserPermissions можно получить с помощью метода GetOrganizationUsers (V2).
- В структуру EmployeeAction добавили новое значение UseGoskey для поля Name. Оно означает, что пользователь может использовать для подписания документов сертификат «Госключ» физического лица. Структуру можно передать в методы CreateEmployee и UpdateEmployee. Получить структуру можно с помощью методов GetEmployee, GetMyEmployee и GetEmployees.
Таким образом, чтобы установить права на подписание документов сертификатом «Госключ», нужно передать значение UseGoskey в поле Name структуры EmployeeAction в методах:
- CreateEmployee — для нового пользователя,
- UpdateEmployee — для существующего пользователя.
Получить информацию о праве на подписание документов сертификатом «Госключ» можно с помощью методов:
- GetOrganizationUsers (V2) — в структуре OrganizationUserPermissions,
- GetEmployee, GetMyEmployee и GetEmployees — в структуре EmployeeAction.
Обратите внимание, что теперь подписание документов с помощью сертификата «Госключ» методом DssSign (V2) доступно только при установленном праве на использование такого сертификата.

Кроме этого входной параметр includeGoskeyCertificates метода GetMyCertificates будет влиять на работу метода только в случае, если у авторизованного пользователя в указанном ящике установлено право «Использовать УКЭП Госключ».

03.06.2026

SDK: C# 3.29.0 | Java 5.19.0

Добавили возможность определять, работает ли участник документооборота через роуминг. Для этого в структуру DocumentParticipant добавили поле IsRoaming. В нем возвращается признак того, что организация подключена к другому оператору ЭДО.

03.06.2026

SDK: C# 3.22.0 | Java 5.12.0

Реализовали возможность отслеживать события безопасности в ящике. Для этого добавили новый метод GetSecurityEvents для получения списка таких событий. Метод возвращает в ответе новую структуру SecurityEventList, где поле Details содержит дополнительную техническую информацию о событии, например Comment: Malware link found.

03.06.2026

SDK: C# 3.28.0 | Java 5.18.0

Реализовали возможность получать информацию о сертификатах «Госключ» для пользователя. Для этого внесли следующие изменения:
- Изменили метод GetMyCertificates: теперь он может принимать на вход параметр includeGoskeyCertificates. Если этот параметр имеет значение true, то метод включит в ответ сертификаты «Госключ» авторизованного пользователя, который вызвал метод. Сам метод, как и прежде, возвращает в ответе структуру CertificateList со списком сертификатов.
- Добавили новое значение Goskey в перечисление CertificateType: оно возвращается в поле Type структуры CertificateInfoV2 для сертификатов «Госключ».
Обратите внимание, что поле Type в структуре CertificateInfoV2 является обязательным и заполняется значением из перечисления CertificateType: в это перечисление добавлено новое значение Goskey. Если вы самостоятельно пишете интеграционное решение, убедитесь, что эти изменения не нарушат его работу.

05.06.2026

Fri, 05 Jun 2026 00:00:00 +0000

05.06.2026

Добавили возможность определять, что документ или сообщение удалены из-за вредоносного ПО. Теперь при вызове методов GetDocument (V3) и GetMessage (V6):
- Если документ или сообщение удалены из-за вредоносного ПО, методы возвращают ошибку 410 (Gone). В заголовке ответа X-Diadoc-ErrorCode будет содержаться значение DocumentIsPurgedDueToMalware или MessageIsPurgedDueToMalware.
- Если документ или сообщение удалены по иным причинам, методы возвращают ошибку 404 (Not Found). В заголовке ответа X-Diadoc-ErrorCode будет содержаться значение DocumentIsPurged или MessageIsPurged.
Меры безопасности и рекомендации при обнаружении вредоносного ПО приведены в разделе Информационная безопасность.

09.06.2026

Tue, 09 Jun 2026 00:00:00 +0000

09.06.2026

SDK: C# 3.31.0 | Java 5.21.0

Добавили возможность загружать на полку документов данные большего размера за один запрос. Для этого в методах ShelfUpload (V2), ShelfUploadPartInit и ShelfUploadPart увеличили лимит размера документов и их фрагментов с 512 КБ до 3 МБ.

Подробнее про загрузку документов на полку в разделе Работа с полкой документов.

Документооборот с физическими лицами

Mon, 15 Jun 2026 00:00:00 +0000

description:: В API Диадока появилась возможность отправлять документы физическим лицам.

25.06.2026

Thu, 25 Jun 2026 00:00:00 +0000

25.06.2026

Реализовали возможность генерации титула грузоотправителя о стоимости (Т6) для электронной транспортной накладной (ЭТрН).

Инструкция по работе с ЭТрН приведена на странице Работа с ЭТрН. Актуальные схемы XSD и UserDataXsd можно скачать в разделе XSD-схемы.

26.06.2026

Fri, 26 Jun 2026 00:00:00 +0000

26.06.2026

SDK: C# 3.33.0 | Java 5.22.0

Удалили из API и SDK методы для работы с МЧД по двум реквизитам согласно Политике устаревания:
- AddEmployeePowerOfAttorney
- DeleteEmployeePowerOfAttorney
- PrevalidatePowerOfAttorney
- UpdateEmployeePowerOfAttorney

30.06.2026

Tue, 30 Jun 2026 00:00:00 +0000

30.06.2026

SDK: C# 3.35.0

Реализовали поддержку многотитульных документооборотов. Теперь количество титулов для документа не является фиксированным и определяется его типом и видом документооборота. Для этого внесли следующие изменения:
- Документооборот каждого титула представлен новой структурой TitleDocflow в массиве Titles структуры DocflowV5. Массив содержит элементы для всех титулов документа — как для уже полученных, так и для тех, которые требуется и возможно отправить. Для ожидаемого титула заполняются только TitleIndex, Author и AuthorSigning (с IsFinished = false и Status = TitleAuthorStatusWaiting), а Version и Title не заполняются.
- В структуру RecipientTitleAttachment добавили поле TitleIndex — числовой идентификатор титула, нумерация с нуля. Позволяет явно указать индекс титула при отправке ответного титула через метод PostMessagePatch (V4).
- Добавили новую версию метода GetDocflows (V5): теперь с его помощью можно получить документы с информацией о документообороте по списку идентификаторов. Метод возвращает новую структуру GetDocflowBatchResponseV5, в поле Documents которой находится список структур DocumentWithDocflowV5.
- Добавили новую версию метода SearchDocflows (V5): теперь с ее помощью можно выполнить поиск документов с информацией о документообороте. Метод возвращает новую структуру SearchDocflowsResponseV5, в поле Documents которой находится список структур DocumentWithDocflowV5.
- Добавили новую версию метода GetDocflowsByPacketId (V5): теперь с ее помощью можно получить документы с информацией о документообороте. Метод возвращает новую структуру GetDocflowsByPacketIdResponseV5, в поле Documents которой находится список структур DocumentWithDocflowV5.
- Добавили новую версию метода GetDocflowEvents (V5): теперь с ее помощью можно получить ленту событий по документообороту. Метод возвращает новую структуру GetDocflowEventsResponseV5. Каждое событие в поле Events представлено новой структурой DocflowEventV5 с полями Document и PreviousDocumentState, в которых хранится информация о документе и состоянии его документооборота в виде структуры DocumentWithDocflowV5.
Прежние версии методов GetDocflows (V4), SearchDocflows (V4), GetDocflowsByPacketId (V4) и GetDocflowEvents (V4) продолжают работать и возвращают DocumentWithDocflowV4.

Методы GetDocument (V3), GetDocuments (V3) и GetDocumentsByMessageId по-прежнему возвращают структуры Document и DocumentList с участниками в полях SenderBoxId, ProxyBoxId и RecipientBoxId и не поддерживают многотитульные документы.

Инструкция по работе с многотитульными документами приведена на странице Многотитульные документы.

Мы будем развивать функциональность API для работы с многотитульными документами: следите за обновлениями в истории изменений.

01.07.2026

Wed, 01 Jul 2026 00:00:00 +0000

01.07.2026

Добавили возможность автоматически устанавливать партнерские отношения с контрагентами, у которых есть настройка ящика Sociability = AllOrganizations. Теперь при отправке приглашения в их адрес:
- Приглашение без запроса подписи, независимо от наличия вложения, принимается автоматически. В ленте событий по контрагентам у отправителя появится событие IMadeCounteragent, а у получателя — CounteragentMadeMe. При наличии вложения контрагент также получит документ типа TrustConnectionRequest со статусом «Документооборот завершен».
- Приглашение с запросом подписи и вложением по-прежнему требует явной обработки от контрагента. В этом сценарии ничего не меняется: события в ленте событий по контрагентам остаются прежними.
Изменили значение свойства Sociability по умолчанию при создании ящиков: теперь вместо AllOrganizations будет CounteragentsOnly, то есть созданная организация примет документы только от контрагентов с партнерскими отношениями. Управлять этой настройкой можно в веб-интерфейсе Диадока в разделе «Реквизиты организации».