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

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

• Канал Telegram

• Новости RSS

12.03.2026

SDK: C# 3.18.0 | Java 5.8.2

• Отметили устаревшими и запланировали к удалению ряд методов. Теперь они возвращают в ответе заголовки Sunset и Link с информацией о дате выключения. Структуры, используемые исключительно этими методами, также перенесли в раздел Удаляемые методы и структуры. Подробнее на странице Политика устаревания.

  • Будут удалены после 10 ноября 2026 года:

  • AcquireCounteragent

  • AcquireCounteragent (V2)

  • AcquireCounteragentResult

  • BreakWithCounteragent

  • GetCounteragent

  • GetCounteragent (V2)

  • GetCounteragentCertificates

  • GetCounteragents

  • GetCounteragents (V2)

  • GetDepartment

  • GetMyPermissions

  • GetMyUser

  • GetOrganizationUsers

  • GetOrganizationsByInnList

  • GetPowerOfAttorneyContent

  • ParseAcceptanceCertificateBuyerTitleXml

  • ParseAcceptanceCertificateSellerTitleXml

  • ParseInvoiceXml

  • ParseTorg12BuyerTitleXml

  • ParseTorg12SellerTitleXml

  • ParseUniversalCorrectionDocumentBuyerTitleXml

  • ParseUniversalCorrectionDocumentSellerTitleXml

  • Будут удалены после 30 ноября 2026 года:

  • ExtendedSignerDetails (GET)

  • GenerateAcceptanceCertificateXmlForBuyer

  • GenerateAcceptanceCertificateXmlForSeller

  • GenerateInvoiceCorrectionRequestXml

  • GenerateInvoiceDocumentReceiptXml

  • GenerateInvoiceXml

  • GenerateReceiptXml

  • GenerateRecipientTitleXml

  • GenerateRevocationRequestXml

  • GenerateSenderTitleXml

  • GenerateSignatureRejectionXml

  • GenerateTorg12XmlForBuyer

  • GenerateTorg12XmlForSeller

  • GenerateUniversalTransferDocumentXmlForBuyer

  • GenerateUniversalTransferDocumentXmlForSeller

  • GetTemplate

  • GetWorkflowsSettings

  • Будут удалены после 3 апреля 2027 года:

  • GetDocflowEvents (V2)

  • GetDocflowEvents (V3)

  • GetDocflowsByPacketId (V2)

  • GetDocflowsByPacketId (V3)

  • GetDocflows (V2)

  • GetDocflows (V3)

  • GetEvent (V2)

  • GetLastEvent

  • GetMessage (V4)

  • GetMessage (V5)

  • GetNewEvents (V4)

  • GetNewEvents (V5)

  • GetNewEvents (V6)

  • GetNewEvents (V7)

  • GetTemplate

  • GetWorkflowsSettings

  • PostMessagePatch (V3)

  • SearchDocflows (V2)

  • SearchDocflows (V3)

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

11.03.2026

SDK: C# 3.19.1 | Java 5.9.0

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

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

06.03.2026

SDK: C# 3.14.0 | Java 5.7.0

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

02.03.2026

SDK: C# 3.16.0 | Java 5.6.0

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

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

  • список идентификаторов контрагентов и подразделений вместо одного;

  • список номеров документов вместо одного;

  • имена файлов;

  • итоговые суммы в документе и их диапазон;

  • пользовательские данные.

27.02.2026

SDK: C# 3.13.0

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

02.02.2026

SDK: C# 3.8.0 | Java 5.2.0

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

  • метод AutoSignReceipts

  • метод AutoSignReceiptsResult

  • структура AutoSignReceiptsResult

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).

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

16.01.2026

SDK: Java 5.1.0

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

  • Добавили новую версию структуры DocumentTypeDescriptionV3 с полем UniversalMessagesStartDate для хранения даты перехода на универсальные сообщения.

  • Добавили новую версию метода GetDocumentTypes (V3), с помощью которой можно получить доступные типы документов в виде новой структуры DocumentTypeDescriptionV3.

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.

12.01.2026

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

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) — инструкция на странице Получение информации о типе документа.

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) — инструкция на странице Получение информации о типе документа.

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

18.12.2025

