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

04.05.2021

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

23.03.2021

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

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

17.03.2021

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

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

17.02.2021

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

10.12.2020

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

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

07.12.2020

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

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

05.11.2020

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

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

MessageProxyBoxId и MessageProxyDepartmentId возвращаются в Template и TemplateToLetterTransformationInfo.

24.08.2020

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

27.07.2020

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

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

14.07.2020

SDK: C# 2.5.0 | Java 3.3.0 | C++ 1.84.0

  • Добавлена поддержка подписания сертификатами МЭП в метод DssSign

30.06.2020

SDK: C# 2.3.0

  • Docflow V3 добавлен в COM Api

24.01.2020

SDK: Java 3.2.1

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

20.05.2020

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

24.01.2020

SDK: C# 2.0.0

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

26.12.2019

SDK: Java 3.0.0

  • Произошёл глобальный рефакторинг Java SDK, в котором внутреннее устройство библиотеки переработано, обновились зависимости и произошли некоторые breaking changes.
  • Добавлена поддержка подписания по ГОСТ 2012 в CertificateHelper. Библиотека сама определяет ГОСТ сертификата, и подписывает соответствующим алгоритмом.
  • Произошло изменение контракта ошибок, сейчас любая ошибка оборачивается в тип DiadocSdkException
  • Добавлены доменные клиенты, обратиться к которым можно через корневой объект DiadocApi. Методы перемещены по соответствующим доменным клиентам, а в старых методах сделаны перевызовы. Все старые методы помечены @Deprecated, и будут удалены в ближайшее время.
  • Breaking changes:
  • Тип GeneratedFile перемещён в пакет Diadoc.Api.httpClient;
  • Тип DiadocErrorException переименоват в DiadocException
  • Тип DocumentsFilter перемещён в пакет Diadoc.Api.document, и изменён его интерфейс. Убрали публичные поля, вместо них добавлены fluent setters
  • В классе CertificateHelper переименовали методы на camelCase нотацию

24.12.2019

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

  • Добавлен метод PostTemplatePatch, который позволяет отправлять дополнения к шаблонам документов.
  • Добавлена возможность с помощью этого метода и структуры TemplateRefusalAttachment выполнить отзыв или отклонение шаблона.
  • В структуры Entity и DocumentTemplateInfo добавлена информация об отзыве и отклонении шаблона.

13.12.2019

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

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

12.12.2019

SDK: C# 1.85.3 | Java 2.19.1

25.11.2019

SDK: C# 1.85.0

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

30.09.2019

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

  • Выпущен метод GenerateReceiptXml, который позволяет сгенерировать извещение о получении на любую сущность в документообороте, для которой оно требуется.
  • Для обратной совместимости старые урлы GenerateDocumentReceiptXml и GenerateInvoiceDocumentReceiptXml расширены и поддерживают весь функционал нового метода.

18.09.2019

SDK: C# 1.83.0 | Java 2.18.0 | C++ 1.79.0

17.09.2019

SDK: C# 1.82.1

  • Добавили новую версию utd820_05_01_01_hyphen для всех типов документов, поддерживающих формат приказа №820 — счета-фактуры и их исправления, акты, накладные, УПД, иУПД.

Версия полностью совместима с utd820_05_01_01. Отличается только генерация и парсинг. Теперь при генерации необходимо явно задать атрибуты вида ДефНомИспрСчФ, ДефДатаИспрСчФ, ДефОКЕИ_Тов, ДефСтТовУчНал, ДефСтТовУчНалВсего, ДефКодПроисх, ДефИННЮЛ, ДефИННФЛ, элемент ДефНДС, и при парсинге учитывать наличие этих атрибутов в UserDataXML. Также можно явно указывать ФНС-идентификаторы отправителя (ИдОтпр) и получателя (ИдПол). Может быть полезно в случаях, когда в документе указано несколько продавцов (элемент xml СвПрод) или покупателей (СвПокуп), и нужно явно определить, кто из них является участником документооборота. Более подробные отличия можно посмотреть в XSD-схеме, доступной в поле UserDataXSD ответа метода GetDocumentTypes. - Для C# SDK добавили кодогенерацию новой XSD, доступной по ссылке.

17.09.2019

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

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

