diadoc / diadocsdk-cpp Goto Github PK

Official Diadoc SDK for C++

Home Page: http://api-docs.diadoc.ru/ru/latest/

License: MIT License

CMake 1.43% C# 3.43% PowerShell 3.65% Shell 0.91% Batchfile 0.27% C++ 89.08% C 1.22%

diadocsdk-cpp cmake

diadocsdk-cpp's Introduction

	Build Status
master
latest

diadocsdk-cpp

Поддержка и обновление C++ SDK прекращены с 01.01.2024.

diadocsdk-cpp является официальной C++-реализацией клиента, использующего публичный API Диадока. На данный момент поддерживается только ОС семейства Windows, компиляция с помощью компиляторов Visual Studio С++.

Сборка проектов

Для сборки проекта используется утилита cmake. Инсталлятор можно скачать на официальном сайте. В качестве альтернативы, можно установить утилиту cmake с помощью Chocolatey. В итоге утилита cmake должна находиться в переменной среды PATH, чтобы ее можно было вызвать из командной строки.

Стандартный способ сборки проекта утилитой cmake (старт из корня репозитория):

mkdir tmp
cd tmp
cmake ..
cmake --build .

Видно, что утилита cmake работает в две фазы:

cmake .. генерирует файлы solution и проектов для Visual Studio.
cmake --build . - запуск сборки проекта из командной строки. Технически, для сборки проекта cmake вызывает msbuild для сгенерированных проектов. Также возможно открыть сгененрированные проекты непосредственно в Visual Studio и компилировать проект из IDE.

Окончательная сборка проекта (CI)

Для окончательной сборки проекта используется утилита Cake.

Запуск powershell-скрипта build.ps1 скачает утилиту Cake, если ее у вас нет, и запустит сборку проекта. Из командной строки этот скрипт можно запустить с помощью generate.bat.

Выполняется:

генерация проектов Visual Studio с помощью утилиты cmake
сборка компилятора protoc
компиляция proto-файлов
компиляция DiadocApi

Сборка для различных платформ

cmake умеет генерировать solution и проекты для разных версий Visual Studio, для разных архитектур (x86, x64, ARM). Генератор и тулсет можно регулировать с помощью параметров командной строки build.ps1.

Пример генерации проектов Diadoc C++ SDK для Visual Studio 2013, для 64-битной платформы, с использованием компилятора, генерирующего исполняемые файлы с возможностью запуска в Windows XP:

PS> .\build.ps1 -Generator "Visual Studio 12 2013" -Toolset v120_xp

64-битные сборки официально не поддерживаются

Хоть утилита cmake и позволяет сгенерировать solution и проекты для 64-битных платформ (Н: с помощью генератора Visual Studio 12 2013 Win64), DiadocSDK C++ официально не поддерживает сборку под 64 бита!

Вы можете скомпилировать DiadocSDK C++ под 64 бита на свой страх и риск! Код компилируется, но выдает много предупреждений про конвертацию типов size_t в int, т.е. он не является корректным. Это ограничение связано с тем, что используемая библиотека Google Protobuf v2 не поддерживает сборку под 64 бита. Также компилятор protoc генерирует код, некорректный для использования в 64-битных системах.

Добавление функциональности

Сделайте Fork
Создайте ветку для новой фичи (git checkout -b my-new-feature)
Сделайте Commit изменений (git commit -am 'Add some feature')
Сделайте Push новой ветки (git push origin my-new-feature)
Создайте новый Pull Request

diadocsdk-cpp's People

Contributors

Stargazers

Watchers

diadocsdk-cpp's Issues

Нет функции GetMyCertificates

в c# есть. Просьба добавить. GetMyUser -> User не содержит моего сертификата.

GetDocflow + GetDocflowBatchResponseV3 + DocumentWithDocflowV3

