|
2.3.2.8.1. Приглашение новых контрагентов
|
|
|
Для обеспечения возможности обмена документами между тестовыми абонентами необходимо отправить от первого контрагента второму приглашение к обмену документами, а в ответ - отправить согласие на обмен документами.
ПРИМЕЧАНИЕ: Можно выполнять эти операции в приложении Такском-Файлер на сервере https://integration.taxcom.ru/, оно работает с той же базой данных.
Для приглашения контрагента к обмену документами в системе Такском API необходимо подготовить xml-файл приглашения следующего вида:
<?xml version="1.0" encoding="utf-8"?>
<Contacts xmlns="http://api-invoice.taxcom.ru/contacts">
<Contact>
<ExternalContactId>MassTelekom</ExternalContactId>
<Name>ООО МассТелеком</Name>
<Inn>4353454341</Inn>
<Kpp>435301001</Kpp>
<Email>SenderPetrov@mail.ru</Email>
<Email>Ivanov@mail.ru</Email>
<Comment>Приглашаю обмениваться электронными документами</Comment>
<Agreements>
<Agreement Date="2012-05-02T00:00:00" Number="45438"/>
<Agreement Date="2012-05-01T00:00:00" Number="5534"/>
</Agreements>
</Contact>
</Contacts>
Тег (узел) Contact содержит следующие данные по контрагенту:
|
Атрибут
|
Тип
|
Описание
|
Требует заполнения
|
|
Name
|
Текст, максимальная длина 255 символов
|
Полное или краткое наименование юридического лица или индивидуального предпринимателя (ФИО)
|
да
|
|
Inn
|
Число, максимальная длина 12 символов
|
ИНН юридического лица (10 цифр) или индивидуального предпринимателя (12 символов). Система проверят правильность ИНН.
|
да
|
|
Kpp
|
Число, максимальная длина 9 символов
|
КПП юридического лица получателя (если получатель индивидуальный предприниматель, то значение не задается);
|
нет
|
|
SenderEmail
|
Текст, максимальная длина 32 символа
|
Адрес электронной почты отправителя в формате [имя_пользователя]@[сервер].[домен] (например, demo@mail.ru)
|
|
|
Email
|
Текст, максимальная длина 32 символа
|
Адрес электронной почты контрагента в формате [имя_пользователя]@[сервер].[домен] (например, demo@mail.ru)
|
да
|
|
ExternalContactId
|
Текст, максимальная длина 255 символов
|
Уникальный номер контрагента из внешней учетной системы.
|
нет
|
|
Comment
|
Текст, максимальная длина 2000 символов
|
Текст приглашения
|
нет
|
Затем необходимо нажать кнопку «…» на закладке «Контакты» в блоке «Добавить контакты», выбрать подготовленный xml-файл, добавить и нажать кнопку «Отправить».
В результате система обработает все записи из вашего xml- файла (можно отправить приглашения сразу нескольким контрагентам). Сначала система проверит правильность указанных данных. Если будут обнаружены ошибки, например, неверно указан ИНН контрагента, то этот контрагент не будет добавлен в базу. Причину, по которой абонент не был добавлен, Вы сможете посмотреть в xml-ответе.
Если данные указаны корректно, то система:
1) Произведёт поиск каждого контрагента по ИНН/КПП в списке «Мои Контрагенты».
2) Произведёт поиск каждого контрагента по ИНН/КПП в базе системы, если абонент не был найден в списке контрагентов пользователя.
3) Сформирует приглашение внутри системы Такском-Файлер и отправит его, если абонент найден в базе системы.
4) Сформирует приглашение и отправит его на адрес внешней электронной почты, если абонент не был найден в базе системы.
С помощью кнопки «Получить изменения» можно получить, посмотреть и сохранить на компьютере xml-файл изменений в списке контактов.
Перечень статусов, возвращаемых системой при загрузке данных контрагента, и их описание:
Pending - приглашение отправлено контрагенту, ожидание ответа.
Rejected - контрагент отклонил приглашение.
SentToEmail - приглашение отправлено на адрес электронной почты.
Accepted – приглашение принято.
InvalidInn - неверный формат ИНН контрагента.
NotProcessed - невозможно отправить приглашение, так как контрагент не в базе абонентов компании «Такском» и адрес электронной почты указан неверно.
Removed – приглашение отклонено (контрагент удалён из списка «Мои Контрагенты»).