06.09.2019

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

  • В возвращаемое значение метода AcquireCounteragentResult добавлено поле InvitationDocumentId.
  • В структуру Counteragent добавлено поле InvitationDocumentId.

27.08.2019

SDK: Java 2.16.0 | C++ 1.78.0

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

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

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

05.08.2019

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

14.07.2019

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

  • Реализован метод DetectCustomPrintForms, возвращающий информацию о наличии у документа нестандратной печатной формы
  • Свойство HasCustomPrintForms структуры Document объявлено устаревшим и более не заполняется (всегда возвращается false)

09.07.2019

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

  • Добавлен метод GetMyEmployee, возвращающий информацию о текущем сотруднике организации
  • Метод GetMyPermissions объявлен устаревшим
  • Добавлена возможность управлять правом сотрудника удалять документы и черновики, восстанавливать документы. В структуру OrganizationUserPermissions добавлен флаг CanDeleteRestoreDocuments

09.07.2019

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

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

05.07.2019

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

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

11.06.2019

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

27.05.2019

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

  • Добавлена поддержка формата приказа №820:
    • Через метод GetDocumentTypes можно найти версии с идентификатором utd820_05_01_01 для всех типов документов, поддерживающих новый формат — счета-фактуры, акты, накладные, УПД, иУПД.
  • Добавлены значения в контракты ExtendedSigner и DocumentTitleType для поддержки версий формата приказа №820.

16.05.2019

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

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

14.05.2019

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

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

07.05.2019

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

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

24.04.2019

SDK: C# 1.68.0 | Java 2.4.0

  • В контракте DocflowV3
    • Удалён контракт ProxyResponseDocflow
    • Изменён контракт RecipientResponseDocflow:
  • Контракт переименован в ParticipantResponseDocflow
  • Поле RecipientTitle переименовано в Title
  • Поле RecipientResponseStatus переименовано ResponseStatus
  • В контракте DocflowV3 удалено поле ProxyResponse = 3 и вместо него добавлено поле ProxyResponse = 11, структура которого соответствует ParticipantResponseDocflow

23.04.2019

SDK: C# 1.67.0 | Java 2.3.0

  • В контракты DocflowV3 добавлены свойства, содержащие текстовые выдержки соответствующих документов.
  • В контракт SignatureRejectionDocflow добавлено свойство PlainText, которое содержит текст сообщения об отказе в подписи
  • В контракт AmendmentRequestDocflow добавлено свойство PlainText, которое содержит текст запроса уточнения
  • В контракт RevocationRequestDocflow добавлено свойство PlainText, которое содержит текст запроса аннулирования

09.03.2019

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

  • В контракт ResolutionRequestType добавлен тип согласования Custom.
  • В контракт ResolutionRequestInfo добавлено свойство Actions, в котором перечислены доступные действия для запроса согласования
  • В контракт ResolutionStatusType добавлен тип запроса согласования ActionsRequested (соответствует типу Custom).
  • В контракт ResolutionStatus добавлено свойство ActionsRequested
  • В контракт ResolutionRequestV3 добавлено свойство Actions, в котором перечислены доступные действия для запроса согласования

30.01.2019

SDK: Java 2.0.0

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

15.01.2019

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

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

26.12.2018

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

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

24.12.2018

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

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

14.12.2018

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

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

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

  • Добавлена возможность работы с извещением о получении на титул получателя:
    • Обновились настройки документооборота для всех типов документа, добавлена новая настройка.
    • В структуре MessagePatchToPost поля RecipientTitles, XmlTorg12BuyerTitles, XmlAcceptanceCertificateBuyerTitles, UniversalTransferDocumentBuyerTitles сменили сообщение протобуфера с ReceiptAttachment на RecipientTitleAttachment.
    • В структуру 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

29.08.2018

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

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

20.08.2018

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

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

08.08.2018

SDK: C# 1.52.4

07.08.2018

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

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

06.08.2018

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

  • Добавлен флаг HasCertificateToSign в структуру Organization.

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-схему контракта для генерации титула с помощью обобщённого метода генерации.

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.

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

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, возвращающий описание типов документов, доступных в ящике.
  • В структуре MessageToPost, которую принимает метод /V3/PostMessage, изменилось поле CustomDocumentAttachments. Теперь оно называется DocumentAttachments и может использоваться для отправки документов любых типов.

