Раздел 3.3.1.1. Создание экземпляра класса TaxcomApi

3.3.1.1. Создание экземпляра класса TaxcomApi

Такском-Доклайнз .NET SDK позволяет создавать интеграционное решение, которое способно отправлять и получать электронные документы от одного или многих участников ЭДО – клиентов Такском. Другими словами, документооборот для нескольких учётных записей Такском-Доклайнз может производиться одновременно.

Для каждой учётной записи участника ЭДО Такском-Доклайнз, чьи документы обрабатываются в интеграционном решении, необходимо создавать отдельный экземпляр класса TaxcomApi.

Создание экземпляра класса может быть осуществляться с помощью метода CreateApi класса Taxcom.Client.Api.Factory и зависит от способа подключения личного ключа ЭП абонента.

Создание экземпляра TaxcomAPI для работы с ключом ЭП, подключенным непосредственно к компьютеру абонента

TaxcomApi CreateApi(string serviceUrl, bool useDefaultProxy, string clientIdentifier, byte[] authCertificateBody, string edxClientId);
serviceUrl	URL сервера ЭДО Такском-Доклайнз: https://<server>.taxcom.ru/v<version>/
useDefaultProxy	Булева переменная для переключения режима использования настроек прокси сервера по умолчанию
clientIdentifier	Идентификатор программного обеспечения ID
authCertificateBody	Тело сертификата, зарегистрированного для этого участника ЭДО
edxClientId	ID участника ЭДО

Пример кода C# для создания фабрики

var Api = _factory.CreateApi(

“https://api-invoice.taxcom.ru/v1.3/",

useDefaultProxy,

clientIdentifier,

File.ReadAllBytes(“path to the certificate file”),

edxClientId);

Далее рассмотрены случаи, когда абонент будет использовать ключ ЭП, хранящийся в системе облачной криптографии (СОК) Такском.

Создание экземпляра TaxcomAPI для работы с облачным сертификатом, не защищенным пин-кодом

Для работы с облачным сертификатом, не защищенным пин-кодом, используется следующая перегрузка метода CreateApi:

TaxcomApi CreateApi(string serviceUrl, bool useDefaultProxy, string clientIdentifier,

string authCertificateThumbrpint, string cryptoCloudServiceLogin,

string cryptoCloudServicePassword, byte[] trustedCertificateBody, string edxClientId)

serviceUrl	URL сервера ЭДО Такском-Доклайнз:https://<server>.taxcom.ru/v<version>/
useDefaultProxy	Булева переменная для переключения режима использования настроек прокси сервера по умолчанию
clientIdentifier	Идентификатор программного обеспечения ID
authCertificateThumbprint	Отпечаток облачного сертификата, зарегистрированного для этого участника ЭДО
cryptoCloudServiceLogin	Логин от учетной записи сервиса облачной криптографии
cryptoCloudServicePassword	Пароль от учетной записи сервиса облачной криптографии
trustedCertificateBody	Тело доверенного сертификата
edxClientId	ID участника ЭДО

Пример кода (С#)

var api = _factory.CreateApi(

“https://api-invoice.taxcom.ru/v1.3/",

false,

clientIdentifier,

“768a3244bc401456eef29af2fa5b2652f71dff3c”,

“testLogin”,

“testPassword”,

File.ReadAllBytes(“TrustedCertificate.cer”),

edxClientId

);

Создание экземпляра TaxcomAPI для работы с облачным сертификатом, защищенным пин-кодом

Для работы с облачным сертификатом, защищенным пин-кодом, используется следующая перегрузка метода CreateApi:

TaxcomApi CreateApi(string serviceUrl, bool useDefaultProxy, string clientIdentifier,

string authCertificateThumbrpint, string cryptoCloudServiceLogin,

string cryptoCloudServicePassword, byte[] trustedCertificateBody, string edxClientId)

serviceUrl	URL сервера ЭДО Такском-Доклайнз:https://<server>.taxcom.ru/v<version>/
useDefaultProxy	Булева переменная для переключения режима использования настроек прокси сервера по умолчанию
clientIdentifier	Идентификатор программного обеспечения ID
authCertificateThumbprint	Отпечаток облачного сертификата, зарегистрированного для этого участника ЭДО
certificatePin	Пин-код для переданного облачного сертификата
cryptoCloudServiceLogin	Логин от учетной записи сервиса облачной криптографии
cryptoCloudServicePassword	Пароль от учетной записи сервиса облачной криптографии
trustedCertificateBody	Тело доверенного сертификата
edxClientId	ID участника ЭДО

Пример кода (С#)

var api = _factory.CreateApi(

“https://api-invoice.taxcom.ru/v1.3/",

false,

clientIdentifier,

“768a3244bc401456eef29af2fa5b2652f71dff3c”,

“testLogin”,

“testPassword”,

“1234”,

File.ReadAllBytes(“TrustedCertificate.cer”),

edxClientId

);