История изменений

Подписывайтесь на новости об изменениях API:

09.10.2025

  • Реализовали возможность создателю шаблона получать информацию об отказе в подписи по документу, созданному на основе шаблона. Для этого:

    • Внесли изменения в структуру Entity:

      • добавили новый тип вложения AttachmentType = TemplateTransformationChange: сущность с таким типом будет содержать информацию об изменении документа, созданного на основе шаблона.

      • добавили поле TemplateTransformationChangeInfo, содержащее информацию об изменении документа, созданного на основе шаблона в виде новой структуры TemplateTransformationChangeInfo.

    • Внесли изменения в структуру TemplateTransformationInfo:

      • добавили поле Changes, содержащее информацию об изменении документа, созданного на основе шаблона, в виде новой структуры TemplateTransformationChangeInfo.

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

07.10.2025

SDK: C# 2.58.0

03.10.2025

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

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

02.10.2025

01.10.2025

SDK: C# 2.56.0 | Java 4.15.1

08.09.2025

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

    Теперь для документов, у которых ИдФайл содержит N4=1, будут действовать следующие проверки:

    • Сведения о перевозочных документах. Если в ИдФайл N3=1 и N4=1, тогда должно выполняться одно из условий:

    • В поле ИнфПолФХЖ1 есть вложенное поле ТекстИнф со значениями Идентиф="НомерПеревозЭлДок" и "Значен"=<ГУИД 36 знаков>.

    • В поле ИнфПолФХЖ1 одновременно есть вложенные поля:

      • ТекстИнф со значением Идентиф="НомерПеревозДок" и поле "Значен" не пустое,

      • ТекстИнф со значением Идентиф="ДатаПеревозДок" и поле "Значен" содержит значение в формате Дата,

      • ТекстИнф может не содержать Идентиф="РегНомер". Если заполнен Идентиф="РегНомер", то в поле "Значен" содержится символьная строка (допустимо поставить прочерк).

    • Сведения об адресе ФИАС ИД. Если в ИдФайл N3=1 и N4=1, тогда в качестве грузоотправителя и грузополучателя могут быть указаны только ЮЛ (СвЮЛУч) или ИП (СвИП):

    • Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — юридическое лицо, то обязательно должны быть указаны ИНН и КПП в ГрузОт(СвПрод)/ГрузПолуч.

    • Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — индивидуальный предприниматель, то должно выполняться одно из условий:

      • адрес заполнен в формате ГАР (используется АдрГАР),

      • адрес заполнен в формате АдрРФ и в поле ИнфПолФХЖ1 указаны:

        • для грузоотправителя — поле ТекстИнф со значением Идентиф="Продавец_ФиасИД" и "Значен"=<ГУИД 36 знаков>,

        • для грузополучателя — поле ТекстИнф со значением Идентиф="Покупатель_ФиасИД" и "Значен"=<ГУИД 36 знаков>.

Примечание

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

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

28.08.2025

SDK: C# 2.40.0

  • Реализовали возможность работы с адресной системой ФИАС. Для этого внесли следующие изменения:

    • Добавили в структуру Address поле GarAddress, которое хранит адрес объекта в государственном адресном реестре (ГАР) в виде новой структуры GarAddress.

    • Добавили метод ParseGarAddress, с помощью которого можно получить адрес объекта в ГАР.

28.08.2025

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

22.08.2025

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

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

    • теперь метод генерации GenerateUniversalMessage работает с форматом 5.01,

    • актуальная XSD-схема универсального сообщения с ВерсФорм=5.01 приведена в разделе XSD-схемы.

18.08.2025

SDK: C# 2.50.0 | Java 4.12.0

  • Изменили поля для получения времени жизни МЧД. Для этого внесли изменения в структуру PowerOfAttorney:

    • добавили поля StartAtByMoscow и ExpireAtByMoscow, которые хранят дату начала и окончания действия МЧД в московском часовом поясе в виде новой структуры DateTimeOffset,

    • отметили устаревшими поля StartAt и ExpireAt, которые хранят дату начала и окончания действия МЧД в UTC.

    Для работы со временем жизни МЧД рекомендуем использовать новые поля StartAtByMoscow и ExpireAtByMoscow.

08.08.2025

SDK: C# 2.47.0 | Java 4.10.0

31.07.2025

  • Реализовали изменения в API Диадока согласно письму от ФНС №ЕА-4-26/6254@ от 30.06.2025, а именно для УПД формата приказа №970 внесли следующие изменения:

    • изменили XSD и UserDataXsd схемы:

      • размер атрибутов НомерСчета и КорСчет увеличили до 34 символов,

      • размер атрибута НаимРегион увеличили до 51 символа,

    • изменили проверку атрибута КодПроисх — теперь он всегда необязательный.

    Внесенные изменения касаются в том числе настроек редактирования.

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

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

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.

09.07.2025

SDK: C# 2.42.0 | Java 4.7.0

04.07.2025

SDK: C# 2.43.0 | Java 4.6.0

  • Реализовали предварительную проверку машиночитаемой доверенностью (МЧД) по трем реквизитам. Для этого:

    • Изменили структуру PowerOfAttorneyFullId: теперь поле RepresentativeInn является обязательным.

    • Добавили новую версию структуры PowerOfAttorneyPrevalidateRequestV2 с полем FullId для хранения идентификатора МЧД в виде обновленной структуры PowerOfAttorneyFullId.

    • Добавили новую версию метода PrevalidatePowerOfAttorney (V2), которая работает с МЧД по трем реквизитам.

25.06.2025

SDK: C# 2.44.0

16.06.2025

05.06.2025

SDK: C# 2.41.0 | Java 4.5.0

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

12.05.2025

SDK: C# 2.38.0 | Java 4.4.0

24.04.2025

SDK: C# 2.37.0 | Java 4.3.0

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

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

17.04.2025

  • Изменили условия заполнения реквизита «Цена» в текущей версии УПД формата приказа №970 (utd970_05_03_01) — в поле ЦенаТов.

    Теперь для УПД с функцией ДОП поле ЦенаТов может принимать значение 0 и более.

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

01.04.2025

  • Диадок прекратил обмен первыми титулами документов с версией 5.01, утвержденной Приложением №2 приказа ФНС № 970.

    Теперь в API Диадока стало невозможно подготовить к подписанию и отправить первые титулы УПД, счетов-фактур, исправлений УПД, исправлений счетов-фактур, актов и товарных накладных ТОРГ-12 с версиями:

    • utd820_05_01_01,

    • utd820_05_01_01_hyphen,

    • utd820_05_01_02_hyphen,

    • utd820_05_01_03_hyphen.

    Отправить такие документы теперь можно будет только в версии 5.03 в соответствии с Приложением №1 приказа ФНС № 970.

    В связи с этим в API Диадока внесены следующие изменения:

    Обратите внимание, что если первый титул был передан до 1 апреля в версии 5.01, то ответить на него после 1 апреля нужно вторым титулом той же версии.

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

27.03.2025

  • Изменили условия заполнения реквизитов «Количество» и «Цена» в текущей версии УПД формата приказа №970 (utd970_05_03_01) — в полях КолТов и ЦенаТов.

    Теперь поле КолТов принимает значение больше нуля, если выполняются оба условия:

    • функция документа СЧФ или СЧФДОП;

    • в качестве единицы измерения указан ОКЕИ_Тов.

    Поле ЦенаТов принимает значение больше нуля, если выполняются оба условия:

    • функция документа СЧФ или СЧФДОП;

    • в документе заполнен реквизит КолТов.

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

13.03.2025

SDK: C# 2.34.0

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

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

10.03.2025

  • В API Диадока поддержали новые налоговые ставки в текущей версии акта об установленном расхождении ТОРГ-2 формата приказа №423 (torg2_05_01_01) — в поле НалСт.

    Теперь в качестве НДС стали доступны ставки 5, 7, 9.09, 16.67, 5/105, 7/107.

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

07.03.2025

SDK: Java 4.0.0

28.02.2025

  • В API Диадока поддержали новые налоговые ставки в версиях следующих форматов документов:

    • Товарная накладная формата приказа №551 (tovtorg551_t1_05_02_01) — в поле НалСт;

    • Акт о выполнении работ/оказании услуг формата приказа №552 (rezru552_t1_05_02_01) — в поле НалСт;

    • КС-2 формата приказа №691 (performedworkacceptancecertificate691_01_00_01) — в поле НалСт;

    • Транспортная накладная формата приказа №1065 (performedworkacceptancecertificate691_01_00_01) — в поле НалСт.

    Теперь в качестве НДС для КС-2 формата приказа №691 можно использовать значения 5 и 7. Для остальных форматов документов стали доступны ставки 5, 7, 9.09, 16.67, 5/105, 7/107.

    Версии форматов не изменились, актуальные XSD-схемы можно получить с помощью метода GetDocumentTypes (V2) — инструкция на странице Получение информации о типе документа. Для документов в формате приказов №551, 552 и 691 актуальные XSD-схемы можно скачать на страницах Документооборот актов и Документооборот накладных.

25.02.2025

24.02.2025

  • Добавили в Диадок новые типы документов для работы с УКД на перемещение и исправлением УПД на перемещение — UniversalCorrectionDocumentInternal и UniversalTransferDocumentInternalRevision соответственно. Инструкция по работе с ними описана на странице Работа с УПД на перемещение.

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

18.02.2025

  • Добавили новые настройки редактирования для следующих типов документов:

    • накладные с версиями utd970_05_03_01 и utd820_05_01_02_hyphen;

    • акты с версиями utd970_05_03_01 и utd820_05_01_02_hyphen.

17.02.2025

10.02.2025

SDK: C# 2.32.0

  • В C# SDK поддержали новые налоговые ставки, которые были добавлены с 1 января 2025 года в текущие версии формата УКД приказа №736 (ucd736_05_01_02) — в поля НалСтДо и НалСтПосле.

    Теперь в качестве НДС можно использовать новые значения 5, 7, 9.09, 16.67.

27.01.2025

  • Поддержали в API Диадока работу с сертификатами, срок действия которых превышает 12 лет. Для этого изменили проверки сертификатов при аутентификации пользователей с помощью метода Authenticate (V3).

22.01.2025

SDK: C# 2.30.0 | Java 3.26.1

22.01.2025