19.10.2017

  • Добавили ограничение на количество документов в структуре MessageToPost, которую можно отправить через метод PostMessage. Текущее максимально допустимое количество документов в сообщении - 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. Возвращаются отменённые запросы на согласование вместе с соответствующими сущностями отмены. Ранее, отменённый запрос на согласование не возвращался и, соответственно, не было возможности определить, что данный запрос на соглавание был отменён.

30.08.2017

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

23.08.2017

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

  • Добавлена структура данных SignatureInfo, содержащая информацию о подписи и сертификате.
  • Добавлен метод GetSignatureInfo, получающий на вход идентификаторы подписи и возвращающий данные в структуре SignatureInfo.
  • В структуре данных InvoiceItemAmountsDiff поле Subtotal, отражающее сумму с учетом налога, теперь является опциональным.
  • Добавлена вторая версия метода ExtendedSignerDetails, принимающая на вход структуру DocumentTitleType

13.07.2017

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

Добавлены следующие поля:

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

29.06.2017

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

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

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

06.06.2017

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

Добавлено наименование первичного документа.

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

02.06.2017

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

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

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

03.05.2017

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

В структуре данных Document появилось поле ProxySignatureStatus, отвечающее за статус подписи промежуточного получателя. В структуре Message в поле Entities теперь возвращаются сами подписи промежуточного получателя.

11.04.2017

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

Добавлена возможность определить версию XSD-схемы, в соответствии с которой был отправлен документ.

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

30.03.2017

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

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

В структурах данных ReconciliationActAttachment и AcceptanceCertificateAttachment поле DocumentNumber стало необязательным.

27.03.2017

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

Добавлена возможность снимать документ с маршрута согласования, подробнее см. описание поля ResolutionRouteRemovals в структуре MessagePatchToPost. Также произошла замена термина «цепочка согласования» на маршрут согласования в документации, а в названиях структур данных и HTTP-методах слово Chain заменено словом Route.

Полный список всех переименований:

  • в enum-е AttachmentType элемент ResolutionChainAssignment переименован в ResolutionRouteAssignment
  • в структуре MessagePatchToPost поле ResolutionChainAssignments переименовано в ResolutionRouteAssignments
  • структура ResolutionChainAssignment переименована в ResolutionRouteAssignment
  • в структуре ResolutionRouteAssignment поле ChainId переименовано в RouteId
  • структура ResolutionChainList переименована в ResolutionRouteList
  • в структуре ResolutionRouteList поле ResolutionChains переименовано в ResolutionRoutes
  • структура ResolutionChain переименована в ResolutionRoute
  • в структуре ResolutionRoute поле ChainId переименовано в RouteId
  • HTTP-метод GetResolutionChainsForOrganization переименован в GetResolutionRoutesForOrganization

24.03.2017

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

15.03.2017

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

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

Основное отличие версии V5 от версии V4 в том, что новая версия метода работает для всех пользователей в ящике.

Лента событий формируется по подразделению организации, в котором состоит пользователь. Подробное описание есть метода здесь /.

10.02.2017

SDK: C# 1.38.3

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

23.12.2016

  • Добавлена возможность работать с новыми типами документов УПД и УКД, в связи с чем в документацию добавлены разделы, описывающие:
  • Добавлены методы:
  • Добавлены структуры:
  • В структуре MessageToPost добавлено поле UniversalTransferDocumentSellerTitles:
  • для отправки УПД с функцией СЧФ,
  • для отправки УКД с функцией КСЧФ,
  • для отправки титула продавца УПД с функцией ДОП и СЧФДОП,
  • для отправки титула продавца УКД с функцией ДОП и СЧФДОП.
  • Для отправки титула покупателя УПД и УКД в структуре MessageToPost добавлено поле UniversalTransferDocumentBuyerTitles:
  • для отправки титула покупателя УПД с функцией ДОП и СЧФДОП,
  • для отправки титула покупателя УКД с функцией ДОП и СЧФДОП.
  • В структуру PrepareDocumentsToSignRequest добавлена возможность указать расширенные данные о подписанте.
  • В DocflowAPI внесены следующие изменения:
  • добавлены структуры для описания документооборота УПД:
  • в структуру Docflow добавлены поля InboundUniversalTransferDocumentDocflow и OutboundUniversalTransferDocumentDocflow;
  • в структуру DocumentInfo добавлены поля UniversalTransferDocumentInfo и UniversalCorrectionDocumentInfo.