SDK: C# 3.0.0 | Java 5.0.0

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

17.12.2025

• Повысили информационную безопасность в API Диадока. Для этого:

  • добавили новое значение SecurityInspection для внешнего статуса обработки подозрительных документов — значение возвращается в структурах OuterDocflowInfo, OuterDocflow и OuterDocflowEntities;

  • ввели ограничения на передаваемые форматы неформализованных документов — перечень допустимых к отправке расширений доступен в разделе Список допустимых расширений;

  • запретили отправку подозрительных файлов — теперь документ не будет доставлен получателю, если Диадок распознает в отправляемом документе зашифрованный архив или расширение, не соответствующее списку допустимых расширений. В этом случае внешний статус обработки документа примет значение SecurityInspection. Информация о внешнем статусе подозрительного документа приведена в разделе Обработка подозрительного файла.

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

01.12.2025

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

  • OrganizationType — тип организации;

  • IsOwner — признак того, что интегратор, выполнивший запрос, является владельцем этой организации.

25.11.2025

SDK: C# 2.67.0

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

24.11.2025

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

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

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

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

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

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

    • ТекстИнф со значением Идентиф="ДатаПеревозДок".

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

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

  • Если грузоотправитель (или продавец — если в грузоотправителе указано значение <ОнЖе>) и грузополучатель — индивидуальный предприниматель (СвИП), то при заполнении адреса в формате АдрРФ в поле ИнфПолФХЖ1 должны быть указаны следующие значения:

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

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

17.11.2025

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

  • Версии методов, которые перестали работать:

  • AddEmployeePowerOfAttorney — вместо него рекомендуем использовать AddEmployeePowerOfAttorney (V2)

  • DeleteEmployeePowerOfAttorney — вместо него рекомендуем использовать DeleteEmployeePowerOfAttorney (V2)

  • PrevalidatePowerOfAttorney — вместо него рекомендуем использовать PrevalidatePowerOfAttorney (V2)

  • UpdateEmployeePowerOfAttorney — вместо него рекомендуем использовать UpdateEmployeePowerOfAttorney (V2)

  • Методы, для которых теперь возвращается код ответа 400 (Bad Request), если в запросе не передать реквизит RepresentativeInn:

  • AddEmployeePowerOfAttorney (V2)

  • DeleteEmployeePowerOfAttorney (V2)

  • PostMessage (V3)

  • PostMessagePatch (V3), PostMessagePatch (V4)

  • PrepareDocumentsToSign

  • PrevalidatePowerOfAttorney (V2)

  • RegisterPowerOfAttorney

  • UpdateEmployeePowerOfAttorney (V2)

  • Методы, для которых теперь возвращается код ответа 400 (Bad Request), если в UserDataXsd не передать реквизит RepresentativeInn:

  • GenerateInvoiceCorrectionRequestXml (V2)

  • GenerateReceiptXml (V2)

  • GenerateSignatureRejectionXml (V2)

  • GenerateTitleXml

30.10.2025

SDK: C# 2.62.0

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

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

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

09.10.2025

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

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

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

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

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

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

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

07.10.2025

SDK: C# 2.58.0

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

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

03.10.2025

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

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

02.10.2025

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

  • PostMessage (V3)

  • PostMessagePatch (V3)

  • PostMessagePatch (V4)

  • PrepareDocumentsToSign

  • RegisterPowerOfAttorney

01.10.2025

SDK: C# 2.56.0 | Java 4.15.1

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

  • ForwardDocument (V2)

  • GetForwardedDocumentEvents (V2)

  • GetForwardedDocuments (V2)

  • GetForwardedEntityContent (V2)

  • ForwardedDocument

  • ForwardDocumentEvent

  • ForwardedDocumentId

  Запланировали к удалению методы для работы с печатными формами пересланных документов:

  • GenerateForwardedDocumentPrintForm

  • GenerateForwardedDocumentProtocol (V2)

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

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

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

