Запрос R19: Список Карточек Контрагентов в Виртуальном Офисе
Адрес: https://www.tws.by/tws/api/r19
Этот запрос возвращает список всех карточек контрагентов в Виртуальном Офисе, отвечающим условиям фильтра. Если ни одно из условий не задано, будет возвращён список из вообще всех Карточек Контрагентов.
Обратите внимание: В Системе TWS разные контрагенты могут иметь одинаковое полное наименование и/или УНП/ИНН/БИН. Краткое наименование - всегда уникально. Также наименования и УНП/ИНН/БИН могут пересекаться между странами. Поэтому для поиска по полному наименованию либо УНП/ИНН/БИН всегда стоит добавлять ещё и код страны и учитывать возможность возврата нескольких результатов.
Входные параметры
- SessionKey – сессионный ключ, полученный из запроса R1. Обязательный параметр.
- ID – точный поиск по внутреннему ID контрагента. В результате этого запроса вернётся либо один контрагент, если он найден, либо пустой список.
- ShortName – точный поиск по краткому наименованию контрагента. Т.к. краткое наименование в Системе TWS должно быть уникальным, в результате этого запроса вернётся либо один контрагент, если он найден, либо пустой список.
- FullName – точный поиск по полному наименованию контрагента. Обратите внимание: в Системе TWS допускается создание разных карточек контрагентов с одинаковым полным наименованием.
- Code – точный поиск по УНП/ИНН/БИН контрагента. Обратите внимание: в Системе TWS допускается создание разных карточек контрагентов с одинаковым УНП.
- Country – код страны в соответствии с Классификатором стран мира.
- PartialShortName – поиск по подстроке в кратком наименовании контрагента.
- PartialFullName – поиск по подстроке в полном наименовании контрагента.
Параметры JSON-ответа
- Count – количество Карточек Контрагентов в списке.
- List – список Карточек Контрагентов. Каждый элемент списка имеет следующие поля:
- ID – внутренний ID Карточки Контрагента в Системе TWS. Может использоваться в запросе R6 (создание декларации).
- ShortName – краткое наименование Карточки Контрагента “для себя”. Не выгружается в таможню.
- FullName – полное наименование контрагента для выгрузки в таможню.
- Code – УНП, ИНН, БИН и т.п.
- Country – код страны в соответствии с Классификатором стран мира.
- Address – полный адрес.
- DeclarationTemplatesList – список Шаблонов деклараций в Карточке контрагента. Поле отсутствует, если в карточке не добавлены шаблоны деклараций. Элементы списка содержат следующие поля:
- ID – внутренний ID шаблона в Системе TWS для использования в запросе R6 (создание декларации).
- Name – наименование шаблона декларации.