Раздел 3.3.3.2. Метод GetContactListUpdates

3.3.3.2. Метод GetContactListUpdates

Метод GetContactListUpdates возвращает список записей об изменениях списка приглашений (контактов), включая информацию о подразделениях и сотрудниках организации с включенной опцией "Показывать контрагентам при заполнении данных получателя".

Ответ метода содержит до 100 записей об изменениях, начиная с указанного момента времени.

Для получения всех изменений в качестве параметра DATE следует указать момент самого позднего из полученных изменений, а затем повторять вызов метода с указанием в качестве параметра DATE момента самого позднего из полученных изменений до получения пустого списка изменений.

	Внимание! Для поддержания стабильности обработки запросов на сервере Такском-Доклайнз метод GetContactListUpdates следует вызывать не чаще, одного раза в минуту.

string GetContactListUpdates(DateTime date, ContactStatus status);

date

дата и время последнего запроса для отбора и получения только новых данных

status

для параметра можно указать следующие значения:

•	empty: для получения данных обо всех приглашениях, всходящих и исходящих с любым статусом;

•	ContactStatus.Incoming:для получения данных только о входящих приглашениях;

•	ContactStatus.Sent: для получения данных только об исходящих приглашениях, на которые не был дан ответ;

•	ContactStatus.Accepted: для получения данных только о принятых приглашениях;

•	ContactStatus.Rejected : для получения данных только об отклонённых приглашениях;

•	ContactStatus.Error: для получения данных только о приглашениях с ошибками.

Метод GetContactListUpdates возвращает XML файл, который содержит следующие записи, начиная с момента времени, заданного параметром date:

Значение параметра Status	Содержание XML файла ответа метода
empty	Список всех входящих и исходящих приглашений независимо от статуса
Incoming	Список входящих приглашений
Sent	Список исходящих приглашений, на которые не дан ответ
Accepted	Список принятых входящих и исходящих приглашений
Rejected	Список отклонённых входящих и исходящих приглашений
Error	Список приглашений с ошибками

Для получения детальной информации о структуре файла ответа метода см. в п. 2.1.1.3. XML файлы списка контрагентов об XML списка приглашенных и пригласивших к обмену контрагентов.

Пример XML файла со списком приглашений:

<?xml version="1.0" encoding="utf-8"?>

<State Code="Sent" Changed="2011-07-15T13:25:00">Awaiting response for sent invitation</State>

<ExternalContactId>Client-993</ExternalContactId>

<Name>"Neptune" company</Name>

<Email>user@server.com</Email>

</Agreements>

</Contact>

</Contacts>