• Реализовали работу с формализованным счетом на оплату и счетом-офертой, утвержденными Приказом 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-схемы.

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.

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

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

  • AddEmployeePowerOfAttorney (V2) — принимает на вход структуру PowerOfAttorneyFullId с тремя реквизитами МЧД;

  • DeleteEmployeePowerOfAttorney (V2) — принимает на вход структуру PowerOfAttorneyFullId с тремя реквизитами МЧД;

  • UpdateEmployeePowerOfAttorney (V2) — принимает на вход структуру EmployeePowerOfAttorneyToUpdateV2, хранящую внутри структуру PowerOfAttorneyFullId с тремя реквизитами МЧД.

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

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

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

  • Добавили в структуры MessagePatchToPost и MessagePatchToPostV2 поле TtGisFixationCancellationRequests со списком документов для отмены сведений об отгрузке в виде новой структуры TtGisFixationCancellationRequestAttachment.

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

  • Добавили в структуру Entity поле TtGisFixationCancellationRequest с документом для отмены сведений об отгрузке.

  • Добавили в структуры DocflowV3 и DocflowV4 поле TtGisFixation с информацией о документе для отмены сведений об отгрузке в виде новой структуры TtGisFixationDocflow.

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

  Статусы обработки маркированных товаров описаны на странице Документы с маркированными товарами.

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

  • Отмена сведений об отгрузке

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

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

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

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

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

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

16.06.2025

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

  Для работы с УС реализовали следующие изменения:

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

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

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

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

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

    • тип вложения сущности УС имеет новое значение AttachmentType = UniversalMessage,

    • информация об УС хранится в новом поле UniversalMessageInfo виде новой структуры UniversalMessageInfo.

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

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

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

  • Изменили поведение метода GetEntityContent (V4): теперь он может возвращать содержимое универсального сообщения.

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

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

  • Переход на универсальные сообщения

  • Генерация универсального сообщения

  • Отправка универсального сообщения

  • Получение универсального сообщения

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

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

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

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

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 Диадока внесены следующие изменения:

  • метод GetDocumentTypes (V2) возвращает информацию о перечисленных версиях с параметром IsActual = false;

  • методы PrepareDocumentsToSign, PostMessage (V3) и PostTemplate больше не поддерживают работу с первыми титулами в версии 5.01;

  • настройки редактирования документов для версии 5.01 больше не поддерживаются.

  Обратите внимание, что если первый титул был передан до 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

• Выпустили большое обновление Java SDK с нарушением обратной совместимости.

  Прежнюю версию SDK перенесли в ветку legacy-proto-2.6.1, она больше не будет обновляться и поддерживаться.

  В ветке master теперь хранится обновленная версия SDK со следующими изменениями:

  • Обновили protobuf с версии 2.6 до 4.28.

  • Реализовали возможность заполнять данные подписанта в универсальном формате.

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

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

    • uploadFileToShelfV2

    • uploadLargeFileToShelf

    • shelfDownloadV2

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

    • forwardDocument

    • generateForwardedDocumentPrintForm

    • generateForwardedDocumentProtocol

    • getForwardedDocumentEvents

    • getForwardedDocuments

    • getForwardedEntityContent

    • getGeneratedPrintForm

    • getNewEventsV7

    • getResolutionRoutesForOrganization

    • getRoamingOperators

    • restore

    • sendFnsRegistrationMessage

  Рекомендуем вам использовать в интеграционных решениях новую версию Java SDK в ветке master.

  Если вы не готовы перейти на обновленную версию и планируете использовать устаревшую версию Java SDK, пожалуйста, настройте свое интеграционное решение на сборку из ветки legacy-proto-2.6.1. В противном случае во время сборки возникнут ошибки из-за нарушения обратной совместимости.

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

• Добавили новые статусы обработки маркированных документов согласно постановлению Правительства РФ от 30.11.2022 N 2173.

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

• Поддержали работу с УПД на перемещение согласно постановлению Правительства РФ от 30.11.2022 N 2173.

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

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

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

  Для этого добавили в структуру PowerOfAttorney новое поле Representatives. Оно хранит список уполномоченных представителей. Рекомендуем использовать его вместо устаревшего поля Confidant.

  Для получения информации о представителях добавили новые структуры и перечисления:

  • PowerOfAttorneyRepresentative

  • PowerOfAttorneyRepresentativeType

  • PowerOfAttorneyRepresentativeLegalEntity

  • PowerOfAttorneyRepresentativeIndividualEntity

  • PowerOfAttorneyRepresentativePhysicalEntity

  • PowerOfAttorneyRepresentativeLegalSubsidiaryEntity

  • PowerOfAttorneyRepresentativeForeignLegalSubsidiaryEntity