10.10.2016

SDK: C# 1.37

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

Примечание

Функциональность находится в разработке.

07.04.2016

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

25.03.2016

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

10.03.2016

  • Добавлена возможность редактировать пакеты документов. Для этого:
  • в структуру MessagePatchToPost добавлено поле EditDocumentPacketCommands;
  • добавлена структура EditDocumentPacketCommand, описывающая операцию редактирования пакета документов.

10.02.2016

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

19.01.2016

  • Значения перечисления ResolutionType (Resolution) синхронизированы со значениями, возвращаемые с сервера (значение Undefined заменено на UndefinedResolutionType).
  • В структуру MessageToPost добавлен флаг залоченного пакета LockPacket.

02.12.2015

  • В структуру Document добавлено свойство с сообщением об ошибке при доставке в роуминг RoamingNotificationStatusDescription.
  • Добавлены новые версии методов GetCounteragent и GetCounteragents, в которых изменилась логика показа видимых подразделений.

11.11.2015

  • Добавлено свойство «признак прочитанности« IsRead в структуре Document.
  • Методе GetDocuments теперь позволяет искать непрочитанные документы.

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

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

20.01.2015

15.10.2014

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

02.10.2014

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

05.06.2014

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

25.02.2014

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

05.02.2014

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

24.01.2014

  • Добавлена возможность пересылать документы третьей стороне. См. описание методов ForwardDocument, GetForwardedDocuments и GetForwardedDocumentEvents. Выгрузка содержимого связанных с документом сущностей адресатом пересылки документа третьей стороне производится с помощью метода GetForwardedEntityContent.

20.12.2013

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

06.12.2013

  • Добавлена возможность отправлять формализованные отказы от подписи документов. Xml-файл отказа формируется с помощью метода GenerateSignatureRejectionXml.
  • Для отправки отказов используется метод PostMessagePatch, в который передается структура MessagePatchToPost с заполненным списком MessagePatchToPost.XmlSignatureRejections.
  • Для получения документов с отказом в подписи через метод GetDocuments используются такие же фильтры, как для неформализованных отказов. Формализованным отказам соответствует тип XmlSignatureRejection из перечисления AttachmentType.
  • Отправка неформализованных отказов от подписи в адрес роуминговых организаций теперь запрещена.
  • Новые отказы от подписи, при получении их через старые версии SDK, будут иметь тип SignatureRequestRejection (как отказы старого формата), но в содержимом соответствующих сущностей вместо строки с комментарием к отказу теперь будет возвращаться xml файл отказа в кодировке CP1251.

20.10.2013

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

13.08.2013

10.04.2013

  • Добавлена поддержка нового типа полуформализованных документов - ценовых листов. Ценовой лист представляет собой двусторонний документ (для него требуется подпись контрагента/отказ в запросе подписи) со следующими обязательными реквизитами: дата составления и номер самого ценового листа, дата вступления ценового листа в силу, дата и номер договора, к которому относится ценовой лист.
  • Для отправки ценовых листов через API при обращении к методу PostMessage следует наполнять список MessageToPost.PriceLists. Каждый элемент этого списка представляет собой структуру PriceListAttachment.
  • При получение информации о документах через API с помощью методов GetMessage, GetDocument и т.п. для ценовых листов в структуре Document заполняется поле PriceListMetadata.
  • При фильтрации документов методом GetDocuments также можно использовать новый тип документов PriceList.
  • Для получения списка пользователей конкретной организации добавлен метод GetOrganizationUsers.
  • В структуру Organization добавлено поле IfnsCode, позволяющее получить код налоговой инспекции - место подачи декларации по НДС.