SDK: C# 2.29.0

17.01.2025

SDK: C# 2.31.0 | Java 3.27.0

16.01.2025

14.01.2025

  • Расширили проверки машиночитаемых доверенностей (МЧД): теперь Диадок сообщает не только об успешной проверке или об ошибке, но и о предупреждениях — когда часть проверок не была выполнена или при выполнении обнаружилось неявное несовпадение данных и необязательных полей. Информация о результатах проверки МЧД возвращается в структуре PowerOfAttorneyValidationStatus:

    • в поле ValidationProtocol возвращается протокол валидации, представленный структурой ValidationProtocol,

    • в поле OperationError возвращается ошибка, возникшая при проверке МЧД, представленная структурой PowerOfAttorneyValidationError,

    • в поле StatusNamedId может вернуться значение HasWarnings, означающее, что проверка была пройдена с предупреждениями,

    • поле Errors отмечено устаревшим и не рекомендуется к использованию.

10.01.2025

SDK: C# 2.28.0

  • В C# SDK поддержали новые налоговые ставки, которые были добавлены с 1 января 2025 года в текущие версии следующих форматов документов:

    • УПД и СФ версии 5.01 (utd820_05_01_02_hyphen) — в поле НалСт;

    • УПД и СФ версии 5.02 (utd970_05_02_01) — в поле НалСт.

    Теперь в качестве НДС можно использовать новые значения 5, 7, 9.09, 16.67.

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

09.01.2025

SDK: C# 2.27.0 | Java 3.26.0

  • Реализовали возможность получить информации о доверителях первоначальной (корневой) машиночитаемой доверенности (МЧД). Для этого в структуру PowerOfAttorneyDelegationInfo добавили поле RootIssuers, которое хранит список первоначальных доверителей. Получить ее можно методом GetPowerOfAttorneyInfo. Инструкция описана в разделе Получение цепочки передоверия МЧД.

    Информация о первоначальных (корневых) доверителях может быть полезна в случае, если МЧД была выпущена в порядке передоверия, но Диадок не смог сформировать всю цепочку передоверия.

01.01.2025

  • В API Диадока поддержали новые налоговые ставки, которые были добавлены с 1 января 2025 года в текущие версии следующих форматов документов:

    • УПД и СФ версии 5.01 (utd820_05_01_02_hyphen) — в поле НалСт;

    • УПД и СФ версии 5.02 (utd970_05_02_01) — в поле НалСт;

    • УКД формата приказа №736 (ucd736_05_01_02) — в поля НалСтДо и НалСтПосле.

    Теперь в качестве НДС можно использовать новые значения: 5, 7, 9.09, 16.67.

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

06.12.2024

  • В API Диадока метод GetMessage (V5) теперь возвращает информацию о событиях перемещения сообщения между подразделениями так же, как и метод GetNewEvents (V7).

    Информация о событиях перемещения документа будет хранится в структуре Message в сущности Entities с EntityType = Attachment и AttachmentType = MoveDocument.

25.11.2024

SDK: C# 2.25.0 | Java 3.24.0

  • Обновили методы для работы с полкой документов:

    • добавили новые методы:

      • метод ShelfUploadPartInit загружает первый фрагмент документа на полку при загрузке по частям;

      • метод ShelfUploadPart загружает последующие фрагменты документа на полку при загрузке по частям;

    • добавили новые версии для существующих методов:

      • метод ShelfUpload (V2) теперь нужно использовать вместо устаревшего ShelfUpload — с новой версии он загружает документ на полку целиком;

      • метод ShelfDownload (V2) теперь нужно использовать вместо устаревшего ShelfDownload.

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

    Старые версии методов ShelfUpload и ShelfDownload отмечены устаревшими и запланированы к удалению. Теперь они возвращают в ответе заголовки Sunset и Link. Подробнее на странице Политика устаревания.

    Они будут удалены из API после 30 января 2026.

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

03.11.2024

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

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

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

21.10.2024

  • В API Диадока изменили логику формирования сводного статуса машиночитаемых доверенностей (МЧД) PowerOfAttorneyValidationStatus: теперь алгоритм расчета сводного статуса МЧД не учитывает извещение о получении (ИоП).

    То есть сводный статус будет формироваться на основании всех МЧД, которые были приложены к документу при совершении действий с ним, за исключением ИоП. Правила формирования сводного статуса описаны на странице DocflowStatusV3.

27.09.2024

  • В API Диадока отмечены устаревшими и запланированы к удалению следующие эндпойнты:

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

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

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

    • В ответ на любые запросы эти методы возвращают ошибку 410 (Gone) и не выполняют никаких операций. Если вы завязываете свое интеграционное решение на обработку кода ошибки 410 (Gone), измените эту обработку.

04.09.2024

SDK: C# 2.23.0 | Java 3.22.0

  • Изменили отображение результатов проверки МЧД. Для этого внесли изменения в структуру PowerOfAttorneyValidationStatus:

    • добавили поле ValidationProtocol с типом ValidationProtocol,

    • добавили поле OperationError с типом PowerOfAttorneyValidationError,

    • в перечисление PowerOfAttorneyValidationStatusNamedId добавили значение HasWarnings,

    • поле Errors отметили устаревшим и не рекомендуем его к использованию.

    Эти поля будут заполняться после перехода на новый способ валидации МЧД, который произойдет в середине сентября.

09.08.2024

SDK: C# 2.22.0 | Java 3.21.0

  • Расширили структуру CertificateInfoV2, чтобы предоставить возможность определять тип используемого сертификата:

    • добавили поле Usages, которое хранит тип сертификата,

    • добавили поле DssType, которое хранит тип мобильного сертификата.

18.07.2024

SDK: C# 2.20.1 | Java 3.20.2

  • Реализовали возможность проверки приложенности машиночитаемой доверенности (МЧД) к подписи (подробно в инструкции Работа с машиночитаемой доверенностью):

    • добавили структуру PowerOfAttorneyAttachmentStatus для хранения статуса приложенности МЧД к подписи; значение возвращается:

      • в структуре Entity в поле PowerOfAttorneyAttachmentStatus;

      • в структуре SignatureV3 в поле PowerOfAttorneyAttachmentStatus;

    • в структуру SignatureInfo добавили поле CertificateSubjectType с типом владельца сертификата.

    • в структуру PowerOfAttorneyValidationStatusNamedId добавлено значение IsNotAttached.

09.07.2024

SDK: C# 2.21.0

28.06.2024

SDK: C# 2.20.0 | Java 3.20.0

26.06.2024

SDK: C# 2.19.0 | Java 3.19.0

  • Расширили структуру Address: в структуру RussianAddress добавили поле OtherInformation.

21.05.2024

  • Реализовали работу с документами формата, утвержденного приказом № ЕД-7-26/970@:

    • добавили версии utd970_05_02_01 для всех документов, поддерживающих новый формат: УПД, счета-фактуры, акты и накладные,

    • добавили XSD-схемы для генерации документов, их можно получить с помощью метода GetDocumentTypes (V2) или скачать на страницах Документооборот накладных и Документооборот актов,

    • реализовали генерацию документов нового формата с помощью метода GenerateTitleXml,

    • реализовали парсинг документов нового формата с помощью метода ParseTitleXml.

25.04.2024

SDK: C# 2.17.0 | Java 3.18.0

  • Добавили возможность получить ленту событий по изменению отношений с контрагентами:

    • Реализовали метод GetCounteragentEvents (V1) для получения ленты событий.

    • Добавили структуры:

      • BoxCounteragentEventList — представляет собой список событий по изменению отношений с контрагентами,

      • BoxCounteragentEvent — представляет собой событие по изменению отношений с контрагентом,

      • CounteragentInfo — содержит информацию о контрагенте.

11.04.2024

SDK: C# 2.16.0 | Java 3.17.0

  • Добавили возможность работы с МЧД, выпущенной в порядке передоверия:

    • Метод GetRoamingOperators теперь может вернуть значение SupportPowerOfAttorneyDelegationChain: эта функция означает, что оператор поддерживает работу с МЧД, выпущенной в порядке передоверия.

    • В структуру PowerOfAttorney добавили поля DelegationChain и DelegationInfo. Они хранят данные о предыдущих МЧД для доверенностей, выпущенных в порядке передоверия.

08.04.2024

SDK: C# 2.15.0 | Java 3.16.0

  • Добавили возможность работы с группами контрагентов:

    • Реализовали методы:

    • Добавили структуры:

      • CounteragentGroup — хранит информацию о группе контрагентов

      • DepartmentsInGroup — хранит список идентификаторов подразделений, в которые группа контрагентов может отправлять документы

    • Добавили поле CounteragentGroupId в структуры Counteragent и GetOrganizationsByInnListResponse. В нем возвращается идентификатор группы, в которую добавлен контрагент.

06.03.2024

SDK: C# 2.14.7 | Java 3.15.8

27.02.2024

SDK: C# 2.14.6 | Java 3.15.7

  • Добавили возможность указать расширенные данные подписанта для УПД, утвержденного приказом № ЕД-7-26/970@:

    • в перечисление DocumentTitleType добавили значения Utd970Seller = 12 и Utd970Buyer = 13 для титула продавца и покупателя УПД формата приказа 970 соответственно;

    • в поле ExtendedDocumentTitleType структуры SignerInfoV2 добавили значения 12 и 13 для титула продавца и покупателя УПД формата приказа №970 соответственно;

    • в перечисления SignerType, SignerStatus и SignerPowers добавили значение -1: в УПД нового формата нет полей с типом, статусом и областью полномочий подписанта.

20.02.2024

02.02.2024

  • Добавили возможность передать МЧД в содержимом документа для акта о приемке выполненных работ КС-2 формата, утвержденного приказом № ЕД-7-26/691@.

20.12.2023

SDK: C# 2.14.5 | Java 3.15.5

  • Добавлена возможность передать машиночитаемую доверенность в содержимом документа. МЧД в содержимом можно передать только для акта сверки формата, утвержденного приказом № ЕД-7-26/405@:

    • в структуру PowerOfAttorneyToPost добавлен признак UseDocumentContent;

    • в перечисление PowerOfAttorneySendingType добавлено значение DocumentContent. Значение будет возвращаться, если МЧД передали в содержимом документа.

02.11.2023

