1. Главная
  2. Руководство Пользователя
  3. Руководство Пользователя

Запрос 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 – полный адрес.