14.03.2013

  • Добавлена возможность отправлять документы, подписанные тестовой подписью (см. описание флага SignedContent.SignWithTestSignature).
  • Добавлены методы ParseAcceptanceCertificateSellerTitleXml и ParseTorg12SellerTitleXml, позволяющие преобразовывать xml-файлы формализованных актов (титул исполнителя) и ТОРГ-12 (титул продавца) в структуры AcceptanceCertificateSellerTitleInfo и Torg12SellerTitleInfo соответственно.
  • Расширена функциональность метода PostMessage: с помощью флага MessageToPost.DelaySend можно задержать отправку документа, чтобы была возможность провести его согласование. В связи с этим изменился набор возможных состояний документов, что требует обновления логики клиентских решений.
  • Чтобы определить, может ли пользователь запрашивать согласования, используйте флаг OrganizationUserPermissions.CanRequestResolutions в свойствах пользователя, возвращаемых методом GetMyPermissions.
  • В сообщение EntityPatch добавлено поле ContentIsPatched, через которое сервер выдает информацию о том, что исходный документ в процессе подписания был модифицирован (в документ была внедрена информация о том, кто подписал этот документ).
  • Изменена логика работы с перечислимыми типами: теперь в большинстве перечислений имеется специальное значение с именем UnknownИмяПеречисления. Клиент получит такое значение только том случае, если есть рассогласование версий API между клиентом и сервером, и клиент не может правильно интерпретировать информацию, возвращаемую сервером (например, в случае добавления новых элементов к перечислению клиент будет получать вместо вновь добавленных элементов значение UnknownИмяПеречисления). Клиент должен корректно обрабатывать такие ситуации (например, путем информирования пользователя о необходимости обновить интеграционный модуль).

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

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

31.01.2013

  • Добавлена возможность работы с документами, пересылаемыми внутри организации. Для этого:
  • Расширены возможности работы с «черновиками», то есть с подготовленными, но не отправленными документами:
  • Для отправки ранее созданного черновика добавился метод SendDraft.
  • Черновики теперь можно загружать в Диадок с помощью метода PostMessage (это предпочтительный путь).
  • Обновилась структура MessageToPost, добавлена структура DraftToSend и структура RequestedSignature переименована в DocumentSignature (см. описание MessagePatchToPost).
  • Добавлена возможность загружать большие по размеру документы в Диадок с помощью сервиса «полки документов». Для этих целей добавился метод ShelfUpload и обновилась структура SignedContent, в которой появилось поле NameOnShelf, позволяющее сослаться на уже загруженный на «полку» файл.
  • Добавлена возможность восстанавливать ранее удаленные отдельные документы и сообщения целиком. Для этих целей добавлен метод Restore, а в структурах EntityPatch и MessagePatch добавлены поля, позволяющие узнать, были ли конкретный документ или сообщение восстановлены.
  • Добавлена возможность по документу (Document <Document>) или сообщению (Message <Message>) понять, является ли он юридически значимым. Для этих целей в каждую из названных структур добавлено поле IsTest.
  • Добавлена возможность проводить эвристический семантический разбор строк, представляющих почтовый адрес в Российской Федерации. За это отвечает метод ParseRussianAddress.
  • Добавлена возможность выполнять трансформацию XML-файла СФ/ИСФ, сформированного в соответствии с XML-схемой, в структуру InvoiceInfo. За это отвечает метод ParseInvoiceXml.

29.08.2012

  • В структуру данных Organization добавлено поле Departments, содержащее список всех подразделений в организации. Это поле позволяет получать информацию об оргструктуре с помощью методов GetMyOrganizations, GetOrganization, GetCounteragents, GetCounteragent.
  • В методах PostMessage и PostDraft добавлена возможность отправлять документы в конкретное подразделение контрагента. Для этого:
  • в структуру данных MessageToPost добавлено новое поле ToDepartmentId;
  • в метод PostDraft добавлен новый параметр toDepartmentId.
  • Добавлен метод MoveDocuments для перемещения документов своей организации между подразделениями. Информация о перемещениях документов между подразделениями (неважно было это сделано через API или через Web) доступна через метод GetNewEvents.
  • В структуре данных EntityPatch добавлено поле MovedToDepartmentId.
  • В структуру данных Entity добавлено поле RawCreationDate, содержащее метку времени создания сущности. Это поле заполняется для всех сущностей, его можно использовать для получения времени подписания или согласования документа.
  • Добавлена возможность осуществлять согласование (или отказ в согласовании) документов через API. Для этого:
  • Добавилась структура данных Resolution.
  • В структуре данных MessagePatchToPost добавлено поле Resolutions.
  • Все действия по согласованию видны в структуре данных Message как сущности с типом Attachment/Resolution. Содержимое этой сущности - байты строки комментария к согласованию в кодировке UTF-8.
  • В структуру данных Entity добавлено поле ResolutionInfo, содержащее тип действия по согласованию и ФИО согласователя в виде новой структуры данных ResolutionInfo.