SDK: C# 2.14.3 | Java 3.15.4 | C++ 1.92.14

  • В структуру Entity добавлены поля:

    • AuthorUserId — хранит идентификатор пользователя-автора сущности;

    • MoveDocumentInfo — хранит информацию о перемещении документа в другое подразделение.

24.10.2023

SDK: C# 2.14.2 | Java 3.15.3

  • В структуру PowerOfAttorney добавлено поле PermissionsInfo, в котором возвращается информация о полномочиях из машиночитаемой доверенности.

  • Добавлена структура PowerOfAttorneyPermissionsInfo для хранения информации о полномочиях из МЧД.

18.10.2023

SDK: C# 2.14.0

  • В перечисление DocumentType добавлено значение MesNotification.

22.09.2023

SDK: C# 2.13.0 | Java 3.15.2

  • Добавлена поддержка машиночитаемых доверенностей (МЧД), выпущенных в рамках передоверия:

    • добавлена новая версия метода GetPowerOfAttorneyContent (V2). Если пользователь отправил цепочку файлов МЧД, то в ответе метод вернет содержимое конечной доверенности и всех родительских доверенностей;

    • в структуру PowerOfAttorney добавлено поле DelegationChain, в котором возвращается список файлов передоверенной МЧД и родительских МЧД;

    • в структуру PowerOfAttorneyToPost добавлено поле Contents, в котором можно передать как один файл МЧД, так и цепочку файлов в случае передоверия.

09.08.2023

SDK: C# 2.12.1

  • В структуру PowerOfAttorneyToPost добавлен признак SendAsFile. Признак указывает, что МЧД нужно передать файлом.

22.06.2023

SDK: C# 2.12.0

  • Реализована отправка и скачивание файла машиночитаемой доверенности (МЧД):

    • реализован метод GetPowerOfAttorneyContent (V2) для получения содержимого МЧД и подписи под ней;

    • добавлена структура PowerOfAttorneyContent для хранения содержимого МЧД и подписи под ней;

    • в структуру PowerOfAttorneyToPost добавлено поле Content, в котором можно передать содержимое xml МЧД и подписи;

    • в структуры PowerOfAttorneyInfo и SignaturePowerOfAttorney добавлено поле SendingType, в котором возвращается информация о способе передачи МЧД;

    • в структуру PowerOfAttorney добавлены поля System и IdFile. В поле System возвращается информация о системе хранения доверенности, в поле IdFile — имя xml-файла МЧД без расширения.

19.05.2023

SDK: C# 2.11.8 | Java 3.13.0

10.04.2023

SDK: C# 2.11.7

  • В структуре SignerInfoV2 для поля SignerType добавлено новое значение — универсальный подписант.

  • В структуре SignerInfoV2 добавлено поле SignerUserDataXsdUrl, которое содержит URL-путь метода, возвращающего файл XSD-схемы упрощенного XML подписанта.

  • В структурах DraftDocumentToPatch, DocumentToPatch и ContentToPatch добавлено поле SignerContent.

10.03.2023

SDK: C# 2.11.6 | Java 3.14.0

  • Добавлена новая версия метода /V2/GetWorkflowsSettings. Метод возвращает свойства всех видов документооборота.

11.01.2023

SDK: C# 2.11.5

  • Добавлена структура RoamingSendingStatus для хранения информации о статусе отправки машиночитаемой доверенности (МЧД) в роуминг.

  • В структурах PowerOfAttorneyInfo и SignaturePowerOfAttorney добавлено поле SendingStatus.

  • В структуре DocflowStatusV3 добавлено поле GeneralRoamingSendingStatus.

  • Реализована возможность получить информацию о функции операторов ЭДО SupportsPowerOfAttorney с помощью метода GetRoamingOperators.

14.07.2022

SDK: C# 2.11.3 | Java 3.12.0 | C++ 1.92.11

  • В структуру CertificateInfoV2 добавлено поле SubjectType для определения типа владельца сертификата.

21.06.2022

SDK: C# 2.11.0

  • Реализована возможность получения информации о функциях операторов ЭДО с помощью метода GetRoamingOperators.

05.04.2022

SDK: C# 2.10.0 | Java 3.11.0 | C++ 1.92.10

  • добавлена структура DocumentWorkflowSettings для хранения свойств вида документооборота;

  • реализован метод GetWorkflowsSettings (V2) для получения свойств вида документооборота.

28.03.2022

SDK: Java 3.9.9

23.02.2022

SDK: C# 2.9.29 | Java 3.9.9 | C++ 1.92.9

  • В структуру CounteragentList добавлено поле TotalCountType, которое отражает количество контрагентов, возвращаемых в поле TotalCount.

  • Для поля TotalCount введено ограничение значения: теперь в нем возвращает значение не больше 10000. Это ограничение введено для повышения производительности метода поиска контрагентов.

21.02.2022

SDK: C# 2.9.28

  • API Диадока теперь поддерживает работу с машиночитаемой доверенностью (МЧД).

  • Реализованы методы для работы с машиночитаемой доверенностью.

  • Реализована отправка документов с машиночитаемой доверенностью (МЧД).

    При отправке документов методами PostMessage (V3), PostMessagePatch (V3) и SendDraft теперь можно указать МЧД. Для этого изменены структуры SignedContent, DocumentSignature и DocumentSenderSignature, которые теперь могут хранить информацию о МЧД в новой структуре PowerOfAttorneyToPost.

  • Реализовано получение машиночитаемой доверенности (МЧД).

    • Получение МЧД в сообщении.

    В методы GetMessage (V5), GetNewEvents (V7), GetLastEvent и GetEvent (V2) добавлена возможность получить информацию о МЧД и ее статусе. Для этого реализована структура PowerOfAttorneyInfo, используемая в структуре Entity. В перечисление AttachmentType добавлены значения:

    • PowerOfAttorney — информация о МЧД

    • PowerOfAttorneyStatus — статус проверки МЧД

    • Получение МЧД в docflow.

    В методах V3/GetDocflowEvents, V3/GetDocflows, V3/GetDocflowsByPacketId, V3/SearchDocflows реализованы следующие изменения:

    • добавлена возможность получить информацию об общем (сводном) статусе по всем МЧД для всех сущностей документа. Для этого изменена структура DocflowStatusV3, которая теперь содержит новую структуру PowerOfAttorneyValidationStatus, хранящую информацию о сводном статусе МЧД.

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

    • Получение МЧД в документах.

    Методы GetDocument (V3), GetDocuments (V3), GetDocumentsByMessageId теперь возвращают информацию об общем (сводном) статусе по всем МЧД для всех сущностей документа. Для этого изменена структура DocflowStatusV3 в структуре Document, которая теперь содержит новую структуру PowerOfAttorneyValidationStatus, хранящую информацию о сводном статусе МЧД.

  • Реализована генерция титулов с машиночитаемой доверенностью (МЧД).

    Метод GenerateTitleXml теперь может генерировать титулы с МЧД.

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

    Метод PrepareDocumentsToSign теперь может подготовить к подписанию документ с МЧД. Для этого в структуру ExtendedSigner включена структура PowerOfAttorneyToPost, содержащая данные о МЧД.

26.01.2022

SDK: C# 2.9.23

  • Внесены изменения для работы с подтверждениями другого оператора ЭДО:

    • Добавлен новый тип вложения AttachmentType — RoamingConfirmation. Он представляет собой подтверждение оператора, отправленное в роуминг или полученное из роуминга.

    • В структуру ConfirmationDocflow добавлено новое поле RoamingConfirmation. Оно содержит подтверждение оператора, отправленное в роуминг или полученное из роуминга, представленное структурой OperatorConfirmationDocflow.

06.10.2021

SDK: C# 2.9.22 | Java 3.9.8 | C++ 1.92.8

  • Добавлена новая версия метода /V2/GenerateRevocationRequestXml. Метод позволяет сгенерировать предложение об аннулировании версии 1.02. Если получатель ПоА в роуминге, то метод сгенерирует ту версию, которую поддерживает оператор.

05.10.2021

SDK: C# 2.9.21

  • В структуру ExtendedSignerDetails (V2) добавлено значение Ucd736Buyer для поддержки формата приказа №736.

20.09.2021

SDK: C# 2.9.20

  • Для титула покупателя UniversalCorrectionDocumentBuyerTitle добавлены методы UseSignerDetails и UseSignerReference, с помощью которых можно задать объекту значения полей SignerDetails и SignerReference соответственно.

01.09.2021

SDK: C# 2.9.19

  • Добавлена новая версия метода /V7/GetNewEvents для получения ленты событий по ящику.

  • Для методов /V7/GetNewEvents и GetDocflowEvents (V3) добавлены новые условия фильтрации по критериям:

    • подразделение,

    • тип документа,

    • тип сообщения (письмо, черновик, шаблон),

    • контрагент,

    • направление документооборота (входящий, исходящий, внутренний),

    • время возникновения события.

19.07.2021

SDK: C++ 1.92.6

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

29.06.2021

SDK: C# 2.9.15

  • Добавлены функции документов ucd736_05_01_02 и utd820_05_01_02_hyphen по приказам №736 и №820.

25.06.2021

SDK: C# 2.9.14 | Java 3.9.7 | C++ 1.92.4

20.05.2021

SDK: C# 2.9.13

  • Добавлены структуры для поддержки документов в формате приказа №736 и примеры их использования.

04.05.2021

SDK: C# 2.9.12 | Java 3.9.6 | C++ 1.92.3

23.03.2021

SDK: C# 2.9.9 | Java 3.9.4 | C++ 1.92.2

  • Добавлен признак возможности использовать шаблон больше одного раза.

17.03.2021

SDK: C# 2.9.8 | Java 3.9.3 | C++ 1.92.1

  • В структуре Document добавлена информация о промежуточном получателе: ProxyBoxId и ProxyDepartmentId.

17.02.2021

SDK: C# 2.9.5 | Java 3.9.0 | C++ 1.92.0

10.12.2020

SDK: C# 2.9.0 | Java 3.8.0 | C++ 1.91.0

  • Подготовка клиентов для работы с возможностями частичной приемки.

07.12.2020

SDK: C# 2.8.5 | Java 3.7.4 | C++ 1.90.0

  • В структуры Message и MessagePatch добавлена структура RevocationRequestInfo, позволяющая получить информацию о запросе аннулирования.

