История изменений 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
Добавлены новые версии методов /V2/GenerateReceiptXml, /V2/GenerateSignatureRejectionXml, /V2/GenerateInvoiceCorrectionRequestXml. Методы генерируют технологические документы в формате, утвержденном приказом № ЕД-7-26/133@.
Добавлены структуры для передачи в теле запроса новых версий методов: ReceiptGenerationRequestV2, InvoiceCorrectionRequestGenerationRequestV2, SignatureRejectionGenerationRequestV2.
10.04.2023¶
SDK: C# 2.11.7
В структуре SignerInfoV2 для поля
SignerType
добавлено новое значение — универсальный подписант.В структуре SignerInfoV2 добавлено поле
SignerUserDataXsdUrl
, которое содержит URL-путь метода, возвращающего файл XSD-схемы упрощённого XML подписанта.В структурах DraftDocumentToPatch, DocumentToPatch и ContentToPatch добавлено поле
SignerContent
.
10.03.2023¶
SDK: C# 2.11.6 | Java 3.14.0
Добавлена новая версия метода /V2/GetWorkflowsSettings. Метод возвращает свойства всех видов документооборота.
11.01.2023¶
SDK: C# 2.11.5
Добавлена структура RoamingSendingStatus для хранения информации о статусе отправки машиночитаемой доверенности (МЧД) в роуминг.
В структурах PowerOfAttorneyInfo и SignaturePowerOfAttorney добавлено поле
SendingStatus
.В структуре DocflowStatusV3 добавлено поле
GeneralRoamingSendingStatus
.Реализована возможность получить информацию о функции роуминговых операторов
SupportsPowerOfAttorney
с помощью метода GetRoamingOperators.
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
В Java SDK реализована функциональность для работы с машиночитаемой доверенностью.
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
API Диадока теперь поддерживает работу с машиночитаемой доверенностью (МЧД).
Реализованы методы для работы с машиночитаемой доверенностью.
Регистрация МЧД:
методы RegisterPowerOfAttorney и RegisterPowerOfAttorneyResult для регистрации МЧД.
Работа с МЧД сотрудника:
метод AddEmployeePowerOfAttorney для привязки МЧД к сотруднику.
метод DeleteEmployeePowerOfAttorney для отвязки МЧД от сотрудника.
метод UpdateEmployeePowerOfAttorney для обновления настроек МЧД сотрудника.
метод GetEmployeePowersOfAttorney для получения всх МЧД сотрудника.
Получение и проверка МЧД:
метод GetPowerOfAttorneyInfo для получения информации о МЧД, отправленной с документом.
метод PrevalidatePowerOfAttorney для предварительной проверки МЧД.
Реализована отправка документов с машиночитаемой доверенностью (МЧД).
При отправке документов методами 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
Внесены изменения для работы с подтверждениями роумингового оператора:
Добавлен новый тип вложения AttachmentType —
RoamingConfirmation
. Он представляет собой подтверждение оператора, отправленное в роуминг или полученное из роуминга.В структуру ConfirmationDocflow добавлено новое поле
RoamingConfirmation
. Оно содержит подтверждение оператора, отправленное в роуминг или полученное из роуминга, представленное структурой OperatorConfirmationDocflow.
06.10.2021¶
SDK: C# 2.9.22 | Java 3.9.8 | C++ 1.92.8
Добавлена новая версия метода /V2/GenerateRevocationRequestXml. Метод позволяет сгенерировать предложение об аннулировании версии 1.02. Если получатель ПоА в роуминге, то метод сгенерирует ту версию, которую поддерживает оператор.
05.10.2021¶
SDK: C# 2.9.21
В структуру ExtendedSignerDetails добавлено значение
Ucd736Buyer
для поддержки формата приказа №736.
20.09.2021¶
SDK: C# 2.9.20
Для титула покупателя
UniversalCorrectionDocumentBuyerTitle
добавлены методыUseSignerDetails
иUseSignerReference
, с помощью которых можно задать объекту значения полейSignerDetails
иSignerReference
соответственно.
01.09.2021¶
SDK: C# 2.9.19
Добавлена новая версия метода /V7/GetNewEvents для получения ленты событий по ящику.
Для методов /V7/GetNewEvents и GetDocflowEvents (версия 3) добавлены новые условия фильтрации по критериям:
подразделение,
тип документа,
тип сообщения (письмо, черновик, шаблон),
контрагент,
направление документооборота (входящий, исходящий, внутренний),
время возникновения события.
19.07.2021¶
SDK: C++ 1.92.6
Добавлен метод GetMyCertificates, который позволяет получить информацию о сертификатах сотрудника.
29.06.2021¶
SDK: C# 2.9.15
Добавлены функции документов
ucd736_05_01_02
иutd820_05_01_02_hyphen
по приказам №736 и №820.
25.06.2021¶
SDK: C# 2.9.14 | Java 3.9.7 | C++ 1.92.4
Добавленое поле ConfirmationDocflow в структуру AmendmentRequestDocflow.
20.05.2021¶
SDK: C# 2.9.13
Добавлены структуры для поддержки документов в формате приказа №736 и примеры их использования.
04.05.2021¶
SDK: C# 2.9.12 | Java 3.9.6 | C++ 1.92.3
Добавлен текстовый статус документа DocflowStatusV3 в структуры Document и DocflowV3.
23.03.2021¶
SDK: C# 2.9.9 | Java 3.9.4 | C++ 1.92.2
Добавлен признак возможности использовать шаблон больше одного раза.
17.03.2021¶
SDK: C# 2.9.8 | Java 3.9.3 | C++ 1.92.1
В структуре Document добавлена информация о промежуточном получателе:
ProxyBoxId
иProxyDepartmentId
.
17.02.2021¶
SDK: C# 2.9.5 | Java 3.9.0 | C++ 1.92.0
Метод GetDocumentTypes заменен второй версией.
10.12.2020¶
SDK: C# 2.9.0 | Java 3.8.0 | C++ 1.91.0
Подготовка клиентов для работы с возможностями частичной приемки.
07.12.2020¶
SDK: C# 2.8.5 | Java 3.7.4 | C++ 1.90.0
В структуры Message и MessagePatch добавлена структура
RevocationRequestInfo
, позволяющая получить информацию о запросе аннулирования.
05.11.2020¶
SDK: C# 2.8.4 | Java 3.7.3 | C++ 1.89.0
В структуре TemplateToPost добавлены поля
MessageProxyBoxId
иMessageProxyDepartmentId
для указания промежуточного получателя документа, который создается из шаблона.MessageProxyBoxId
иMessageProxyDepartmentId
возвращаются в Template и TemplateToLetterTransformationInfo.
24.08.2020¶
SDK: C# 2.7.0 | Java 3.5.0 | C++ 1.86.0
В структуре TemplateDocumentAttachment добавлено поле
CustomData
.
27.07.2020¶
SDK: C# 2.6.0 | Java 3.4.0 | C++ 1.85.0
В метод GetOrganizationsByInnList добавлена инфомация о приглашении контрагента.
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
Добавлено поле
SupportsAmendmentRequest
в ответ метода GetDocumentTypes.Добавлены значения в структуры ExtendedSignerDetails и DocumentTitleType для поддержки версий формата приказа №423.
Добавлены значения
SignerPowers
иSignerStatus
в структуры ExtendedSigner и ExtendedSignerDetailsToPost.
24.01.2020¶
SDK: C# 2.0.0
Добавлена поддержка .NET Standard.
26.12.2019¶
SDK: Java 3.0.0
Выполнен глобальный рефакторинг Java SDK, в котором переработано внутреннее устройство библиотеки, обновлены зависимости и произведены некоторые breaking changes.
Добавлена поддержка подписания по ГОСТ 2012 в
CertificateHelper
. Библиотека сама определяет ГОСТ сертификата, и подписывает соответствующим алгоритмом.Выполнено изменение контракта ошибок: сейчас любая ошибка оборачивается в тип
DiadocSdkException
.Добавлены доменные клиенты, обратиться к которым можно через корневой объект
DiadocApi
. Методы перемещены по соответствующим доменным клиентам, а в старых методах сделаны перевызовы. Все старые методы помеченыDeprecated
, и будут удалены в ближайшее время.Breaking changes:
тип
GeneratedFile
перемещен в пакетDiadoc.Api.httpClient
;тип
DiadocErrorException
переименоват вDiadocException
;тип
DocumentsFilter
перемещен в пакетDiadoc.Api.document
. Изменен его интерфейс: удалены публичные поля, вместо них добавлены fluent setters;в классе
CertificateHelper
методы переименованы на camelCase нотацию.
24.12.2019¶
SDK: C# 1.87.0 | Java 2.21.0 | C++ 1.82.0
Добавлен метод PostTemplatePatch, который позволяет отправлять дополнения к шаблонам документов.
Добавлена возможность с помощью этого метода и структуры TemplateRefusalAttachment выполнить отзыв или отклонение шаблона.
В структуры Entity и DocumentTemplateInfo добавлена информация об отзыве и отклонении шаблона.
13.12.2019¶
SDK: C# 1.86.0 | Java 2.20.0 | C++ 1.81.0
Добавлен метод DetectDocumentTitles, который позволяет определить возможные типы документа у конкретного файла.
12.12.2019¶
SDK: C# 1.85.3 | Java 2.19.1
Следующие методы теперь могут возвращать неточное количество событий
TotalCount
:
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
В метод GenerateUniversalTransferDocumentXmlForSeller добавлен опциональный параметр
documentVersion
.
14.07.2019¶
SDK: C# 1.77.0 | Java 2.13.0 | C++ 1.75.0
Добавлен метод DetectCustomPrintForms, возвращающий информацию о наличии у документа нестандратной печатной формы.
Свойство
HasCustomPrintForms
структуры Document объявлено устаревшим и больше не заполняется (всегда возвращаетсяfalse
).
09.07.2019¶
SDK: C# 1.76.0 | Java 2.12.0 | C++ 1.74.0
Добавлен метод GetMyEmployee, возвращающий информацию о текущем сотруднике организации.
Метод GetMyPermissions объявлен устаревшим.
Добавлена возможность управлять правом сотрудника удалять документы и черновики и восстанавливать документы с помощью метода EmployeePermissions. В структуре OrganizationUserPermissions добавлен флаг
CanDeleteRestoreDocuments
.
09.07.2019¶
SDK: C# 1.75.0 | Java 2.11.1 | C++ 1.73.0
Поле
TransferDocDetails
в структуре EventContent, соответствующее атрибуту ПередатДокум в УКД, стало необязательным.
05.07.2019¶
SDK: C# 1.74.0 | Java 2.10.0 | C++ 1.72.0
Добавлена возможность отправлять шаблоны из/в подразделение методом PostTemplate.
Добавлена возможность перемещать шаблоны между подразделениями методом MoveDocuments.
11.06.2019¶
SDK: C# 1.73.0 | Java 2.9.0 | C++ 1.71.0
Обновлена версия методов GetNewEvents и GetMessage. Новая версия возвращает события по шаблонам Message и MessagePatch.
В метод GetDocflowEvents (версия 3) добавлена информация о шаблонах.
27.05.2019¶
SDK: C# 1.72.0 | Java 2.8.0 | C++ 1.70.0
Добавлена поддержка формата приказа №820:
через метод GetDocumentTypes можно найти версии с идентификатором
utd820_05_01_01
для всех типов документов, поддерживающих новый формат: счета-фактуры, акты, накладные, УПД, иУПД.для генерации и парсинга документов новой версии доступны только обобщенные методы:
В структуры ExtendedSigner и DocumentTitleType добавлены значения в для поддержки версий формата приказа №820.
16.05.2019¶
SDK: C# 1.71.0 | Java 2.7.0 | C++ 1.69.0
Добавлен метод GetOrganizationFeatures для возвращения статуса блокировки ящика и прочих фич ящика.
14.05.2019¶
SDK: C# 1.70.0 | Java 2.6.0 | C++ 1.68.0
Добавлен метод ParseTitleXml для парсинга документа любой версии.
07.05.2019¶
SDK: C# 1.69.0 | Java 2.5.0 | C++ 1.67.0
Добавлены методы Register и RegisterConfirm для регистрации организации и сотрудника по сертификату.
24.04.2019¶
SDK: C# 1.68.0 | Java 2.4.0
В структуре DocflowV3:
удалена структура
ProxyResponseDocflow
;изменена структура
RecipientResponseDocflow
:
структура переименована в ParticipantResponseDocflow;
поле
RecipientTitle
переименовано вTitle
;Поле
RecipientResponseStatus
переименованоResponseStatus
;
удалено поле
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%:
GenerateInvoiceXml — для генерации счетов-фактур,
GenerateTorg12XmlForSeller — для генерации документов в формате приказа 551,
GenerateAcceptanceCertificateXmlForSeller — для генерации документов в формате приказа 552,
GenerateUniversalTransferDocumentXmlForSeller — для генерации документов в форматах УПД и УКД,
ParseInvoiceXml — для парсинга счетов-фактур,
ParseTorg12SellerTitleXml — для парсинга документов в формате приказа 551,
ParseAcceptanceCertificateSellerTitleXml — для парсинга документов в формате приказа 552,
ParseUniversalTransferDocumentSellerTitleXml — для парсинга документов в формате УПД,
ParseUniversalCorrectionDocumentSellerTitleXml — для парсинга документов в формате УКД.
14.12.2018¶
SDK: C# 1.62.0 | Java 1.62.0 | C++ 1.62.0
Добавлено поле
Version
в следующие структуры:
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
;
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
16.04.2018¶
SDK: C# 1.51.2
Расширена структура MessagePatchToPost: добавлен необязательный список операций
EditingPatches
для редактирования контента документа.
12.04.2018¶
SDK: C# 1.51.1 | Java 1.51.1 | C++ 1.51.1
Расширена структура TemplateDocumentAttachment:
добавлен необязательный признак
NeedRecipientSignature
, обозначающий запрос подписи получателя под отправляемым документом, созданным из шаблона;добавлен необязательный идентификатор настройки редактирования содержимого документа EditingSettingId.
29.03.2018¶
SDK: C# 1.51 | Java 1.51 | C++ 1.51
Добавлены метки Метки (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
Добавлены структуры TovTorgInfo и AcceptanceCertificate552Info для описания накладных и актов в формате приказов №551/552.
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¶
Добавлены подписи промежуточных получателей и их статусы:
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
В структуре OrganizationWithCounteragentStatus добавлено поле
LastEventTimestampTicks
.
23.12.2016¶
Добавлена возможность работать с новыми типами документов УПД и УКД, в связи с чем в документацию добавлены разделы, описывающие:
методы и структуры для работы с УПД.
Добавлены методы:
GenerateUniversalTransferDocumentXmlForSeller — генерация титула продавца УПД и УКД,
GenerateUniversalTransferDocumentXmlForBuyer — генерация титула покупателя УПД и УКД,
ParseUniversalTransferDocumentSellerTitleXml — парсинг титула продавца УПД,
ParseUniversalTransferDocumentBuyerTitleXml — парсинг титула покупателя УПД,
ExtendedSignerDetails — заполнение дополнительных данных (для УПД и УКД) о подписантах.
Добавлены структуры:
UniversalTransferDocumentSellerTitleInfo — для описания титула продавца УПД,
UniversalTransferDocumentBuyerTitleInfo — для описания титула покупателя УПД,
UniversalCorrectionDocumentSellerTitleInfo — для описания титула продавца УКД,
UniversalTransferDocumentBuyerTitleInfo — для описания титула покупателя УКД,
UniversalDocumentMetadata — для описания данных УПД и УКД,
ExtendedOrganizationInfo — для описания реквизитов продавца, покупателя и грузоотправителя, используемая в УПД и УКД,
ExtendedSigner — для описания реквизитов подписанта, используемая в УПД и УКД,
ExtendedSignerDetailsToPost — для описания реквизитов подписанта, используемая в методе ExtendedOrganizationInfo.
В структуре MessageToPost добавлено поле
UniversalTransferDocumentSellerTitles
:
для отправки УПД с функцией СЧФ,
для отправки УКД с функцией КСЧФ,
для отправки титула продавца УПД с функцией ДОП и СЧФДОП,
для отправки титула продавца УКД с функцией ДОП и СЧФДОП.
Для отправки титула покупателя УПД и УКД в структуре MessageToPost добавлено поле
UniversalTransferDocumentBuyerTitles
:
для отправки титула покупателя УПД с функцией ДОП и СЧФДОП,
для отправки титула покупателя УКД с функцией ДОП и СЧФДОП.
В структуре PrepareDocumentsToSignRequest добавлена возможность указать расширенные данные о подписанте.
В DocflowAPI внесены следующие изменения:
добавлены структуры для описания документооборота УПД:
InboundUniversalTransferDocumentDocflow — входящий УПД,
OutboundUniversalTransferDocumentDocflow — исходящий УПД,
UniversalTransferDocumentInfo — дополнительные данные о УПД,
UniversalCorrectionDocumentInfo — дополнительные данные о УКД;
в структуре Docflow добавлены поля
InboundUniversalTransferDocumentDocflow
иOutboundUniversalTransferDocumentDocflow
;в структуре DocumentInfo добавлены поля
UniversalTransferDocumentInfo
иUniversalCorrectionDocumentInfo
.
10.10.2016¶
SDK: C# 1.37
Добавлена структура CustomDocumentAttachment для отправки кастомных типов документов.
Примечание
Функциональность находится в разработке.
07.04.2016¶
В метод GetOrganizationsByInnKpp добавлен параметр
includeRelations
, который позволяет получить данные о количестве запросов на поиск и приглашения к сотрудничеству для данной организации.
25.03.2016¶
Добавлена возможность авторизации по логину/паролю и сертификату с ключом, полученным доверенным сервисом. Подробности в описании методов Authenticate и 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¶
Добавлена возможность аннулирования документов.
Для отправки предложения об аннулировании через API при обращении к методу PostMessagePatch заполните список MessagePatchToPost.RevocationRequests. Каждый элемент этого списка представляет собой структуру RevocationRequestAttachment.
Для принятия предложения об аннулировании через API при обращению к методу PostMessagePatch заполните список MessagePatchToPost.RequestedSignatures.
Для отказа от предложения об аннулировании через API при обращении к методу PostMessagePatch заполните список MessagePatchToPost.XmlSignatureRejections. Каждый элемент этого списка представляет собой структуру XmlSignatureRejectionAttachment.
При получение информации о документах через API с помощью методов GetMessage, GetDocument и т.п. для любых документов в структуре Document заполняется поле RevocationStatus.
Добавлены методы GenerateRevocationRequestXml и GenerateSignatureRejectionXml, облегчающие процесс формирования корректных XML файлов предложения об аннулировании и формализованного отказа в подписи.
Добавлены методы ParseRevocationRequestXml и ParseSignatureRejectionXml, позволяющие преобразовывать xml-файлы предложения об аннулировании и формализованного отказа в подписи в структуры RevocationRequestInfo и SignatureRejectionInfo соответственно.
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¶
Добавлена возможность работы с документами, пересылаемыми внутри организации:
добавлены элементы в перечислениях NonformalizedDocumentStatus, BilateralDocumentStatus и UnilateralDocumentStatus;
добавлены поля для работы с подразделениями организации в структурах Department, Entity, Document, Message и MessageToPost.
Расширены возможности работы с «черновиками», то есть с подготовленными, но не отправленными документами:
для отправки ранее созданного черновика добавился метод 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, который помечает документы как удаленные.
В структуре 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-схемы, описывающие форматы документов, фигурирующих в документообороте счетов-фактур:
XML-схема счета-фактуры (СФ)
, эта же схема описывает формат исправления СФ (ИСФ);
XML-схема корректировочного счета-фактуры (КСФ)
, эта же схема описывает формат исправления КСФ (ИКСФ);
XML-схема подтверждения оператора о дате отправки СФ/ИСФ/КСФ/ИКСФ
(выдается продавцу);
XML-схема подтверждения оператора о дате доставки СФ/ИСФ/КСФ/ИКСФ
(выдается покупателю);
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¶
Первый релиз интеграторского интерфейса.