У клиента возникли проблемы с отправкой ответов в СБИС
"Причина ошибки следующая: титул покупателя не был доставлен, так как в xml титула от контрагента указаны неверные сведения об электронной подписи под первичным документом в параметре "ЭП". В данном случае необходимо сообщить контрагенту об ошибке и рекомендовать им обратиться в техническую поддержку своего оператора для разъяснения причины."
Сейчас ЭП входящего документа достается из ленты событий Entity.
Контур им по данному вопросу сообщил следующее."Причина ошибки в том, что ваша интеграция при генерации титула покупателя использует подпись продавца CADES-T, вместо CMS. Для того, чтобы уметь отличать подпись кадестированную от некадестированной рекомендуем использовать более новые версии методов и структур. В ней возвращаются исходная подпись и подпись со штампом времени.Инструкция API: https://api-docs.diadoc.ru/ru/latest/proto/DocumentWithDocflowV3.html .
Вроде все понятно, дотянутся до оригинала подписи возможно, но в последней версии GetDocflows возвращет только GetDocflowBatchResponse, а неhttps://developer.kontur.ru/docs/diadoc-api/proto/GetDocflowBatchResponseV3.html. Нужные классы я допустим смог объявить добавив к себе в проект
#include "DocflowApiV3.pb.h"
#include "DocflowV3.pb.h"
чего ранее не требовалось - хватало DiadocApi.h.
но при этом не могу вызвать функции из АПИ с их использованием, поскольку функции в документации не имеют версии для их вызова с новыми классами.
Просьба актуализировать под документацию GetDocflow. (исправить нынешнюю, или добавить GetDocflowV3).

ФИО подписанта в документе не совпадает с ФИО владельца электронной подписи

добрый день!
потребовалось добавить проверку на соответствие ФИО подписанта с ФИО владельца ЭП.

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

и если самому, то откуда взять данные о ФИО владельца ЭП.

заранее спасибо!

GenerateSenderTitleXml

Здравствуйте!

Добавляю поддержку УПД-820, не получается понять откуда получить userContractData для передачи в GenerateSenderTitleXml.

В SDK для C# есть разбор этой темы здесь:
diadoc/diadocsdk-csharp#490

Однако, я не могу найти никаких хотя бы похожих классов Utd820.UniversalTransferDocument и объявлений SerializeToXml() для сериализации.

Или в C# версии SDK это уже реализовано, а в C++ пока нет?
Заранее спасибо за ответ.

Не собирается проект

Сборка проектов утилитой cmake прошла успешно. Далее запускаю из корня репозитория generate.bat. В результате сборка завершается ошибкой:
Preparing to run build script...
Running build script...
Analyzing build script...
Processing build script...
Installing addins...
Compiling build script...
Error: Object reference not set to an instance of an object.
Что я делаю не так?
Конфиг системы: Win7 SP1 x86, Visual Studio 2015

Как заполнить DocumentSignature -> Signature

При аннулировании документа нужно заполнять эту структуру.
В документации в
https://developer.kontur.ru/docs/diadoc-api/proto/DocumentSignature.html
указано что
Signature — ЭП (в некоторых случаях может отсутствовать). Если ЭП присутствует, то она должна быть представлена в формате CMS SignedData в DER-кодировке.
Вопрос : Как в c++ заполнить в этом формате на объектах из АПИ? Желательно используя функции Certificate.
Комментариев в АПИ мало, не смог найти. Вроде есть разбор в src\protos\SignatureVerificationResult.pb.cc, но создания не увидел. Просьба дать консультацию или разработать соответствующую функцию в класс Certificate..

Клиент просит поле "Дата изменения статуса" из справочника контрагентов.

В справочнике мои контрагенты

Не нашел такого поля в структуре Counteragent
Есть поле LastEventTimestampTicks - метка времени последнего события из истории взаимодействия с данным контрагентом
Это оно? По комментарию не совсем подходит.
Если нет, просьба добавить в обмен.
Собственно клиенту нужно "дата, в которую контрагенты добавили друг друга в список контрагентов в Диадоке" и привели этот скрин.

GetReceiptGenerationProcess()

Добрый день! Есть ли аналог этого метода GetReceiptGenerationProcess(). Используем COM-компонента для встраивания в произвольные системы, для 64-х битных приложений - 5.14.1.177. При запуске процесса автоматического формирования документов по регламентному документообороту счетов-фактур происходит зависание системы. Хотелось бы иметь аналог данного метода

Не все сервисы есть в DiadocApi. Например GenerateDocumentZip и ShelfDownload

Не все сервисы есть в DiadocApi. Например GenerateDocumentZip и ShelfDownload
https://api-docs.diadoc.ru/ru/latest/http/GenerateDocumentZip.html
https://api-docs.diadoc.ru/ru/latest/http/ShelfDownload.html
Для самостоятельной их обработки достаточно выпустить в public PerformHttpRequest
Например так
DiadocApi.h
public
DiadocApi::Bytes_t PerformHttpRequestGet(const std::wstring& queryString);

DiadocApi.cpp

DiadocApi::Bytes_t DiadocApi::PerformHttpRequestGet(const std::wstring& queryString)
{
WppTraceDebugOut(L"PerformHttpRequestGet...");
return PerformHttpRequest(queryString, GET);

}
Все остальное уже смогут сделать сами.
Номер обращения в диадоке - 24884324.
С такой доработкой проблема уже решена, но хочется, чтобы она вошла в стандартный пакет.