05.11.2020

SDK: C# 2.8.4 | Java 3.7.3 | C++ 1.89.0

  • В структуре TemplateToPost добавлены поля MessageProxyBoxId и MessageProxyDepartmentId для указания промежуточного получателя документа, который создается из шаблона. MessageProxyBoxId и MessageProxyDepartmentId возвращаются в Template и TemplateToLetterTransformationInfo.

24.08.2020

SDK: C# 2.7.0 | Java 3.5.0 | C++ 1.86.0

27.07.2020

SDK: C# 2.6.0 | Java 3.4.0 | C++ 1.85.0

30.06.2020

SDK: C# 2.3.0

  • Структура DocflowV3 добавлена в COM API.

04.06.2020

SDK: Java 3.2.1

  • Удален устаревший код. Убрана обратная совместимость с версией 2.*.*.

20.05.2020

SDK: C# 2.2.0 | Java 3.2.0 | C++ 1.83.0

24.01.2020

SDK: C# 2.0.0

  • Добавлена поддержка .NET Standard.

26.12.2019

SDK: Java 3.0.0

  • Выполнен глобальный рефакторинг Java SDK, в котором переработано внутреннее устройство библиотеки, обновлены зависимости и произведены некоторые breaking changes.

  • Добавлена поддержка подписания по ГОСТ 2012 в CertificateHelper. Библиотека сама определяет ГОСТ сертификата, и подписывает соответствующим алгоритмом.

  • Выполнено изменение контракта ошибок: сейчас любая ошибка оборачивается в тип DiadocSdkException.

  • Добавлены доменные клиенты, обратиться к которым можно через корневой объект DiadocApi. Методы перемещены по соответствующим доменным клиентам, а в старых методах сделаны перевызовы. Все старые методы помечены Deprecated, и будут удалены в ближайшее время.

  • Breaking changes:

    • тип GeneratedFile перемещен в пакет Diadoc.Api.httpClient;

    • тип DiadocErrorException переименоват в DiadocException;

    • тип DocumentsFilter перемещен в пакет Diadoc.Api.document. Изменен его интерфейс: удалены публичные поля, вместо них добавлены fluent setters;

    • в классе CertificateHelper методы переименованы на camelCase нотацию.

24.12.2019

SDK: C# 1.87.0 | Java 2.21.0 | C++ 1.82.0

  • Добавлен метод PostTemplatePatch, который позволяет отправлять дополнения к шаблонам документов.

  • Добавлена возможность с помощью этого метода и структуры TemplateRefusalAttachment выполнить отзыв или отклонение шаблона.

  • В структуры Entity и DocumentTemplateInfo добавлена информация об отзыве и отклонении шаблона.

13.12.2019

SDK: C# 1.86.0 | Java 2.20.0 | C++ 1.81.0

  • Добавлен метод DetectDocumentTitles, который позволяет определить возможные типы документа у конкретного файла.

12.12.2019

SDK: C# 1.85.3 | Java 2.19.1

25.11.2019

SDK: C# 1.85.0

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

30.09.2019

SDK: C# 1.84.0 | Java 2.19.0 | C++ 1.80.0

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

  • Для обратной совместимости старые URL-адреса GenerateDocumentReceiptXml и GenerateInvoiceDocumentReceiptXml расширены и поддерживают весь функционал нового метода.

18.09.2019

SDK: C# 1.82.0 | Java 2.17.0 | C++ 1.78.2

  • Добавлена новая версия метода Authenticate (V3) с универсальным контрактом, в котором все данные для аутентификации передаются в теле POST запроса.

17.09.2019

SDK: C# 1.82.1

  • Добавлена новая версия utd820_05_01_01_hyphen для всех типов документов, поддерживающих формат приказа №820: счета-фактуры и их исправления, акты, накладные, УПД, иУПД. Версия полностью совместима с utd820_05_01_01. Отличается только генерация и парсинг. Теперь при генерации необходимо явно задать следующие атрибуты и при парсинге учитывать наличие этих атрибутов в UserDataXML:

    • ДефНомИспрСчФ

    • ДефДатаИспрСчФ

    • ДефОКЕИ_Тов

    • ДефСтТовУчНал

    • ДефСтТовУчНалВсего

    • ДефКодПроисх

    • ДефИННЮЛ

    • ДефИННФЛ

    • ДефНДС.

    Также можно явно указывать ФНС-идентификаторы отправителя (ИдОтпр) и получателя (ИдПол). Может быть полезно в случаях, когда в документе указано несколько продавцов (элемент xml СвПрод) или покупателей (СвПокуп), и нужно явно определить, кто из них является участником документооборота. Подробные отличия можно посмотреть в XSD-схеме, доступной в поле UserDataXSD ответа метода GetDocumentTypes (V2).

  • Для C# SDK добавлена кодогенерация новой XSD, доступной по ссылке.

06.09.2019

SDK: C# 1.81.0 | Java 2.16.1 | C++ 1.78.2

  • В возвращаемое значение метода AcquireCounteragentResult (V2) добавлено поле InvitationDocumentId.

  • В структуре Counteragent добавлено поле InvitationDocumentId.

27.08.2019

SDK: Java 2.16.0 | C++ 1.78.0

  • В Java и C++ SDK добавлен метод GenerateTitleXml, позволяющий сгенерировать любой титул любого типа документа.

  • В Java и C++ SDK в структуре DocumentTitle добавлено поле Index для обозначения порядкового номера титула в документе.

16.08.2019

SDK: C# 1.80.0 | Java 2.15.0 | C++ 1.77.0

  • Добавлен метод GetLastEvent, возвращающий последнее событие в ящике.

15.08.2019

SDK: C# 1.79.0

  • В C# SDK добавлен метод GenerateTitleXml, позволяющий сгенерировать любой титул любого типа документа.

  • В C# SDK в структуре DocumentTitle добавлено поле Index для обозначения порядкового номера титула в документе.

05.08.2019

SDK: C# 1.78.0 | Java 2.14.0 | C++ 1.76.0

14.07.2019

SDK: C# 1.77.0 | Java 2.13.0 | C++ 1.75.0

  • Добавлен метод DetectCustomPrintForms, возвращающий информацию о наличии у документа нестандратной печатной формы.

  • Свойство HasCustomPrintForms структуры Document объявлено устаревшим и больше не заполняется (всегда возвращается false).

09.07.2019

SDK: C# 1.76.0 | Java 2.12.0 | C++ 1.74.0

  • Добавлен метод GetMyEmployee, возвращающий информацию о текущем сотруднике организации.

  • Метод GetMyPermissions объявлен устаревшим.

  • Добавлена возможность управлять правом сотрудника удалять документы и черновики и восстанавливать документы с помощью метода EmployeePermissions. В структуре OrganizationUserPermissions добавлен признак CanDeleteRestoreDocuments.

09.07.2019

SDK: C# 1.75.0 | Java 2.11.1 | C++ 1.73.0

  • Поле TransferDocDetails в структуре EventContent, соответствующее атрибуту ПередатДокум в УКД, стало необязательным.

05.07.2019

SDK: C# 1.74.0 | Java 2.10.0 | C++ 1.72.0

  • Добавлена возможность отправлять шаблоны из/в подразделение методом PostTemplate.

  • Добавлена возможность перемещать шаблоны между подразделениями методом MoveDocuments.

11.06.2019

SDK: C# 1.73.0 | Java 2.9.0 | C++ 1.71.0

27.05.2019

SDK: C# 1.72.0 | Java 2.8.0 | C++ 1.70.0

  • Добавлена поддержка формата приказа №820:

    • через метод GetDocumentTypes (V2) можно найти версии с идентификатором utd820_05_01_01 для всех типов документов, поддерживающих новый формат: счета-фактуры, акты, накладные, УПД, иУПД.

    • для генерации и парсинга документов новой версии доступны только обобщенные методы:

  • В структуры ExtendedSigner и DocumentTitleType добавлены значения в для поддержки версий формата приказа №820.

16.05.2019

SDK: C# 1.71.0 | Java 2.7.0 | C++ 1.69.0

  • Добавлен метод GetOrganizationFeatures для возвращения статуса блокировки ящика и прочих фич ящика.

14.05.2019

SDK: C# 1.70.0 | Java 2.6.0 | C++ 1.68.0

  • Добавлен метод ParseTitleXml для парсинга документа любой версии.

07.05.2019

SDK: C# 1.69.0 | Java 2.5.0 | C++ 1.67.0

  • Добавлены методы Register и RegisterConfirm для регистрации организации и сотрудника по сертификату.

24.04.2019

SDK: C# 1.68.0 | Java 2.4.0

  • В структуре DocflowV3:

    • удалена структура ProxyResponseDocflow;

    • изменена структура RecipientResponseDocflow:

      • структура переименована в ParticipantResponseDocflow;

      • поле RecipientTitle переименовано в Title;

      • Поле RecipientResponseStatus переименовано ResponseStatus;

    • удалено поле ProxyResponse = 3, вместо него добавлено поле ProxyResponse = 11, структура которого соответствует ParticipantResponseDocflow.

23.04.2019

SDK: C# 1.67.0 | Java 2.3.0

  • В структуре DocflowV3 добавлены свойства, содержащие текстовые выдержки соответствующих документов.

  • В структуре SignatureRejectionDocflow добавлено свойство PlainText, которое содержит текст сообщения об отказе в подписи.

  • В структуре AmendmentRequestDocflow добавлено свойство PlainText, которое содержит текст запроса уточнения.

  • В структуре RevocationRequestDocflow добавлено свойство PlainText, которое содержит текст запроса аннулирования.

09.03.2019

SDK: C# 1.65.0 | Java 2.1.0 | C++ 1.65.0

  • В структуре ResolutionRequestType добавлен тип согласования Custom.

  • В структуре ResolutionRequestInfo добавлено свойство Actions, в котором перечислены доступные действия для запроса согласования.

  • В структуре ResolutionStatusType добавлен тип запроса согласования ActionsRequested, который соответствует типу Custom.

  • В структуре ResolutionStatus добавлено свойство ActionsRequested.

  • В структуре ResolutionRequestV3 добавлено свойство Actions, в котором перечислены доступные действия для запроса согласования.

30.01.2019

