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

27.02.2024

SDK: C# 2.14.6

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

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

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

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

20.02.2024

02.02.2024

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

20.12.2023

SDK: C# 2.14.5

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

    • в структуру PowerOfAttorneyToPost добавлен флаг UseDocumentContent;

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

03.11.2023

SDK: C# 2.14.3

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

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

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

30.10.2023

SDK: C# 2.14.2

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

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

25.09.2023

SDK: C# 2.13.0 | Java 3.15.2

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

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

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

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

10.08.2023

SDK: C# 2.12.1

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

22.06.2023

SDK: C# 2.12.0

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

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

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

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

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

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

19.05.2023

SDK: C# 2.11.8 | Java 3.13.0

10.04.2023

SDK: C# 2.11.7

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

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

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

10.03.2023

SDK: C# 2.11.6 | Java 3.14.0

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

11.01.2023

SDK: C# 2.11.5

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

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

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

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

21.06.2022

SDK: C# 2.11.0

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

05.04.2022

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

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

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

28.03.2022

SDK: Java 3.9.9

23.02.2022

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

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

21.02.2022

SDK: C# 2.9.28

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

26.01.2022

SDK: C# 2.9.23

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

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

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

06.10.2021

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

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

05.10.2021

SDK: C# 2.9.21

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

20.09.2021

SDK: C# 2.9.20

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

01.09.2021

SDK: C# 2.9.19

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

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

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

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

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

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

19.07.2021

SDK: C++ 1.92.6

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

29.06.2021

SDK: C# 2.9.15

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

25.06.2021

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

20.05.2021

SDK: C# 2.9.13

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

04.05.2021

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

23.03.2021

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

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

17.03.2021

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

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

17.02.2021

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

10.12.2020

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

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

07.12.2020

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

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

05.11.2020

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

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

24.08.2020

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

27.07.2020

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

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

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 расширены и поддерживают весь функционал нового метода.

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.

29.03.2018

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

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

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

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

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

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