Если вы не против я могу попробовать сделать Pull Request - но не вижу, чтобы кто то их делал.

Нет функции GetResolutionRoutesForOrganization

https://developer.kontur.ru/Docs/diadoc-api/http/GetResolutionRoutesForOrganization.html
объект ResolutionRouteList есть в ResolutionRouteList.pb.h

Перестал работать метод GenerateDocumentZip с ошибкой 400 Could not get boxId from query param

Добрый день.
Прошу прощения, Промахнулся проектом в
diadoc/diadocsdk-csharp#852
но cSharp тоже есть в тестовом варианте - пока руки не дошли посмотреть им.

Используется апи diadocsdk-cpp-versions-1.92.3.zip
Но проблема возникла еще на diadocsdk-cpp-versions-1.92.0.zip 28.06.2021.
У нас повторилась. На момент проверки ничего не менялось с марта 2021( тогда был переход на апи 1.92.0).
Возможно связано с переходом на V3
Вот здесь осталось
TaskResult DiadocApi::GenerateDocumentZip(const std::wstring& boxId, const std::wstring& messageId, const std::wstring& documentId, bool fullDocflow)
{
std::wstringstream buf;
buf << "?boxId=" << StringHelper::CanonicalizeUrl(boxId) << L"&messageId=" << StringHelper::CanonicalizeUrl(messageId) << L"&documentId=" << StringHelper::CanonicalizeUrl(documentId);

Ну и наверное проблема будет в ShelfDownload
В других местах buf << L"/V3/GetDocuments?boxId="

Как отправить через АПИ электронно транспортную накладную.

Интересуют технические детали отправки через даидок АПИ(с++) электронной транспортной накладной.
Сам пакет документов мы сможем сделать самостоятельно( так понимаю там их 2 может быть) и обработку входящих тоже сделаем.
Каким типом документа нужно воспользоваться для отправки?
Среди существующих я не нашел подходящего.
Видимо
https://developer.kontur.ru/Docs/diadoc-api/proto/DocumentAttachment.html
Но что нужно задать в TypeNamedId?
DocumentTypeDescriptionV2 не выдала подходящий тип. В АПИ не описано ничего для этого документа.
Устроит консультация и на c#.
Было обращение в поддержку контура 46307093.

Когда будет добавлена функциональность для работы с машиночитаемой доверенностью в c++?

https://developer.kontur.ru/docs/diadoc-api/ReleaseNotes.html указано, что функционал добавлен для Java и c#
А когда это будет добавлено для с++ и будет ли вообще?

ГОСТ 34.11-2012

https://github.com/diadoc/diadocsdk-cpp/blob/master/src/Certificate.cpp
Метод
Certificate::Bytes_t Certificate::Sign(const Bytes_t& input) const
работает только с алгоритмом шифрования по ГОСТ 34.11-94.
Сейчас пользователям стали выдавать сертификаты по ГОСТ 34.11-2012

Можно доработать данный метод?

Когда будет решен вопрос по GetDocflow + GetDocflowBatchResponseV3 + DocumentWithDocflowV3?

Добрый день. Ранее был зарегистрирован вопрос GetDocflow + GetDocflowBatchResponseV3 + DocumentWithDocflowV3 #128. Но ответа так и не последовало. Вопрос критический.
Контрагент в СБИС не получает подписи из Контура. СБИС сообщил: "Причина ошибки следующая: титул покупателя не был доставлен, так как в xml титула от контрагента указаны неверные сведения об электронной подписи под первичным документом в параметре "ЭП". В данном случае необходимо сообщить контрагенту об ошибке и рекомендовать им обратиться в техническую поддержку своего оператора для разъяснения причины."

Контур им по данному вопросу сообщил следующее."Причина ошибки в том, что ваша интеграция при генерации титула покупателя использует подпись продавца CADES-T, вместо CMS. Для того, чтобы уметь отличать подпись кадестированную от некадестированной рекомендуем использовать более новые версии методов и структур. В ней возвращаются исходная подпись и подпись со штампом времени.Инструкция API: https://api-docs.diadoc.ru/ru/latest/proto/DocumentWithDocflowV3.html ."

Вопрос критический, потому что контрагенту в СБИС не приходит наша подпись. Не можем пользоваться интеграционным решением с использованием устаревших функций.
Просим обратить внимание на вопрос. Пожалуйста, уточните сроки решения вопроса.