SDK: Java 2.0.0

  • Обновлен JDK до версии 10.x

  • Обновлен КриптоПро JCP до версии 2.0

15.01.2019

SDK: C# 1.64.0 | Java 1.64.0 | C++ 1.64.0

  • Добавлен метод GetDepartment для получения информацию о подразделении организации.

  • Добавлен метод GetDepartments для получения списка подразделений организации.

  • Добавлен метод CreateDepartment для создания подразделения организации.

  • Добавлен метод UpdateDepartment для обновления подразделения организации.

  • Добавлен метод DeleteDepartment для удаления подразделения организации.

26.12.2018

SDK: C# 1.63.0 | Java 1.63.0 | C++ 1.63.0

24.12.2018

SDK: C# 1.62.1 | Java 1.62.1 | C++ 1.62.1

14.12.2018

SDK: C# 1.62.0 | Java 1.62.0 | C++ 1.62.0

05.12.2018

  • Добавлен метод GetEmployees для получения списка сотрудников организации.

28.11.2018

SDK: C# 1.60.1 | Java 1.60.1 | C++ 1.60.1

  • В структуре DocflowV3 добавлена информация о согласовании документа.

30.10.2018

SDK: C# 1.59.0 | Java 1.59.0 | C++ 1.59.0

  • Добавлена возможность работы с извещением о получении на титул получателя:

    • обновлены настройки документооборота DocumentWorkflow для всех типов документа, добавлена новая настройка;

    • в структуре MessagePatchToPost следующие поля сменили сообщение протобуфера с ReceiptAttachment на RecipientTitleAttachment:

      • RecipientTitles,

      • XmlTorg12BuyerTitles,

      • XmlAcceptanceCertificateBuyerTitles,

      • UniversalTransferDocumentBuyerTitles;

    • в структуре Document добавлено поле SenderReceiptMetadata;

    • в структуре DocflowV3 добавлено поле SenderReceipt.

22.10.2018

SDK: C# 1.58.0 | Java 1.58.0 | C++ 1.58.0

  • Добавлен метод DeleteEmployee для удаления сотрудника.

22.10.2018

SDK: C# 1.57.0 | Java 1.57.0 | C++ 1.57.0

  • Добавлен метод UpdateEmployee для редактирования сотрудника.

16.10.2018

SDK: C# 1.56.0 | Java 1.56.0 | C++ 1.56.0

  • В структуре DocumentTitle добавлена информация о типе подписанта SignerInfo, необходимого для подписания титула.

04.10.2018

SDK: C# 1.55.7 | Java 1.55.7 | C++ 1.55.7

  • Добавлен метод UpdateMyUser для редактирования данных пользователя.

02.10.2018

SDK: C# 1.55.6 | Java 1.55.6 | C++ 1.55.6

17.09.2018

SDK: C# 1.54.6 | Java 1.54.6 | C++ 1.54.6

  • Добавлен метод CreateEmployee для создания сотрудника.

07.09.2018

SDK: C# 1.54.4 | Java 1.54.4 | C++ 1.54.4

  • В структуре DocumentList добавлено поле HasMoreResults. Если количество документов превышает 1000, значение TotalCount всегда будет возвращаться равным 1000, а признак HasMoreResults = true.

31.08.2018

SDK: C# 1.54.1 | Java 1.54.1 | C++ 1.54.1

  • Добавлена возможность управлять правом сотрудника видеть списки контрагентов и работать с ними с помощью метода EmployeePermissions.

  • В структуре OrganizationUserPermissions добавлено поле CanManageCounteragents.

29.08.2018

SDK: C# 1.54.0 | Java 1.54.0 | C++ 1.54.0

  • Добавлен метод получения подписок сотрудника на почтовые уведомления GetSubscriptions и метод для их редактирования UpdateSubscriptions.

20.08.2018

SDK: C# 1.53.0 | Java 1.53.0 | C++ 1.53.0

  • Добавлен обобщенный метод генерации титула отправителя GenerateSenderTitleXml.

08.08.2018

SDK: C# 1.52.4

07.08.2018

SDK: C# 1.52.3 | Java 1.52.3 | C++ 1.52.3

  • Добавлен метод получения сотрудника GetEmployee и новая версия метода GetMyUser (V2).

06.08.2018

SDK: C# 1.52.1 | Java 1.52.1 | C++ 1.52.1

  • В структуре Organization добавлено поле HasCertificateToSign.

19.07.2018

SDK: C# 1.52.0 | Java 1.52.0 | C++ 1.52.0

  • Добавлены режимы блокировки сообщений с шаблонами LockMode. Режим можно указать при отправке шаблонов через TemplateToPost.

  • Добавлена поддержка удаления и восстановления шаблонов через имеющиеся методы Delete и Restore.

04.07.2018

SDK: C# 1.51.9 | Java 1.51.9 | C++ 1.51.9

  • В структуре Docflow добавлено поле RoamingNotification, содержащее данные о доставке документа в роуминг.

25.06.2018

SDK: C# 1.51.8 | Java 1.51.8 | C++ 1.51.8

  • Добавлены режимы блокировки сообщений LockMode.

14.06.2018

SDK: C# 1.51.7 | Java 1.51.7 | C++ 1.51.7

  • В структуре Document добавлено поле EditingSettingId, содержащее идентификатор настройки редактирования документа, если он был создан из шаблона с возможностью редактирования полей.

  • В структуре OrganizationUserPermissions добавлено поле CanCreateDocuments, указывающее, может ли пользователь создавать документы и работать с черновиками.

22.05.2018

SDK: C# 1.51.6

  • Добавлен обобщенный метод генерации титула получателя GenerateRecipientTitleXml.

  • Расширена структура DocumentTitle: добавлено поле UserDataXsdUrl, позволяющее узнать, по какой ссылке возможно загрузить XSD-схему контракта для генерации титула с помощью обобщенного метода генерации GenerateRecipientTitleXml.

23.04.2018

SDK: C# 1.51.3 | Java 1.51.3 | C++ 1.51.3

  • Расширена структура Document: добавлено свойство Origin, позволяющее узнать, из какого черновика или шаблона был создан документ.

16.04.2018

SDK: C# 1.51.2

  • Расширена структура MessagePatchToPost: добавлен необязательный список операций EditingPatches для редактирования контента документа.

12.04.2018

SDK: C# 1.51.1 | Java 1.51.1 | C++ 1.51.1

  • Расширена структура TemplateDocumentAttachment:

    • добавлен необязательный признак NeedRecipientSignature, обозначающий запрос подписи получателя под отправляемым документом, созданным из шаблона;

    • добавлен необязательный идентификатор настройки редактирования содержимого документа EditingSettingId.

29.03.2018

SDK: C# 1.51 | Java 1.51 | C++ 1.51

26.02.2018

SDK: C# 1.50 | Java 1.50 | C++ 1.50

  • Расширена структура контракта Document: добавлены свойства для универсальной работы с документом.

  • Следующие свойства считаются устаревшими и не рекомендованы к использованию, — в будущем они будут удалены:

    • NonformalizedDocumentMetadata

    • InvoiceMetadata

    • InvoiceRevisionMetadata

    • InvoiceCorrectionMetadata

    • InvoiceCorrectionRevisionMetadata

    • TrustConnectionRequestMetadata

    • Torg12Metadata

    • AcceptanceCertificateMetadata

    • ProformaInvoiceMetadata

    • XmlTorg12Metadata

    • XmlAcceptanceCertificateMetadata

    • PriceListMetadata

    • PriceListAgreementMetadata

    • CertificateRegistryMetadata

    • ReconciliationActMetadata

    • ContractMetadata

    • Torg13Metadata

    • SupplementaryAgreementMetadata

    • ServiceDetailsMetadata

    • UniversalTransferDocumentMetadata

    • UniversalTransferDocumentRevisionMetadata

    • UniversalCorrectionDocumentMetadata

    • UniversalCorrectionDocumentRevisionMetadata

08.02.2018

SDK: C# 1.49.2 | Java 1.49.2 | C++ 1.49.2

  • Расширена структура PrepareDocumentsToSignRequest метода PrepareDocumentsToSign: добавлена структура ContentToPatch для патчинга содержимого документов.

  • Добавлен метод для создания сообщения с документами на основе шаблона TransformTemplateToMessage.

  • Добавлена универсальная структура в MessagePatchToPost.RecipientTitles для отправки второго титула любого типа документов. Рекомендуем использовать это поле вместо XmlTorg12BuyerTitles, XmlAcceptanceCertificateBuyerTitles, UniversalTransferDocumentBuyerTitles и др.

09.01.2018

SDK: C# 1.49.1 | Java 1.49.1 | C++ 1.49.1

21.12.2017

SDK: C# 1.49 | Java 1.49 | C++ 1.49

  • Добавлены методы для работы с шаблонами документов:

    • PostTemplate — для отправки шаблона документов,

    • GetTemplate — для получения отправленного шаблона.

  • В структуре Organization добавлено поле IsForeign, отражающее статус иностранности организации.

25.10.2017

SDK: C# 1.48

  • Добавлен метод GetDocumentTypes (V2), возвращающий описание типов документов, доступных в ящике.

  • В структуре MessageToPost, которую принимает метод /V3/PostMessage, изменилось поле CustomDocumentAttachments. Теперь оно называется DocumentAttachment и может использоваться для отправки документов любых типов.

19.10.2017

  • Добавлено ограничение на количество документов в структуре MessageToPost, которую можно отправить через метод PostMessage (V3). Текущее максимальное количество документов в сообщении — 30.

18.09.2017

SDK: C# 1.47.1 | Java 1.47.1 | C++ 1.47.1

  • В структуре User, которая возвращается методом GetMyUser (V2), изменилась структура CertificateInfo. В нее добавлены поля:

    • OrganizationName — наименование организации, на которую выдан сертификат,

    • Inn — ИНН организации, на которую выдан сертификат.

06.09.2017

SDK: C# 1.47 | Java 1.47 | C++ 1.47

  • Добавлена новая версия метода /V4/GetMessage. Основное отличие версии V4 от версии V3 в том, что новая версия метода имеет дополнительную опцию injectEntityContent.

31.08.2017

  • Добавлена структура CancellationInfo, содержащая информацию об отмене сущности.

  • Изменилось поведение метода GetMessage (V5): отмененные запросы на согласование возвращаются вместе с соответствующими сущностями отмены. Раньше отмененный запрос на согласование не возвращался, и не было возможности определить, что данный запрос на соглавание был отменен.