22.01.2025

SDK: C# 2.29.0

• Поддержали работу с новой версией формата УПД и СФ 5.03, утвержденной Приказом ФНС России от 15.11.2024 N ЕД-7-26/1032@, который вносит поправки в Приказ ФНС РФ от 19.12.2023 N ЕД-7-26/970@. Теперь формировать УПД и СФ по приказу №970 нужно согласно версии 5.03 — она заменила версию 5.02.

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

  • метод GetDocumentTypes (V2) возвращает информацию о новой версии utd970_05_03_01 с параметром IsActual = true.

  • методы GenerateTitleXml, ParseTitleXml и PrepareDocumentsToSign поддерживают работу с версией 5.03.

  • поддерживаются настройки редактирования документов с версией utd970_05_03_01.

  Обновили инструкции:

  • Генерация формализованного документа

  • Парсинг формализованного документа

  • Работа с УПД

  • Настройки редактирования

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

17.01.2025

SDK: C# 2.31.0 | Java 3.27.0

• Удалили из API Диадока метод UpdateMyUser согласно Политике устаревания.

16.01.2025

• Добавили в API Диадока возможность получить информацию о новой версии формата УПД и СФ 5.03, утвержденной Приказом ФНС России от 15.11.2024 N ЕД-7-26/1032@, который вносит поправки в Приказ ФНС РФ от 19.12.2023 N ЕД-7-26/970@. Эта версия заменит версию 5.02 с 22 января 2025 года.

  • Метод GetDocumentTypes (V2) теперь возвращает информацию о новой версии utd970_05_03_01 с параметром IsActual = false.

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

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

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.

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

  • старый метод ShelfUpload замените на методы:

    • ShelfUpload (V2) — при загрузке документа целиком;

    • ShelfUploadPartInit и ShelfUploadPart — при загрузке документа по частям;

  • старый метод ShelfDownload замените на метод ShelfDownload (V2).

03.11.2024

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

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

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

21.10.2024

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

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