26.06.2012

  • Добавлен метод Delete, который помечает документы как удаленные.
  • В структурах данных Document и Message добавлены флаги IsDeleted.
  • В структуру данных MessagePatch был добавлен флаг MessageIsDeleted и поле EntityPatches, содержащее список структур данных типа EntityPatch с флагом DocumentIsDeleted. Эти изменения структуры MessagePatch позволяют отслеживать моменты удаления документов и/или сообщений, анализируя поток событий в ящике, возвращаемый методом GetNewEvents.
  • Добавлен метод 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 можно загружать в Диадок титулы продавца XML-накладных (новый тип документов Attachment/XmlTorg12) и титулы исполнителя XML-актов (новый тип документов Attachment/XmlAcceptanceCertificate), а с помощью метода PostMessagePatch можно загружать в Диадок соответствующие титулы покупателя/заказчика. В SDK включены XML-схемы, описывающие рекомендованные ФНС России форматы товарных накладных и актов о выполнении работ/оказании услуг:
  • Добавлены методы GenerateTorg12XmlForSeller, GenerateTorg12XmlForBuyer, GenerateAcceptanceCertificateXmlForSeller и GenerateAcceptanceCertificateXmlForBuyer, облегчающие процесс формирования корректных XML-файлов товарных накладных и актов. Поддержка новых типов документов добавлена и в метод GetDocuments.
  • Добавлена возможность с помощью метода PostMessage загружать в Диадок счета на оплату (новый тип документов Attachment/ProformaInvoice). Поддержка данного типа документов добавлена и в метод GetDocuments.
  • В метод PostMessage добавлена возможность загружать в Диадок вложения специального типа «структурированные данные» (Attachment/StructuredData <proto/Entity message>), с помощью которого можно организовать передачу рядом с юридически-значимой печатной формой документа каких-то данных, подлежащих автоматизированной обработке.
  • Метод GetDocuments теперь позволяет получать информацию обо всех СФ-подобных документах (СФ/ИСФ/КСФ/ИКСФ) единым списком. Для этого в качестве первой части параметра filterCategory нужно передать специальное значение AnyInvoiceDocumentType. Например, чтобы получить список всех входящих СФ/ИСФ/КСФ/ИКСФ, нужно в метод GetDocuments передать параметр filterCategory=AnyInvoiceDocumentType.Inbound.

04.04.2012

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

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

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

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

  • Добавлен метод GetInvoiceCorrectionRequestInfo, возвращающий информацию, содержащуюся в уведомлении об уточнении счета-фактуры, без необходимости уметь разбирать соответствующий XML-формат, утвержденный ФНС, что в какой-то степени упрощает работу интегратора. В частности, метод GetInvoiceCorrectionRequestInfo позволяет получить текст уведомления об уточнении.
  • Добавлены методы PostMessage и PostDraft позволяющие загружать в Диадок акты о выполнении работ/оказании услуг (новый тип документов Attachment/AcceptanceCertificate). Поддержка нового типа документов добавлена и в метод GetDocuments.
  • Метод GetDocuments теперь возволяет фильтровать список документов по дате формирования документа в учетной системе (реквизиту самого документа), а не только по дате загрузки документа в Диадок. Для этого в метод GetDocuments добавлены необязательные параметры строки запроса fromDocumentDate и toDocumentDate, которые позволяют задать интервал времени, в котором осуществляется поиск. При этом метод GetDocuments продолжает поддерживать фильтрацию списка документов с помощью параметров timestampFromTicks и timestampToTicks.
  • Добавлены методы для работы с черновиками:
  • Метод GetNewEvents теперь возвращает информацию о событиях, происходящик с черновиками: создание черновика (и начальный набор документов в нем), добавление к черновику документов, утилизация черновика (просто удаление, либо отправка на основе него полноценного сообщения).
  • Методы GetEvent и GetMessage теперь возвращают информацию о черновиках.
  • Добавлен метод RecycleDraft, который удаляет еще неотправленные черновики.
  • В сообщение Message добавлено необязательное поле CreatedFromDraftId, в которое заносится идентификатор черновика, на основании которого было создано данное сообщение (или черновик).
  • В черновике появилось поле DraftIsTransformedToMessageId, в которое заносится идентификатор сообщения (или черновика), которое было создано из данного черновика. Флаг Message.DraftIsRecycled означает, что черновик был утилизирован, то есть удален или преобразован в полноценное сообщение или в другой черновик. Поля DraftIsTransformedToMessageId и DraftIsRecycled могут присутствовать в структуре Message, описывающей черновик, одновременно.
  • Метод PostDraft теперь позволяет создать нередактируемые черновики - черновики, которые можно только отправить или удалить. Добавление или удаление документов из таких черновиков заблокировано как в веб-интерфейсе Диадока, так и в API-методе PostDraft. Для создания нередактируемого черновика нужно в метод PostDraft передать параметр lock без значения.

