История изменений 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

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

24.01.2020

SDK: Java 3.2.1

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

20.05.2020

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

24.01.2020

SDK: C# 2.0.0

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

26.12.2019

SDK: Java 3.0.0

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

24.12.2019

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

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

13.12.2019

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

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

12.12.2019

SDK: C# 1.85.3 | Java 2.19.1

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

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

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

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

16.08.2019

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

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

15.08.2019

SDK: C# 1.79.0

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

05.08.2019

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

14.07.2019

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

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

09.07.2019

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

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

09.07.2019

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

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

05.07.2019

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

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

11.06.2019

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

27.05.2019

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

  • через метод 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

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

23.04.2019

SDK: C# 1.67.0 | Java 2.3.0

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

09.03.2019

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

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

30.01.2019

SDK: Java 2.0.0

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

15.01.2019

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

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

26.12.2018

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

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

24.12.2018

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

  • Следующие методы генерации и парсинга документов получили поддержку ставки 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

  • Добавлена возможность работы с извещением о получении на титул получателя:
  • обновлены настройки документооборота 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:

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

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

  • добавлен необязательный признак 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. Теперь оно называется DocumentAttachment и может использоваться для отправки документов любых типов.

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,
  • метод GetResolutionChainsForOrganization переименован в GetResolutionRoutesForOrganization.

24.03.2017

15.03.2017

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

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

10.02.2017

SDK: C# 1.38.3

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

  • В структуре Document добавлено свойство «признак прочитанности» IsRead .
  • Метод 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:— он указывается для передачи контента в зашифрованном виде;
  • добавлены структуры для передачи зашифрованных счетов-фактур и метаданных для исправлений и корректировок:
  • в структуре 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

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

Выгрузка содержимого сущностей, связанных с документом, адресатом пересылки документа третьей стороне производится с помощью метода 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 добавлены поля, позволяющие узнать, были ли конкретный документ или сообщение восстановлены.
  • Добавлена возможность по документу или сообщению понять, является ли он юридически значимым. Для этих целей в каждую из названных структур добавлено поле 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-схемы, описывающие рекомендованные ФНС России форматы товарных накладных и актов о выполнении работ/оказании услуг:
  • Добавлены методы, облегчающие процесс формирования корректных XML-файлов товарных накладных и актов:

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

  • Добавлена возможность с помощью метода PostMessage загружать в Диадок счета на оплату (новый тип документов Attachment/ProformaInvoice). Поддержка данного типа документов добавлена и в метод GetDocuments.
  • В метод PostMessage добавлена возможность загружать в Диадок вложения специального типа «структурированные данные» Attachment/StructuredData, с помощью которого можно организовать передачу рядом с юридически-значимой печатной формой документа каких-то данных, подлежащих автоматизированной обработке.
  • Метод 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 на AmendmentRequested\Corrected.

  • Добавлен метод 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 — вместо него используйте методы GetOrganization и GetBox, которые возвращают информацию о конкретных организации и ящике по их идентификаторам;
  • GetBoxesByInnKpp — вместо него используйте метод GetOrganizationsByInnKpp, который возвращает информацию о ящиках в Диадоке по ИНН и КПП организации;
  • GetBoxesByAuthToken — вместо него используйте метод GetMyOrganizations, который возвращает информацию об организациях и ящиках, к которым имеет доступ владелец текущего авторизационного токена.

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

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