30.08.2017

SDK: C# 1.46.1 | Java 1.46.1 | C++ 1.46.1

23.08.2017

SDK: C# 1.46 | Java 1.46 | C++ 1.46

  • Добавлена структура SignatureInfo, содержащая информацию о подписи и сертификате.

  • Добавлен метод GetSignatureInfo, получающий на вход идентификаторы подписи и возвращающий данные в структуре SignatureInfo.

  • В структуре InvoiceItemAmountsDiff поле Subtotal, отражающее сумму с учетом налога, теперь является опциональным.

  • Добавлена вторая версия метода ExtendedSignerDetails, принимающая на вход структуру DocumentTitleType.

13.07.2017

SDK: C# 1.44.2 | Java 1.44.2 | C++ 1.44.2

  • В структуре Organization добавлено поле CertificateOfRegistryInfo, в котором указана информация о свидетельстве о государственной регистрации.

  • В структуре DocumentInfo добавлено поле AttachmentVersion, в котором указана версия документа.

29.06.2017

SDK: C# 1.44.1 | Java 1.44.1 | C++ 1.44.1

  • Добавлен признак «Разрешить посылать зашифрованные документы».

  • В структуре Box добавлено поле EncryptedDocumentsAllowed, в котором указан признак «Разрешить посылать зашифрованные документы».

06.06.2017

SDK: C# 1.44 | Java 1.44 | C++ 1.44

  • В структуре EncryptedXmlDocumentAttachment добавлено поле DocumentName, в котором указано наименование первичного документа, определенное организацией (НаимДокОпр).

02.06.2017

SDK: C# 1.43 | Java 1.43 | C++ 1.43

  • Добавлена дата ликвидации организации.

  • В структуре Organization добавлено поле LiquidationDate, в котором указана дата ликвидации организации по данным из ЕГРЮЛ и ЕГРИП.

03.05.2017

  • Добавлены подписи промежуточных получателей и их статусы:

    • в структуре Document добавлено поле ProxySignatureStatus, отвечающее за статус подписи промежуточного получателя.

    • в структуре Message в поле Entities теперь возвращаются сами подписи промежуточного получателя.

11.04.2017

SDK: C# 1.41.3 | Java 1.41.3 | C++ 1.41.3

  • Добавлена возможность определить версию XSD-схемы, в соответствии с которой был отправлен документ: в структурах Document и Entity добавлено поле AttachmentVersion. Значения, возвращаемые в этом поле, показывают версию XSD-схемы. Версия XSD возвращается для документов, сформированных в соответствии с приказами ФНС №155 от 24 марта 2016 и №189 от 13 апреля 2016. В дальнейшем планируется расширение перечня возвращаемых значений.

30.03.2017

SDK: C# 1.41.1 | Java 1.41.1 | C++ 1.41.1

  • Добавлена возможность отправлять неформализованные акты и акты сверки без указания номера документа: в структурах ReconciliationActAttachment и AcceptanceCertificateAttachment поле DocumentNumber стало необязательным.

27.03.2017

SDK: C# 1.41 | Java 1.41 | C++ 1.41

  • Добавлена возможность снимать документ с маршрута согласования с помощью поля ResolutionRouteRemovals в структуре MessagePatchToPost.

  • Переименования:

    • в документации термин «цепочка согласования» заменен на «маршрут согласования»,

    • в названиях структур и HTTP-методах слово «Chain» заменено на «Route»,

    • в enum-е AttachmentType элемент ResolutionChainAssignment переименован в ResolutionRouteAssignment,

    • в структуре MessagePatchToPost поле ResolutionChainAssignments переименовано в ResolutionRouteAssignments,

    • структура ResolutionChainAssignment переименована в ResolutionRouteAssignment,

    • в структуре ResolutionRouteAssignment поле ChainId переименовано в RouteId,

    • структура ResolutionChainList переименована в ResolutionChainList,

    • в структуре ResolutionChainList поле ResolutionChains переименовано в ResolutionRoutes,

    • структура ResolutionChain переименована в ResolutionChainList,

    • в структуре ResolutionChainList поле ChainId переименовано в RouteId,

    • метод GetResolutionChainsForOrganization переименован в GetResolutionRoutesForOrganization.

24.03.2017

15.03.2017

SDK: C# 1.39 | Java 1.39 | C++ 1.39

  • Добавлена новая версия метода /V5/GetNewEvents / для получения ленты событий по ящику. Основное отличие версии V5 от версии V4 в том, что новая версия метода работает для всех пользователей в ящике. Лента событий формируется по подразделению организации, в котором состоит пользователь. Подробнее в описании метода GetNewEvents (V7).

10.02.2017

SDK: C# 1.38.3

23.12.2016

10.10.2016

SDK: C# 1.37

  • Добавлена структура CustomDocumentAttachment для отправки кастомных типов документов.

07.04.2016

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

25.03.2016

  • Добавлена возможность авторизации по логину/паролю и сертификату с ключом, полученным доверенным сервисом. Подробности в описании методов Authenticate (V3) и AuthenticateConfirm (V3)).

10.03.2016

  • Добавлена возможность редактировать пакеты документов:

    • в структуре MessagePatchToPost добавлено поле EditDocumentPacketCommands;

    • добавлена структура EditDocumentPacketCommand, описывающая операцию редактирования пакета документов.

10.02.2016

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

19.01.2016

  • Значения перечисления ResolutionType синхронизированы со значениями, возвращаемые с сервера (значение Undefined заменено на UndefinedResolutionType).

  • В структуре MessageToPost добавлен признак залоченного пакета LockPacket.

02.12.2015

  • В структуре Document добавлено свойство с сообщением об ошибке при доставке в роуминг RoamingNotificationStatusDescription.

  • Добавлены новые версии методов GetCounteragent (V3) и GetCounteragents (V3), в которых изменилась логика показа видимых подразделений.

11.11.2015

  • В структуре Document добавлено свойство «признак прочитанности» IsRead .

  • Метод GetDocuments (V3) теперь позволяет искать непрочитанные документы.

14.10.2015

  • Добавлена возможность отправлять новый тип документа «Дополнительное соглашение к договору»:

    • в структуре MessageToPost добавлена стуктура SupplementaryAgreementAttachment для передачи дополнительного соглашения к договору;

    • в структуры Entity и DocumentType добавлен новый тип для дополнительного соглашения к договору;

    • в структуре Document добавлена вложенная структура SupplementaryAgreementMetadata для описания метаданных дополнительного соглашения к договору;

    • в структуре DocumentInfo добавлена вложенная структура SupplementaryAgreementInfo для описания метаданных дополнительного соглашения к договору.

10.08.2015

  • Добавлена возможность отправлять зашифрованные товарные накладные и акты выполненных работ:

    • в структуре MessageToPost добавлены поля EncryptedXmlTorg12SellerTitles и EncryptedXmlAcceptanceCertificateSellerTitles;

    • добавлена структура EncryptedXmlDocumentAttachment для передачи зашифрованных накладных и актов.

10.08.2015

  • В метод GetMyOrganizations добавлен параметр autoRegister, который позволяет управлять автоматической регистрацией пользователя с сертификатом КЭП в организации.

30.07.2015

  • Добавлена возможность отправлять зашифрованные счета-фактуры:

    • добавлены структуры CounteragentCertificateList и Certificate для описания списка сертификатов контрагента;

    • в структурах Document и Entity добавлен признак IsEncryptedContent:— он указывается для передачи контента в зашифрованном виде;

    • добавлены структуры для передачи зашифрованных счетов-фактур и метаданных для исправлений и корректировок:

    • в структуре MessageToPost добавлено поле EncryptedInvoices для передачи зашифрованных счетов-фактур;

    • в структуре MessagePatchToPost добавлено поле SignatureVerifications для передачи резльтатов проверки подписей на стороне получателя;

    • добавлен метод GetCounteragentCertificates (V2) для запроса списка сертификатов контрагента;

    • в структуре Signer добавлен отпечаток сертификата SignerCertificateThumbprint.

  • Добавлена возможность изменения подписанта в неотправленных исходящих документах:

    • добавлена структура DocumentToPatch, представляющая изменение исходящего неотправленного документа;

    • изменились структуры DocumentSignature, PrepareDocumentsToSignRequest: в них добавлена возможность ссылаться на изменение исходящего неотправленного документа.

28.05.2015

  • Добавлен метод GetResolutionRoutesForOrganization для получения списка цепочек согласования организации. Изменен протобуфер MessagePatchToPost: добавлена структура ResolutionChainAssignment для постановки документа на цепочку согласования.

25.05.2015

  • Добавлен метод GenerateForwardedDocumentPrintForm для получения печатной формы со штампом для пересланного документа.

28.04.2015

  • Добавлен метод Authenticate (V3) для аутентификации по ключу, полученному доверенным сервисом.

13.04.2015

  • Изменены структуры InvoiceInfo и InvoiceCorrectionInfo, которые предоставляют исходные данные для формирования СФ и КСФ в XML-формате с помощью метода GenerateInvoiceXml.

  • Добавлена возможность указывать версию формата СФ и КСФ и указывать поля, соответствующие новой версии XML-формата СФ.

  • Изменилась логика работы метода ParseInvoiceXml в зависимости от формата СФ.

Предупреждение

Версия сборки SDK не изменилась. Всем, кто скачал сборку в период с 10.04.2015-12.04.2015, необходимо скачать свежую сборку от 13.04.2015.

10.04.2015

  • Изменены структуры InvoiceInfo и InvoiceCorrectionInfo, которые предоставляют исходные данные для формирования СФ и КСФ в XML-формате с помощью метода GenerateInvoiceXml.

  • Добавлена возможность указывать версию формата СФ и КСФ.

02.04.2015

  • Добавлена возможность отравлять приглашения организациям, не подключенным к Диадоку. Соответствующие изменения внесены в методы AcquireCounteragent (V3) и AcquireCounteragentResult (V2). Старая версия метода AcquireCounteragent (V3) через некоторое время будет отключена.

15.10.2014

  • Добавлен метод GenerateDocumentZip, позволяющий формировать zip-архив с документом, подписями к нему и файлами документооборота.

