|
2.3.1.10.1. Приглашение контрагентов к обмену документами
|
|
|
Для обеспечения возможности обмена документами между тестовыми абонентами необходимо отправить от первого контрагента второму приглашение к обмену документами, а в ответ - отправить согласие на обмен документами.
Примечание:
Можно выполнять эти операции или контролировать их выполнение в приложении «Такском-Файлер» на сервере https://integration.taxcom.ru/, оно работает с той же базой данных.
Для приглашения контрагентов к обмену документами в системе Такском API необходимо подготовить xml-файл приглашения следующего вида:
<?xml version="1.0" encoding="utf-8"?>
<Contacts xmlns="http://api-invoice.taxcom.ru/contacts">
<Contact>
<ExternalContactId>Client-993</ExternalContactId>
<Name>ООО "Нептун"</Name>
<Inn>5233333323</Inn>
<Kpp>523301001</Kpp>
<SenderEmail>sender_user2@mail.com</SenderEmail>
<Email>user1@server.com</Email>
<Comment>Прошу дать согласие на получение электронных документов. Иванов А. В.</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>
<ExternalContactId>Client-994</ExternalContactId>
<Name>ООО "Ромашка"</Name>
<Inn>1231231230</Inn>
<Kpp>523301001</Kpp>
<Email>user2@server.com</Email>
<Comment>Прошу дать согласие на получение электронных документов. Иванов А. В.</Comment>
</Contact>
</Contacts>
Xmlns http://api-invoice.taxcom.ru/contacts, кодировка utf-8. Корневой узел Contacts содержит узел Contact для каждого запроса.
Узел Contact содержит следующие данные по контрагенту:
|
Атрибут
|
Тип
|
Описание
|
Требует заполнения
|
|
Name
|
Текст, максимальная длина 255 символов
|
Полное или краткое наименование юридического лица или индивидуального предпринимателя (ФИО)
|
да
|
|
Inn
|
Число, максимальная длина 12 символов
|
ИНН юридического лица (10 цифр) или индивидуального предпринимателя (12 символов). Система проверят правильность ИНН.
|
да
|
|
Kpp
|
Число, максимальная длина 9 символов
|
КПП юридического лица получателя (если получатель индивидуальный предприниматель, то значение не задается);
|
нет
|
|
SenderEmail
|
Текст, максимальная длина 32 символа
|
Адрес электронной почты контрагента в формате [имя_пользователя]@[сервер].[домен] (например, demo@mail.ru)
|
нет
|
|
Email
|
Текст, максимальная длина 32 символа
|
Адрес электронной почты контрагента в формате [имя_пользователя]@[сервер].[домен] (например, demo@mail.ru)
|
да
|
|
ExternalContactId
|
Текст, максимальная длина 255 символов
|
Уникальный номер контрагента из внешней учетной системы.
|
нет
|
|
Comment
|
Текст, максимальная длина 2000 символов
|
Текст приглашения
|
нет
|
Contact/Agreements - список договоров, в контексте которых пользователи планируют обмен документами. Данный список не обязателен для заполнения. При добавлении договора необходимо указать его номер и дату заключения.
Узел Contact/Agreements/Agreement содержит следующие данные по контакту:
|
Элемент
|
Тип
|
Описание
|
Требует заполнения
|
|
Number
|
Текст, до 255 символов
|
Номер договора/контракта
|
да
|
|
Date
|
Дата - стандарт XML (YYYY-MM-DDT00:00:00)
|
Дата заключения договора/контракта
|
да
|
Для отправки приглашений контрагентам методом SendContacts необходимо нажать кнопку «…» справа от поля «Файл изменений контрагентов», выбрать подготовленный xml-файл и нажать кнопку «SendContacts».
Автоматическое отображение реакции системы при нажатии этой кнопки не предусмотрено.
В результате система обработает все записи из вашего xml-файла (можно отправить приглашения сразу нескольким контрагентам). Сначала система проверит правильность указанных данных. Если будут обнаружены ошибки, например, неверно указан ИНН контрагента, то этот контрагент не будет добавлен в базу. Причину, по которой абонент не был добавлен, Вы сможете посмотреть в xml-ответе.
Если данные указаны корректно, то система:
1) Произведёт поиск каждого контрагента по ИНН/КПП в списке «Мои Контрагенты».
2) Произведёт поиск каждого контрагента ИНН/КПП в базе абонентов системы ТФ, если абонент не был найден в списке контрагентов пользователя.
3) Сформирует приглашение внутри системы «Такском-Файлер» и отправит его, если абонент найден в системе абонентов Такском.
4) Сформирует приглашение и отправит его на адрес внешней электронной почты.
Приглашение на адрес внешней электронной почты имеет следующий вид:
Для проверки отправки приглашения можно в строке «Обновления контакт листа» указать дату отправки слева от кнопки «GetContactList» и нажать кнопку «GetContactList». В результате в указанную Вами папку выгружается файл с реквизитами и статусами отправленных приглашений, например:
<?xml version="1.0" encoding="utf-8"?><Contacts Asof="2012-08-28T13:25:11.977" xmlns="http://api-invoice.taxcom.ru/contacts"><Contact><ExternalContactId>Savin</ExternalContactId>
<State Code="Sent" ErrorCode="" Changed="2012-08-28T13:25:11.977">Ожидается ответ на отправленное приглашение</State><Name>ЗАО "Шведские материалы для дома"</Name><Inn>9800112214</Inn><Kpp>980022331</Kpp><Login>SokoLovII</Login><EDXClientId>2AL-3C5FA18F-976A-4AF2-A9BD-26A28223E0D2-00000</EDXClientId><Email>ShvedMat@com.ru</Email><Agreements><Agreement Number="AL-1359" Date="2011-07-15T00:00:00" /><Agreement Number="AL-1567" Date="2011-09-11T00:00:00" /></Agreements></Contact></Contacts>