18.01.2012

  • Добавлены методы для управления списком контрагентов:
  • Метод GetCounteragents возвращает список контрагентов, отфильтрованный по их статусу.
  • Метод GetCounteragent возвращает информацию о контрагенте по его идентификатору.
  • Метод AcquireCounteragent добавляет организацию в список своих контрагентов.
  • Метод BreakWithCounteragent исключает организацию из списка своих контрагентов.
  • Переработан механизм получения справочной информации об организациях и ящиках в Диадоке. Методы GetBoxInfo, GetBoxesByInnKpp и GetBoxesByAuthToken объявлены устаревшими и не рекомендуются к использованию. Через некоторое время их поддержка будет прекращена.
  • Вместо метода GetBoxesByAuthToken используйте метод GetMyOrganizations, который возвращает информацию об организациях и ящиках, к которым имеет доступ владелец текущего авторизационного токена.
  • Вместо метода GetBoxesByInnKpp используйте метод GetOrganizationsByInnKpp, который возвращает информацию о ящиках в Диадоке по ИНН и КПП организации.
  • Вместо метода GetBoxInfo используйте методы GetOrganization и GetBox, возвращающие информацию о конкретных организации и ящике по их идентификаторам.

16.12.2011

  • Добавлен метод GetDocuments, позволяющий быстро получать информацию о документах (например, о счетах-фактурах) в своем ящике, задавая различные критерии фильтрации документов.
  • Добавлен метод GetDocument, позволяющий получить всю метаинформацию об отдельном документе, зная его идентификатор.
  • Добавлена возможность с помощью методов PostMessage и 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 при отправке корректировочного счета-фактуры.
  • Добавлена возможность отправить через API отказ от запрошенной подписи. Для этого в структуре MessagePatchToPost появилось необязательное поле RequestedSignatureRejections.
  • Добавлена возможность отслеживания отдельных документов при отправке их через черновики. Для этого метод PostDraft возвращает вместе с идентификатором черновика еще и идентификатор сущности, в которую превращается загруженный документ.
  • Уведомления о невозможности доставки теперь ссылаются на недоставленные куски сообщения.
  • Для этого в структуре Entity появилось необязательное поле NotDeliveredEventId. NotDeliveredEventId - это идентификатор сообщения или патча, который не удалось доставить (например, из-за некорректности одной или нескольких подписей в нем).
  • Получить недоставленный кусок сообщения можно с помощью метода GetEvent, передав ему в качестве параметра eventId значение NotDeliveredEventId. Данное поле заполняется только у сущности типа Attachment с типом вложения DeliveryFailureNotification.

15.04.2011

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

07.04.2011

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

30.03.2011

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

18.02.2011

  • Добавлены методы для получения справочной информации GetBoxInfo и GetBoxesByInnKpp.
  • Добавлен метод GetEntityContent для получения контента вложений по отдельности.
  • Метод GetMessage перестал отдавать весь контент свыше 1Мб единовременно. Используйте метод GetEntityContent.

09.12.2010

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