02.10.2014

  • Добавлена возможность привязывать к документам произвольные данные «ключ-значение». Соответствующие изменения внесены в структуры MessageToPost и MessagePatchToPost.

05.06.2014

  • Добавлена возможность получать статус доставки документа в роуминг: RoamingNotification.

25.02.2014

05.02.2014

  • Добавлена возможность получать через API протокол передачи документа с помощью метода GenerateDocumentProtocol. Выгрузка протокола передачи документа адресатом пересылки документа третьей стороне производится с помощью метода GenerateForwardedDocumentProtocol (V2).

24.01.2014

Выгрузка содержимого сущностей, связанных с документом, адресатом пересылки документа третьей стороне производится с помощью метода GetForwardedEntityContent (V2).

20.12.2013

  • Сборка protobuf-net.dll теперь внедрена в библиотеку DiadocApi.dll. Это позволяет интегратору использовать в своем проекте другую версию сборки protobuf-net.dll.

06.12.2013

  • Добавлена возможность отправлять формализованные отказы от подписи документов. Xml-файл отказа формируется с помощью метода GenerateSignatureRejectionXml (V2).

    • Для отправки отказов используется метод PostMessagePatch (V3), в который передается структура MessagePatchToPost с заполненным списком MessagePatchToPost.XmlSignatureRejections.

    • Для получения документов с отказом в подписи через метод GetDocuments (V3) используются такие же фильтры, как для неформализованных отказов. Формализованным отказам соответствует тип XmlSignatureRejection из перечисления AttachmentType.

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

  • Новые отказы от подписи, при получении их через старые версии SDK, будут иметь тип SignatureRequestRejection, — как отказы старого формата, — но в содержимом соответствующих сущностей вместо строки с комментарием к отказу теперь будет возвращаться xml файл отказа в кодировке CP1251.

20.10.2013

13.08.2013

10.04.2013

  • Добавлена поддержка нового типа полуформализованных документов — ценовых листов. Ценовой лист представляет собой двусторонний документ (для него требуется подпись контрагента/отказ в запросе подписи) со следующими обязательными реквизитами:

    • дата составления и номер самого ценового листа

    • дата вступления ценового листа в силу

    • дата и номер договора, к которому относится ценовой лист.

    Для отправки ценовых листов через API при обращении к методу PostMessage (V3) заполните список MessageToPost.PriceLists. Каждый элемент этого списка представляет собой структуру PriceListAttachment. При получение информации о документах через API с помощью методов GetMessage (V5), GetDocument (V3) и т.п. для ценовых листов в структуре Document заполняется поле PriceListMetadata. При фильтрации документов методом GetDocuments (V3) можно использовать новый тип документов PriceList.

  • Для получения списка пользователей конкретной организации добавлен метод GetOrganizationUsers (V2).

  • В структуре Organization добавлено поле IfnsCode, позволяющее получить код налоговой инспекции — место подачи декларации по НДС.

14.03.2013

  • Добавлена возможность отправлять документы, подписанные тестовой подписью с помощью признака SignedContent.SignWithTestSignature.

  • Добавлены методы ParseAcceptanceCertificateSellerTitleXml и ParseTorg12SellerTitleXml, позволяющие преобразовывать xml-файлы формализованных актов (титул исполнителя) и ТОРГ-12 (титул продавца) в структуры AcceptanceCertificateSellerTitleInfo и Torg12SellerTitleInfo соответственно.

  • Расширена функциональность метода PostMessage (V3): с помощью признака MessageToPost.DelaySend можно задержать отправку документа, чтобы была возможность провести его согласование. В связи с этим изменился набор возможных состояний документов, что требует обновления логики клиентских решений.

  • Чтобы определить, может ли пользователь запрашивать согласования, используйте признак OrganizationUserPermissions.CanRequestResolutions в свойствах пользователя, возвращаемых методом GetMyPermissions.

  • В сообщение EntityPatch добавлено поле ContentIsPatched, через которое сервер выдает информацию о том, что исходный документ в процессе подписания был модифицирован. В документ была внедрена информация о том, кто подписал этот документ.

  • Изменена логика работы с перечислимыми типами: теперь в большинстве перечислений имеется специальное значение с именем UnknownИмяПеречисления. Клиент получит такое значение только том случае, если есть рассогласование версий API между клиентом и сервером, и клиент не может правильно интерпретировать информацию, возвращаемую сервером (например, в случае добавления новых элементов к перечислению клиент будет получать вместо вновь добавленных элементов значение UnknownИмяПеречисления). Клиент должен корректно обрабатывать такие ситуации, например, путем информирования пользователя о необходимости обновить интеграционный модуль.

Предупреждение

Для доступа к новой функциональности и во избежание возможного конфликта версий обновите SDK.

31.01.2013

  • Добавлена возможность работы с документами, пересылаемыми внутри организации:

  • Расширены возможности работы с «черновиками», то есть с подготовленными, но не отправленными документами:

    • для отправки ранее созданного черновика добавился метод SendDraft;

    • черновики теперь можно загружать в Диадок с помощью метода PostMessage (V3) — это предпочтительный способ;

    • изменилась структура MessageToPost;

    • добавлена структура DraftToSend;

    • структура RequestedSignature переименована в DocumentSignature, подробнее в описании MessagePatchToPost.

  • Добавлена возможность загружать большие по размеру документы в Диадок с помощью сервиса полки документов. Для этих целей добавился метод ShelfUpload (V2) и обновилась структура SignedContent, в которой добавлено поле NameOnShelf, позволяющее сослаться на уже загруженный на полку файл.

  • Добавлена возможность восстанавливать ранее удаленные отдельные документы и сообщения целиком. Для этих целей добавлен метод Restore, а в структурах EntityPatch и MessagePatch добавлены поля, позволяющие узнать, были ли конкретный документ или сообщение восстановлены.

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

  • Добавлена возможность проводить эвристический семантический разбор строк, представляющих почтовый адрес в Российской Федерации. За это отвечает метод ParseRussianAddress.

  • Добавлена возможность выполнять трансформацию XML-файла СФ/ИСФ, сформированного в соответствии с XML-схемой, в структуру InvoiceInfo. За это отвечает метод ParseInvoiceXml.

29.08.2012

  • В структуре Organization добавлено поле Departments, содержащее список всех подразделений в организации. Это поле позволяет получать информацию об оргструктуре с помощью методов GetMyOrganizations, GetOrganization, GetCounteragents (V3), GetCounteragent (V3).

  • В методах PostMessage (V3) и PostDraft добавлена возможность отправлять документы в конкретное подразделение контрагента:

    • в структуре MessageToPost добавлено новое поле ToDepartmentId;

    • в метод PostDraft добавлен новый параметр toDepartmentId.

  • Добавлен метод MoveDocuments для перемещения документов своей организации между подразделениями. Информация о перемещениях документов между подразделениями, — неважно было это сделано через API или через веб-интерфейс, — доступна через метод GetNewEvents (V7).

  • В структуре EntityPatch добавлено поле MovedToDepartmentId.

  • В структуре Entity добавлено поле RawCreationDate, содержащее метку времени создания сущности. Это поле заполняется для всех сущностей, его можно использовать для получения времени подписания или согласования документа.

  • Добавлена возможность осуществлять согласование или отказ в согласовании документов через API:

    • добавлена структура ResolutionInfo;

    • в структуре MessagePatchToPost добавлено поле Resolutions;

    • все действия по согласованию видны в структуре Message как сущности с типом Attachment/Resolution; содержимое этой сущности — байты строки комментария к согласованию в кодировке UTF-8;

    • в структуре Entity добавлено поле ResolutionInfo, содержащее тип действия по согласованию и ФИО согласователя в виде новой структуры ResolutionInfo.

26.06.2012

  • Добавлен метод Delete, который помечает документы как удаленные.

  • В структурах Document и Message добавлены признаки IsDeleted.

  • В структуре MessagePatch добавлен признак MessageIsDeleted и поле EntityPatches, содержащее список структур типа EntityPatch с признаком DocumentIsDeleted. Эти изменения структуры MessagePatch позволяют отслеживать моменты удаления документов и/или сообщений, анализируя поток событий в ящике, возвращаемый методом GetNewEvents (V7).

  • Добавлен метод CanSendInvoice, позволяющий для данного идентификатора ящика и сертификата ЭП узнать, был ли этот сертификат зарегистрирован в ФНС в качестве сертификата, используемого для подписания электронных счетов-фактур, отправляемых участником ЭДО, которому принадлежит данный ящик в Диадоке. Т.е. метод CanSendInvoice отвечает на вопрос, может ли тот или иной сертификат ЭП использоваться для подписания ЭСФ, отправляемых из данного ящика.

  • В структуре Organization добавлено поле FnsRegistrationDate — дата подачи заявления в ФНС на регистрацию данной организации в качестве участника документооборота ЭСФ.

  • Метод PostDraft теперь позволяет загружать в черновики товарные накладные и акты о выполнении работ/оказании услуг в рекомендованном ФНС XML-формате (документы с типами Attachment/XmlTorg12 и Attachment/XmlAcceptanceCertificate). Также в метод PostDraft добавлена поддержка счетов на оплату (документов типа Attachment/ProformaInvoice).

09.06.2012

v1.2

  • Расширен перечень сведений, возвращаемых методами, дающими доступ к справочнику организаций в Диадоке, например, GetMyOrganizations. Теперь структура Organization включает поля:

    • Ogrn — ОГРН организации;

    • Address — юридический адрес организации;

    • FnsParticipantId — уникальный идентификатор участника документооборота СФ, который должен указываться при формировании XML счетов-фактур.

  • Метод GenerateInvoiceXml теперь формирует не только XML-файлы счетов-фактур, но и XML-файлы исправлений счетов-фактур, корректировочных счетов-фактур и исправлений корректировочных счетов-фактур.

11.05.2012

v1.1

