6.3.5. Отправка приглашений по списку с помощью программы Такском-Ассистент
Если Ваша учетная система интегрирована с приложением Такском-Ассистент, то Вы можете отправлять приглашения контрагентам из учетной системы.
Для этого Ваша учетная система должна поддерживать выгрузку XML-файла заданной структуры. Файлы должны выгружаться в папку документов для отправки "{идентификатор участника ЭДО}\Import" (см. п. 4.6. Настройка программы Такском-Ассистент). Такском-Ассистент после запуска обработает полученные файлы и отправит приглашения контрагентам.
Необходимый xml-файл списка приглашений должен состоять из следующих частей:
-
заголовка;
-
произвольного количества тегов, задающих информацию о приглашаемых контрагентах;
-
тега идентификатора шаблона при необходимости (опционально);
-
тега окончания </Contacts>.
Заголовок всегда должен быть таким:
|
<?xml version="1.0" encoding="utf-8"?>
<Contacts xmlns="http://api-invoice.taxcom.ru/contacts">
|
Пригласить контрагента можно разными способами:
1. Отправив приглашение на адрес его электронной почты.
2. С указанием логина или идентификатора участника документооборота EDXClientId, если контрагент является абонентом системы Такском-Доклайнз.
3. Используя сразу оба способа, приведенные выше.
Например, при использовании первого способа тег, задающий информацию о приглашаемом контрагенте может иметь следующий вид:
<Contact>
<ExternalContactId>Client-6612</ExternalContactId>
<Name>бухгалтер ООО Рассвет Ильин И.И.</Name>
<Inn>9999111222</Inn>
<Kpp>999911122</Kpp>
<Email>IljinII@yandex.com</Email>
<Comment>Прошу разрешить обмен электронными документами</Comment>
</Contact>
В приведенном примере указаны данные контрагента с наименованием бухгалтер ООО Рассвет Ильин И.И., ИНН 9999111222, КПП 999911122, адресом электронной почты IljinII@yandex.com.
ИНН и адрес электронной почты - обязательные параметры, КПП - необязательный.
Табличное описание
Тег (узел) Contacts содержит следующие данные:
|
Атрибут
|
Тип
|
Описание
|
Обязательное присутствие
|
|
Asof
|
Дата и время - стандарт XML (YYYY-MM-DDТHH:mm:ss.ttt)
|
Отметка времени
|
Да
|
|
Contact
|
Комплексный тип.
См. следующую табл.
|
Содержит узел Contact для каждой записи обновления списка контактов.
См. следующую табл.
|
Нет
|
|
TemplateID
|
Идентификатор типа GUID
|
Идентификатор шаблона письма приглашения
Тег TemplateID опционален. Если его нет, то используется шаблон по умолчанию.
Указанный шаблон должен быть создан и записан в системе заранее.
Набор поддерживаемых маркеров шаблона, которые при формировании сообщения заменяются на реальные значения:
· [ContactName] - Поле Name из заявки
· [SenderName] - Наименование отправителя
· [SenderMessage] - Сообщение пользователя. Поле Comment заявки
· [SenderInn] - ИНН отправителя
· [ContactInn] - ИНН получателя
· [IsTestAbonent] - признак тестового абонента
|
Нет
|
Тег (узел) Contact содержит следующие данные:
|
Атрибут
|
Тип
|
Описание
|
Обязательное присутствие
|
|
Name
|
Текст, до 255 символов
|
Полное или краткое наименование организации или индивидуального предпринимателя.
|
Нет
|
|
Inn
|
Число, до 12 символов
|
ИНН юридического лица (10 цифр) или индивидуального предпринимателя (12 цифр). Система проверят правильность ИНН.
|
Да
|
|
Kpp
|
Число, до 9 символов
|
КПП юридического лица получателя (если получатель - индивидуальный предприниматель, то значение не задаётся);
|
Нет
|
|
Email
|
Текст, до 32 символов
|
Адрес электронной почты контрагента в формате [имя_пользователя]@[сервер].[домен] (например, demo@mail.ru)
|
Да - при отсутствии в данном теге Contact значения атрибута EDXClientId.
Нет - если в данном теге Contact указано значение атрибута EDXClientId.
|
|
Login
|
Текст, до 255 символов
|
Псевдоним пользователя в системе Такском-Доклайнз.
|
Нет
|
|
EDXClientId
|
Текст, до 46 символов
|
Идентификатор участника документооборота.
|
Нет
|
|
ExternalContactId
|
Текст, до 255 символов
|
Идентификатор контрагента во внешней учетной системе.
|
Нет
|
|
Comment
|
Текст, до 255 символов
|
Текст приглашения или комментарий
|
Нет
|
|
Agreements
|
Комплексный тип.
См. табл. ниже.
|
Список договоров (контрактов) с контрагентом.
См. табл. ниже.
|
Нет
|
Тег (узел) Agreements может содержать несколько узлов Agreement, которые содержат следующие данные:
|
Атрибут
|
Тип
|
Описание
|
Обязательное присутствие
|
|
Number
|
Текст, до 255 символов
|
Номер договора/контракта
|
Нет
|
|
Date
|
Дата и время - стандарт XML (YYYY-MM-DDТHH:mm:ss.ttt)
|
Дата заключения договора/контракта
|
Нет
|
Пример 1 содержания xml-файла заявки на отправку приглашения:
<?xml version="1.0" encoding="utf-8" ?>
<Contacts xmlns="http://api-invoice.taxcom.ru/contacts">
<Contact>
<ExternalContactId>Client-6612</ExternalContactId>
<Name>бухгалтер ООО Рассвет Ильин И.И.</Name>
<Inn>9999111222</Inn>
<Kpp>999911122</Kpp>
<Email>IljinII@yandex.com</Email>
<Comment>Прошу разрешить обмен электронными документами</Comment>
</Contact>
<TemplateID>1B3F3F57-96BD-40AB-83FE-8C63540EE8BD</TemplateID>
</Contacts>
При формировании письма будет использован шаблон 1B3F3F57-96BD-40AB-83FE-8C63540EE8BD.
В случае, если шаблон не найден, формируется ответ 400 Bad Request с кодом 4201 "Не удалось найти шаблон письма, идентификатор которого указан в заявке. Идентификатор шаблона...".
|
Пример 2 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>
<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>
Изменение статусов приглашений отражается в XML-файле ContactListStatuses.xml, выгружаемом в папку входящих документов ("{идентификатор участника ЭДО}\Inbox") программы Такском-Ассистент, откуда статусы могут считываться в Вашу учетную систему.
Перечень статусов, возвращаемых системой Такском-Файлер для приглашений контрагентов следующий:
-
Incoming - получено приглашение от контрагента.
-
Sent - запрос на подключение отправлен контрагенту, ожидается ответ.
-
Rejected - контрагент отклонил приглашение.
-
Accepted - приглашение принято контрагентом.
-
Error:
-
Неверный ИНН . ErrorCode=InvalidInn. Устанавливается при ошибке проверки ИНН.
-
Неверный формат email . ErrorCode=InvalidEmail. Устанавливается при ошибке проверки поля email.
-
Невозможно отправить приглашение, так как контрагент не найден в базе абонентов компании «Такском», и адрес электронной почты указан неверно. ErrorCode = NotFound. Устанавливается при невозможности обработать запрос.
-
Попытка принять или отклонить приглашение, которое не удалось найти. ErrorCode = NotFound.