27.09.2024

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

  • PostDraft

  • SendMessage

  • Recognize (C# SDK, COM SDK)

  • GetRecognized (C# SDK, COM SDK)

  • Devices

  • GetExternalServiceAuthInfo (C# SDK, Java SDK)

  Теперь эти методы возвращают в ответе заголовки 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

• Реализовали возможность получить изменения из ленты событий по контрагентам: метод GetCounteragentEvents (V1) теперь возвращает в структуре BoxCounteragentEvent не только текущее состояние отношений с контрагентом, но и изменения, которые произошли в этих отношениях.

28.06.2024

SDK: C# 2.20.0 | Java 3.20.0

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

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

    • AcquireCounteragent (V3)

    • AcquireCounteragentResult (V2)

    • BreakWithCounteragent (V2)

    • GetCounteragent (V3)

    • GetCounteragentCertificates (V2)

    • GetCounteragents (V3)

    • GetOrganizationUsers (V2)

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

    • AcquireCounteragent

    • AcquireCounteragent (V2)

    • AcquireCounteragentResult

    • BreakWithCounteragent

    • GetCounteragent

    • GetCounteragent (V2)

    • GetCounteragentCertificates

    • GetCounteragents

    • GetCounteragents (V2)

    • GetOrganizationUsers

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

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

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

    • AddCounteragentToGroup — добавляет контрагента в группу

    • CreateCounteragentGroup — создает группу контрагентов

    • DeleteCounteragentGroup — удаляет группу контрагентов

    • GetCounteragentGroup — возвращает информацию о группе контрагентов

    • GetCounteragentGroups — возвращает список групп контрагентов

    • GetCounteragentsFromGroup — возвращает список контрагентов в группе

    • UpdateCounteragentGroup — изменяет параметры группы контрагентов

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

    • 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

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

  • /V2/GenerateReceiptXml

  • /V2/GenerateSignatureRejectionXml

  • /V2/GenerateInvoiceCorrectionRequestXml

  Методы генерируют технологические документы в формате, утвержденном приказом № ЕД-7-26/133@.

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

  • ReceiptGenerationRequestV2

  • InvoiceCorrectionRequestGenerationRequestV2

  • SignatureRejectionGenerationRequestV2

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

• В Java SDK реализована функциональность для работы с машиночитаемой доверенностью.

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 Диадока теперь поддерживает работу с машиночитаемой доверенностью (МЧД).

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

  • Регистрация МЧД:

    • методы RegisterPowerOfAttorney и RegisterPowerOfAttorneyResult для регистрации МЧД.

  • Работа с МЧД сотрудника:

    • метод AddEmployeePowerOfAttorney для привязки МЧД к сотруднику.

    • метод DeleteEmployeePowerOfAttorney для отвязки МЧД от сотрудника.

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

    • метод GetEmployeePowersOfAttorney для получения всх МЧД сотрудника.

  • Получение и проверка МЧД:

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

    • метод PrevalidatePowerOfAttorney для предварительной проверки МЧД.

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

  При отправке документов методами 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

• В структуру DocumentTitleType добавлено значение 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

• Добавленое поле ConfirmationDocflow в структуру AmendmentRequestDocflow.

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

• Добавлен текстовый статус документа DocflowStatusV3 в структуры Document и DocflowV3.

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

• Метод GetDocumentTypes (V2) заменен второй версией.

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

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

27.07.2020

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

• В метод GetOrganizationsByInnList (V2) добавлена инфомация о приглашении контрагента.

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

• Добавлено поле SupportsAmendmentRequest в ответ метода GetDocumentTypes (V2).

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

• Добавлены значения SignerPowers и SignerStatus в структуры ExtendedSigner и ExtendedSignerDetailsToPost.

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

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

  • GetNewEvents (V7)

  • GetDocflowEvents (V3)

  • GetForwardedDocumentEvents (V2)

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

• В метод GenerateUniversalTransferDocumentXmlForSeller добавлен опциональный параметр documentVersion.

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

• Обновлена версия методов GetNewEvents (V7) и GetMessage (V5). Новая версия возвращает события по шаблонам Message и MessagePatch.

• В метод GetDocflowEvents (V3) добавлена информация о шаблонах.

27.05.2019

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

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

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

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

    • GenerateSenderTitleXml,

    • GenerateRecipientTitleXml,

    • ParseTitleXml.

• В структуры 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

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

  • EmployeePermissions,

  • EmployeePermissionsPatch,

  • OrganizationUserPermissions.

24.12.2018

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

• Следующие методы генерации и парсинга документов получили поддержку ставки 20%:

  • GenerateInvoiceXml — для генерации счетов-фактур,

  • GenerateTorg12XmlForSeller — для генерации документов в формате приказа 551,

  • GenerateAcceptanceCertificateXmlForSeller — для генерации документов в формате приказа 552,

  • GenerateUniversalTransferDocumentXmlForSeller — для генерации документов в форматах УПД и УКД,

  • ParseInvoiceXml — для парсинга счетов-фактур,

  • ParseTorg12SellerTitleXml — для парсинга документов в формате приказа 551,

  • ParseAcceptanceCertificateSellerTitleXml — для парсинга документов в формате приказа 552,

  • ParseUniversalTransferDocumentSellerTitleXml — для парсинга документов в формате УПД,

  • ParseUniversalCorrectionDocumentSellerTitleXml — для парсинга документов в формате УКД.

14.12.2018

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

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

  • DocumentInfo

  • Document

  • Entity

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

• В C# SDK добавлены экспериментальные версии методов Docflow API:

  • GetDocflows (V3)

  • GetDocflowEvents (V3)

  • GetDocflowsByPacketId (V3)

  • SearchDocflows (V3)

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

• Добавлены метки Метка (Label).

• Свойство Labels добавлено в следующие структуры:

  • Entity

  • ReceiptAttachment

  • CorrectionRequestAttachment

  • DocumentSignature

  • SignatureVerification

  • ResolutionAttachment

  • ResolutionRequestAttachment

  • ResolutionRouteAssignment

  • ResolutionRequestCancellationAttachment

  • ResolutionRequestDenialAttachment

  • RequestedSignatureRejection

  • RevocationRequestAttachment

  • XmlSignatureRejectionAttachment

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

• Добавлен параметр count для метода GetDocuments (V3).

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, изменилась структура 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

• Добавлены структуры TovTorgInfo и AcceptanceCertificate552Info для описания накладных и актов в формате приказов №551/552.

23.08.2017

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

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

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

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

• Добавлены вторые версии методов ExtendedSignerDetails (POST) (V2) и ExtendedSignerDetails (GET) (V2), принимающие на вход структуру 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

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

23.12.2016

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

  • документооборот счетов-фактур,

  • документооборот накладных,

  • документооборот актов,

  • документооборот УПД/УКД.

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

  • GenerateUniversalTransferDocumentXmlForSeller — генерация титула продавца УПД и УКД,

  • GenerateUniversalTransferDocumentXmlForBuyer — генерация титула покупателя УПД и УКД,

  • ParseUniversalTransferDocumentSellerTitleXml — парсинг титула продавца УПД,

  • ParseUniversalTransferDocumentBuyerTitleXml — парсинг титула покупателя УПД,

  • ExtendedSignerDetails (POST) (V2) — заполнение дополнительных данных (для УПД и УКД) о подписантах.

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

  • UniversalTransferDocumentSellerTitleInfo — для описания титула продавца УПД,

  • UniversalTransferDocumentBuyerTitleInfo — для описания титула покупателя УПД,

  • UniversalCorrectionDocumentSellerTitleInfo — для описания титула продавца УКД,

  • UniversalTransferDocumentBuyerTitleInfo — для описания титула покупателя УКД,

  • UniversalDocumentMetadata — для описания данных УПД и УКД,

  • ExtendedOrganizationInfo — для описания реквизитов продавца, покупателя и грузоотправителя, используемая в УПД и УКД,

  • ExtendedSigner — для описания реквизитов подписанта, используемая в УПД и УКД,

  • ExtendedSignerDetailsToPost — для описания реквизитов подписанта, используемая в методе ExtendedSignerDetails (POST) (V2).

• В структуре MessageToPost добавлено поле UniversalTransferDocumentSellerTitles:

  • для отправки УПД с функцией СЧФ,

  • для отправки УКД с функцией КСЧФ,

  • для отправки титула продавца УПД с функцией ДОП и СЧФДОП,

  • для отправки титула продавца УКД с функцией ДОП и СЧФДОП.

• Для отправки титула покупателя УПД и УКД в структуре MessageToPost добавлено поле UniversalTransferDocumentBuyerTitles:

  • для отправки титула покупателя УПД с функцией ДОП и СЧФДОП,

  • для отправки титула покупателя УКД с функцией ДОП и СЧФДОП.

• В структуре PrepareDocumentsToSignRequest добавлена возможность указать расширенные данные о подписанте.

• В DocflowAPI внесены следующие изменения:

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

    • InboundUniversalTransferDocumentDocflow — входящий УПД,

    • OutboundUniversalTransferDocumentDocflow — исходящий УПД,

    • UniversalTransferDocumentInfo — дополнительные данные о УПД,

    • UniversalCorrectionDocumentInfo — дополнительные данные о УКД;

  • в структуре Docflow добавлены поля InboundUniversalTransferDocumentDocflow и OutboundUniversalTransferDocumentDocflow;

  • в структуре DocumentInfo добавлены поля UniversalTransferDocumentInfo и UniversalCorrectionDocumentInfo.

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

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:— он указывается для передачи контента в зашифрованном виде;

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

    • EncryptedInvoiceAttachment

    • EncryptedDocumentMetadata

    • EncryptedInvoiceMetadata

    • EncryptedInvoiceCorrectionMetadata

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

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

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

  • в структуре 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 и AcquireCounteragentResult (V2). Старая версия метода AcquireCounteragent через некоторое время будет отключена.

15.10.2014

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

02.10.2014

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

05.06.2014

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

25.02.2014

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

  • протокол согласования цены

  • реестр сертификатов

  • акт сверки

  • договор

  • детализация

  • накладная ТОРГ-13

05.02.2014

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

24.01.2014

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

  • ForwardDocument (V2)

  • GetForwardedDocuments (V2)

  • GetForwardedDocumentEvents (V2).

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

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

  • Для отправки предложения об аннулировании через API при обращении к методу PostMessagePatch (V3) заполните список MessagePatchToPost.RevocationRequests. Каждый элемент этого списка представляет собой структуру RevocationRequestAttachment.

  • Для принятия предложения об аннулировании через API при обращению к методу PostMessagePatch (V3) заполните список MessagePatchToPost.RequestedSignatures.

  • Для отказа от предложения об аннулировании через API при обращении к методу PostMessagePatch (V3) заполните список MessagePatchToPost.XmlSignatureRejections. Каждый элемент этого списка представляет собой структуру XmlSignatureRejectionAttachment.

  • При получение информации о документах через API с помощью методов GetMessage (V5), GetDocument (V3) и т.п. для любых документов в структуре Document заполняется поле RevocationStatus.

• Добавлены методы GenerateRevocationRequestXml (V2) и GenerateSignatureRejectionXml (V2), облегчающие процесс формирования корректных XML файлов предложения об аннулировании и формализованного отказа в подписи.

• Добавлены методы ParseRevocationRequestXml и ParseSignatureRejectionXml, позволяющие преобразовывать xml-файлы предложения об аннулировании и формализованного отказа в подписи в структуры RevocationRequestInfo и SignatureRejectionInfo соответственно.

13.08.2013

• Изменены методы по работе со списками контрагентов. Подробнее в описании методов:

  • GetCounteragents

  • AcquireCounteragent

  • BreakWithCounteragent

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

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

  • добавлены элементы в перечислениях NonformalizedDocumentStatus, BilateralDocumentStatus и UnilateralDocumentStatus;

  • добавлены поля для работы с подразделениями организации в структурах Department, Entity, Document, Message и MessageToPost.

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

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

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

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

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

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

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

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

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

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

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

29.08.2012

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

• В методах 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

• Добавлена поддержка рекомендованных ФНС России форматов электронных товарных накладных и актов о выполнении работ/оказании услуг. Теперь с помощью метода PostMessage (V3) можно загружать в Диадок титулы продавца XML-накладных (новый тип документов Attachment/XmlTorg12) и титулы исполнителя XML-актов (новый тип документов Attachment/XmlAcceptanceCertificate), а с помощью метода PostMessagePatch (V3) можно загружать в Диадок соответствующие титулы покупателя/заказчика. В SDK включены XSD-схемы, описывающие рекомендованные ФНС России форматы товарных накладных и актов о выполнении работ/оказании услуг:

  • XSD-схема товарной накладной, титул продавца

  • XSD-схема товарной накладной, титул покупателя

  • XSD-схема акта о выполнении работ/оказании услуг, титул исполнителя

  • XSD-схема акта о выполнении работ/оказании услуг, титул заказчика

• Добавлены методы, облегчающие процесс формирования корректных XML-файлов товарных накладных и актов:

  • GenerateTorg12XmlForSeller

  • GenerateTorg12XmlForBuyer

  • GenerateAcceptanceCertificateXmlForSeller

  • GenerateAcceptanceCertificateXmlForBuyer

  А в метод GetDocuments (V3) добавлена поддержка новых типов документов.

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

• В метод PostMessage (V3) добавлена возможность загружать в Диадок вложения специального типа «структурированные данные» Attachment/StructuredData, с помощью которого можно организовать передачу рядом с юридически-значимой печатной формой документа каких-то данных, подлежащих автоматизированной обработке.

• Метод GetDocuments (V3) теперь позволяет получать информацию обо всех СФ-подобных документах (СФ/ИСФ/КСФ/ИКСФ) единым списком. Для этого в качестве первой части параметра filterCategory нужно передать специальное значение AnyInvoiceDocumentType. Например, чтобы получить список всех входящих СФ/ИСФ/КСФ/ИКСФ, нужно в метод GetDocuments передать параметр filterCategory=AnyInvoiceDocumentType.Inbound.

04.04.2012

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

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

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

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

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

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

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

  Схемы приведены в разделе 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 — возвращает список контрагентов, отфильтрованный по их статусу;

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

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

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

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

  • 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

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