04.04.2012

  • Добавлена поддержка официально утвержденных версий форматов документов, фигурирующих в документообороте счетов-фактур. В связи с этим поменялись сигнатуры методов GenerateInvoiceDocumentReceiptXml и GenerateInvoiceCorrectionRequestXml (V2). В SDK включены соответствующие XML-схемы, описывающие форматы документов, фигурирующих в документообороте счетов-фактур:

    • XML-схема счета-фактуры (СФ), эта же схема описывает формат исправления СФ (ИСФ);

    • XML-схема корректировочного счета-фактуры (КСФ), эта же схема описывает формат исправления КСФ (ИКСФ);

    • XML-схема извещения о получении документа;

    • XML-схема подтверждения оператора о дате отправки СФ/ИСФ/КСФ/ИКСФ (выдается продавцу);

    • XML-схема подтверждения оператора о дате доставки СФ/ИСФ/КСФ/ИКСФ (выдается покупателю);

    • XML-схема уведомления об уточнении СФ/ИСФ/КСФ/ИКСФ (формируется покупателем).

    Схемы приведены в разделе XSD-схемы.

    Для обеспечения обратной совместимости с существующими пилотными проектами по итеграции Диадок в течение еще какого-то времени будет продолжать принимать счета-фактуры в старом формате. Однако такие документы не будут иметь юридической значимости.

  • Добавлен метод GenerateInvoiceXml, который облегчает процесс формирования корректного XML-файла счета-фактуры. Метод позволяет интегратору не погружаться в детали XML-формата СФ, а передавать в Диадок только необходимые первичные данные в виде структуры InvoiceInfo. По этим данным метод GenerateInvoiceXml, при необходимости дополнив их сведениями из своих справочников, сформирует корректный XML-файл счета-фактуры, который затем можно будет отправить методом PostMessage (V3) или загрузить в черновики методом PostDraft. В структуре InvoiceInfo можно не заполнять реквизиты продавца и покупателя: достаточно указать идентификаторы их ящиков в Диадоке, и соответствующие реквизиты будут подставлены из справочника организаций Диадока.

  • Добавлена возможность работать с исправлениями счетов-фактур и корректировочными счетами-фактурами. Для этого введены типы сущностей:

    • Attachment/InvoiceRevision — исправление счета-фактуры;

    • Attachment/InvoiceCorrection — корректировочный счет-фактура;

    • Attachment/InvoiceCorrectionRevision — исправление корректировочного счета-фактуры.

    Для связывания исправлений и корректировок с оригинальными СФ нужно использовать уже имеющийся в Диадоке механизм установки ссылок между документами, находящимися в разных сообщениях. Кроме того, в структуре Document.InvoiceMetadata, описывающей метаданные счета-фактуры в Диадоке, добавлено поле InvoiceAmendmentFlags, которое отражает статус счета-фактуры с точки зрения наличия уведомления об уточнении или отправленного исправления/корректировки. Например, при отправке корректировочного счета-фактуры, у исходного счета-фактуры, по которому было запрошено уточнение, поле Document.InvoiceMetadata.InvoiceAmendmentFlags поменяет свое значение с AmendmentRequested на AmendmentRequested\Corrected.

  • Добавлен метод GetInvoiceCorrectionRequestInfo, который возвращает информацию, содержащуюся в уведомлении об уточнении счета-фактуры, без необходимости уметь разбирать соответствующий XML-формат, утвержденный ФНС, что в какой-то степени упрощает работу интегратора. В частности, метод GetInvoiceCorrectionRequestInfo позволяет получить текст уведомления об уточнении.

  • Добавлены методы PostMessage (V3) и PostDraft позволяющие загружать в Диадок акты о выполнении работ/оказании услуг (новый тип документов Attachment/AcceptanceCertificate). Поддержка нового типа документов добавлена и в метод GetDocuments (V3).

  • Метод GetDocuments (V3) теперь возволяет фильтровать список документов по дате формирования документа в учетной системе (реквизиту самого документа), а не только по дате загрузки документа в Диадок. Для этого в метод GetDocuments добавлены необязательные параметры строки запроса fromDocumentDate и toDocumentDate, которые позволяют задать интервал времени, в котором осуществляется поиск. При этом метод GetDocuments продолжает поддерживать фильтрацию списка документов с помощью параметров timestampFromTicks и timestampToTicks.

  • Доработаны методы для работы с черновиками:

    • Метод GetNewEvents (V7) теперь возвращает информацию о событиях, происходящик с черновиками: создание черновика и начальный набор документов в нем, добавление к черновику документов, утилизация черновика (просто удаление, либо отправка на основе него полноценного сообщения).

    • Методы GetEvent (V2) и GetMessage (V5) теперь возвращают информацию о черновиках.

    • Метод RecycleDraft удаляет еще неотправленные черновики.

    • В сообщение Message добавлено необязательное поле CreatedFromDraftId, в которое заносится идентификатор черновика, на основании которого было создано данное сообщение или черновик.

    • В черновике добавлено поле DraftIsTransformedToMessageId, в которое заносится идентификатор сообщения или черновика, которое было создано из данного черновика. Признак Message.DraftIsRecycled означает, что черновик был утилизирован, то есть удален или преобразован в полноценное сообщение или в другой черновик. Поля DraftIsTransformedToMessageId и DraftIsRecycled могут присутствовать в структуре Message, описывающей черновик, одновременно.

    • Метод PostDraft теперь позволяет создать нередактируемые черновики — черновики, которые можно только отправить или удалить. Добавление или удаление документов из таких черновиков заблокировано как в веб-интерфейсе Диадока, так и в API-методе PostDraft. Для создания нередактируемого черновика нужно в метод PostDraft передать параметр lock без значения.

18.01.2012

  • Добавлены методы для управления списком контрагентов:

    • GetCounteragents (V3) — возвращает список контрагентов, отфильтрованный по их статусу;

    • GetCounteragent (V3) — возвращает информацию о контрагенте по его идентификатору;

    • AcquireCounteragent (V3) — добавляет организацию в список своих контрагентов;

    • BreakWithCounteragent (V2) — исключает организацию из списка своих контрагентов.

  • Переработан механизм получения справочной информации об организациях и ящиках в Диадоке. Следующие методы объявлены устаревшими и через некоторое время не будут поддерживаться:

    • GetBoxInfo — вместо него используйте методы GetOrganization и GetBox, которые возвращают информацию о конкретных организации и ящике по их идентификаторам;

    • GetBoxesByInnKpp — вместо него используйте метод GetOrganizationsByInnKpp, который возвращает информацию о ящиках в Диадоке по ИНН и КПП организации;

    • GetBoxesByAuthToken — вместо него используйте метод GetMyOrganizations, который возвращает информацию об организациях и ящиках, к которым имеет доступ владелец текущего авторизационного токена.

16.12.2011

  • Добавлен метод GetDocuments (V3), позволяющий быстро получать информацию о документах, например, о счетах-фактурах, в своем ящике, задавая различные критерии фильтрации документов.

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

  • Добавлена возможность с помощью методов PostMessage (V3) и PostDraft загружать в Диадок новые типы докуметов, в частности, товарные накладные (ТОРГ-12) и запросы на инициацию канала обмена документами через Диадок TrustConnectionRequest.

  • В структура Entity добавлено поле DocumentInfo. Для сущности типа Attachment это поле содержит дополнительную информацию о документе, представляемом этой сущностью.

03.10.2011

  • Добавлены методы Recognize и GetRecognized для распознавания печатных форм счетов-фактур. Печатная форма подается на вход метода Recognize в формате XPS. В случае успешного распознавания на выходе метода GetRecognized получается XML-файл счета-фактуры в формате, удовлетворяющем требованиям ФНС и пригодном для отправки в соответствии с порядком, утвержденным Минфином РФ.

26.08.2011

  • В патчи с уведомлениями о невозможности доставки (DFN), возникающими из-за невалидности подписей под передаваемыми документами, теперь добавляются протоколы проверки подписей в виде отдельных сущностей для каждой подписи. Эти сущности-протоколы имеют тип Attachment/SignatureVerificationReport и привязываться к «своим» подписям с помощью поля Entity.ParentEntityId. Протоколы проверки формируются для всех подписей, — как валидных, так и невалидных, — поэтому чтобы понять, какие именно подписи были признаны недействительными, нужно анализировать содержимое соответствующих протоколов. Содержимое сущности-протокола (массив байтов Entity.Content.Data) представляет собой сериализованную в протобуфер структуру SignatureVerificationResult.

15.08.2011

  • Добавлена возможность запрашивать формирование ЭП под пересылаемыми данными «по доверенности». В этом случае изготавливать ЭП на клиенте не нужно (можно не устанавливать на рабочее место криптопровайдер), вместо этого формирование необходимой подписи будет происходить на сервере в момент доставки отправленного сообщения. Изменения отразились в структурах MessageToPost и MessagePatchToPost.

08.07.2011

  • Добавлена возможность формирования печатных форм различных документов (в частности счетов-фактур) с помощью метода GeneratePrintForm.

17.06.2011

  • Добавлена возможность связывать документы в разных сообщениях. Для этого нужно заполнить структуру DocumentId, например, в структуре XmlDocumentAttachment при отправке корректировочного счета-фактуры.

  • Добавлена возможность отправить отказ от запрошенной подписи: в структуре MessagePatchToPost добавлено необязательное поле RequestedSignatureRejections.

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

  • Уведомления о невозможности доставки теперь ссылаются на недоставленные куски сообщения:

    • в структуре Entity добавлено необязательное поле NotDeliveredEventId — это идентификатор сообщения или патча, который не удалось доставить (например, из-за некорректности одной или нескольких подписей в нем);

    • получить недоставленный кусок сообщения можно с помощью метода GetEvent (V2), передав ему в качестве параметра EventId значение NotDeliveredEventId. Данное поле заполняется только у сущности типа Attachment с типом вложения DeliveryFailureNotification.

15.04.2011

  • Методы GetBoxInfo, GetBoxesByAuthToken и GetBoxesByInnKpp теперь отдают данные в формате XML.

07.04.2011

  • Добавлена возможность создавать черновики с помощью метода PostDraft.

30.03.2011

  • Добавлена возможность вести документооборот по счетам-фактурам в соответствии с порядком Минфина.

18.02.2011

  • Добавлены методы для получения справочной информации GetBoxInfo и GetBoxesByInnKpp.

  • Добавлен метод GetEntityContent (V4) для получения контента вложений по отдельности.

  • Метод GetMessage (V5) больше не отдает контент свыше 1Мб единовременно. Вместо него используйте метод GetEntityContent (V4).

09.12.2010

  • Первый релиз интеграторского интерфейса.