|
2.3.3.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>MassTelecom@telecom.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 символов
|
КПП юридического лица получателя (если получатель индивидуальный предприниматель, то значение не задаётся);
|
нет
|
|
Email
|
Текст, максимальная длина 32 символов
|
Адрес электронной почты контрагента в формате [имя_пользователя]@[сервер].[домен] (например, demo@mail.ru)
|
да
|
|
ExternalContactId
|
Текст, максимальная длина 255 символов
|
Уникальный номер контрагента из внешней учётной системы.
|
нет
|
|
Comment
|
Текст, максимальная длина 2000 символов
|
Текст приглашения
|
нет
|
Затем в блоке «Управление контрагентами» необходимо нажать кнопку «Обзор…», указать подготовленный xml-файл и нажать кнопку «Отправить».
В результате система обработает все записи указанного xml-файла (можно отправить приглашения сразу нескольким контрагентам). Сначала система проверит правильность данных. Если будут обнаружены ошибки, например, неверно указан ИНН контрагента, то этот контрагент не получит приглашение.
Если данные указаны корректно, то система:
1) Произведёт поиск каждого приглашаемого контрагента по ИНН/КПП в Вашем личном списке «Мои Контрагенты».
2) Произведёт поиск каждого контрагента ИНН/КПП в базе абонентов системы, если абонент не был найден в списке контрагентов пользователя.
3) Если приглашаемый контрагент найден в списке абонентов системы Такском-Файлер, то отправит приглашение на внутренний адрес в системе Такском-Файлер.
4) Если в xml-файле был указан адрес электронной почты приглашаемого контрагента, - сформирует и отправит приглашение на этот адрес.