|
3.2.3.1. Метод SendContacts
|
|
|
Метод SendContacts позволяет отправить приглашения зарегистрированным в системе Такском-Доклайнз контрагентам через систему Такском-Доклайнз.
Если контрагент не зарегистрирован в системе Такском-Доклайнз, приглашение отправляется на указанный адрес электронной почты.
HTTP-запрос
HTTP-method: POST
|
Адрес запроса (URI)
| |
|
https://<server>.taxcom.ru/v<version>/API/SendContacts
| |
|
Заголовок запроса
| |
|
Integrator-Id
|
Идентификатор интеграционного решения. Формат этого идентификатора:
COMPANY_AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA
|
|
Assistant-Key
|
Маркер временного доступа
|
|
Тело запроса
| |
|
Список новых приглашений в формате XML
| |
Успешный HTTP-ответ сервера:
HTTP/1.1 200 OK
XML формат списка новых приглашений, используемый методом SendContacts, описан в п. 2.1.1.3. XML для работы с приглашениями и таблицами данных контрагентов.
Примеры XML файла списка приглашений:
Пример 1
<?xml version="1.0" encoding="utf-8"?>
<Contacts xmlns="http://api-invoice.taxcom.ru/contacts">
<Contact>
<Name>"MegaCompany"</Name>
<Inn>5233333323</Inn>
<Kpp>523301001</Kpp>
<Email>user1@server.com</Email>
<Comment>This is Ivanov I. I.</Comment>
<Agreements>
<Agreement Number="AL-1567" Date="2011-09-11T00:00:00"/>
<Agreement Number="AL-1359" Date="2011-07-15T00:00:00"/>
</Agreements>
</Contact>
<Contact>
<Name>"SuperCompany"</Name>
<Inn>1231231230</Inn>
<Kpp>523301001</Kpp>
<Email>user2@server.com</Email>
<InvitationText>This is text to invitation.</InvitationText>
</Contact>
</Contacts>
Пример 2. Заявка на роуминг
<?xml version="1.0" encoding="UTF-8"?>
<Contacts xmlns="http://api-invoice.taxcom.ru/contacts">
<Contact>
<Inn>5011019404</Inn>
<Kpp>501101001</Kpp>
<Name>ООО Сотрудничество-9990</Name>
<Comment>Давайте обмениваться электронными документами</Comment>
<Agreements>
<Agreement Date="2018-10-10T00:00:00" Number="45438"/>
<Agreement Date="2018-10-10T00:00:00" Number="5534"/>
</Agreements>
<OperatorId>2BM</OperatorId>
<ScanFilename>договор.pdf</ScanFilename>
<Scan>
</Contact>
</Contacts>
Пример кода C#
public void SendInvitationsToContacts (string invitationsList)
{
const string API_srv = @"https://api.taxcom.ru/v1.3/";
byte[] requestBytes = null;
try
{
requestBytes = File.ReadAllBytes(invitationsList);
}
catch (Exception ex)
{
Assert.Fail ("File not found");
}
try
{
var request = (HttpWebRequest) WebRequest.Create(API_srv + "API/SendContacts");
request.Headers.Add("Assistant-Key", "session token");
request.Headers.Add("Integrator-Id", "vendor_id");
request.Method = "POST";
request.ContentType = "application/pkcs7-mime";
request.ContentLength = requestBytes.Length;
using (var requestStream = request.GetRequestStream())
{
requestStream.Write(requestBytes, 0, requestBytes.Length);
requestStream.Flush();
}
using (request.GetResponse())
{
}
}
catch (WebException exception)
{
Assert.Fail(exception.ToString());
}
catch (Exception exception)
{
Assert.Fail(exception.ToString());
}
}