СБИС.ИнформацияОКонтрагенте

Параметры запроса

* — обязательный параметр.

** — условно-обязательный параметр.

Синий — только для чтения.

• "Участник": объект:
  • "Идентификатор": строка, идентификатор участника документооборота либо трехсимвольный префикс идентификатора оператора ЭДО
  • "СвФЛ": объект:
    • "ЧастноеЛицо": строка со значением «Нет»
    • "ИНН"*: строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
    • "Фамилия"*: строка
    • "Имя"*: строка
    • "Отчество": строка
    • "КодФилиала": строка
  • "GLN": строка, международный идентификатор организации
  • "Ответственный": объект:
    • "Фамилия": строка
    • "Имя": строка
    • "Отчество": строка
    • "Идентификатор": строка, идентификатор во внешней системе
  • "Подразделение": объект:
    • "Название": строка, название подразделения
    • "Идентификатор": строка, код подразделения
  • "ДопПоля": строка. Возможные значения: «СписокИдентификаторов» и «СФилиалами»

Результат

Стандартный вариант без вывода информации по дополнительным полям

• "СвЮЛ": объект:
  • "ИНН": строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
  • "КПП": строка, 9 символов
  • "КодФилиала": строка
  • "КодСтраны": строка, код страны по стандарту ISO 3166-1 numeric
  • "Название": строка, название организации
  • "АдресЮридический": строка, юридический адрес головной организации
• "Идентификатор": строка, содержит идентификатор участника документооборота (на момент запроса). Пустая строка, если контрагент отказался от участия в документообороте

С выводом расширенной информации

• "СвЮЛ": объект:
  • "ИНН": строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
  • "КПП": строка, 9 символов
  • "КодФилиала": строка
  • "КодСтраны": строка, код страны по стандарту ISO 3166-1 numeric
  • "Название": строка, название организации
  • "АдресЮридический": строка, юридический адрес головной организации
• "Идентификатор": массив объектов, содержит список идентификаторов абонентских ящиков:
  • "ИдентификаторУчастника": строка, идентификатор участника документооборота
  • "Комментарий": строка, комментарий к идентификатору участника документооборота
  • "Оператор": объект, описание оператора ЭДО, выдавшего идентификатор участника документооборота
    • "Идентификатор": строка, код оператора ЭДО из трех символов
    • "Название": строка, название оператора ЭДО
  • "Основной": строка, используется при отправке документов по умолчанию. Возможные значения «Да» или «Нет»
  • "Роуминг": строка, признак, что у оператора ЭДО роуминг. Возможные значения «Да» или «Нет»
  • "СостояниеПодключения": объект
    • "Код": строка, код состояния подключения. Возможные значения
    • "Описание": строка, описание состояния подключения

Комментарий

1. Если передан объект «Ответственный», то при создании нового контрагента он устанавливается в качестве ответственного.
2. Если параметр «ЧастноеЛицо» не передан, СБИС ищет сведения о контрагенте в доверенных источниках. Если информация найдена и контрагент окажется индивидуальным предпринимателем, то он будет создан как ИП. Иначе — как физическое лицо.
3. Идентификатор участника документооборота может меняться в процессе работы. Не рекомендуется сохранять и использовать этот идентификатор.
4. Обработка значения поля «Идентификатор»:
   • если передан полный идентификатор участника документооборота, он считается приоритетным для определения контрагента, прочие реквизиты игнорируются. СБИС находит контрагента по идентификатору и возвращает полные реквизиты, за исключением «АдресЮридический». Если заказан расширенный ответ метода, возвращает список идентификаторов. При этом запись в «Компании/Наши контрагенты» не создается;
   • если передан трехбуквенный префикс оператора ЭДО, то при поиске контрагента СБИС получает все его идентификаторы и возвращает в результат только те, у которых есть переданный префикс. Кроме этого возвращает остальные реквизиты — ИНН, КПП, Название, КодСтраны и другие.
5. Если в качестве идентификатора вернулась пустая строка или пустая выборка при выводе расширенной информации, значит, контрагент отказался от участия в электронном документообороте. Документы, которые вы попытаетесь ему отправить, не будут доставлены и попадут в реестр ошибок.
6. Если по переданным реквизитам (кроме «Идентификатор») контрагент не найден, СБИС создаст его в разделе «Компании/Наши контрагенты» и заполнит реквизиты по данным сервиса проверки партнеров.
7. Обработка значения поля «ДопПоля»:
   • «СписокИдентификаторов» — в результате метода в поле «Идентификатор» вернется список подключенных идентификаторов с расширенной информацией. Если контрагент не подключен — один виртуальный идентификатор. Если передан трехсимвольный идентификатор оператора в «Участник.Идентификатор», список идентификаторов будет отфильтрован по нему;
   • «СФилиалами» — вернется идентификатор участника ДО головной организации и филиалов, которые совпадают по ИНН и КПП;
   • значение не передано — вернется основной идентификатор участника ДО.

Примеры

Запрос

Ответ

Запрос с расширенной информацией об идентификаторах участников документооборота и фильтрацией по трехсимвольному префиксу участника ЭДО

Ответ

Параметры запроса

* — обязательный параметр.

** — условно-обязательный параметр. Обязательно должны присутствовать либо один из параметров, либо оба параметра. Используются в паре с параметром «ЧастноеЛицо».

Синий — только для чтения.

• "Участник": объект:
  • "Идентификатор": строка, идентификатор участника документооборота
  • "СвФЛ": объект:
    • "ЧастноеЛицо"*: строка со значением «Да»
    • "ИНН"**: строка, 12 символов для российских физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
    • "Фамилия"*: строка
    • "Имя"*: строка
    • "Отчество": строка
    • "СНИЛС"**: строка
    • "КодФилиала": строка
  • "ДопПоля": строка. Если передать значение «СписокИдентификаторов», изменится формат вывода поля «Идентификатор» в результате метода — будет выводиться расширенная информация об идентификаторах участника документооборота

Результат

Стандартный вариант без вывода информации по дополнительным полям

• "СвФЛ": объект:
  • "ИНН>": строка, 12 символов для российских физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
  • "Фамилия": строка
  • "Имя>": строка
  • "Отчество": строка
  • "СНИЛС": строка
  • "ЧастноеЛицо": строка "Да"
• "Идентификатор": строка, содержит идентификатор участника документооборота (на момент запроса). Пустая строка, если контрагент отказался от участия в документообороте

С выводом расширенной информации

• "СвФЛ": объект:
  • "ИНН": строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
  • "Фамилия": строка
  • "Имя": строка
  • "Отчество": строка
  • "СНИЛС": строка
  • "ЧастноеЛицо": строка "Да"
• "Идентификатор": массив объектов, содержит список идентификаторов абонентских ящиков:
  • "ИдентификаторУчастника": строка, идентификатор участника документооборота
  • "Комментарий": строка, комментарий к идентификатору участника документооборота
  • "Оператор": объект, описание оператора ЭДО, выдавшего идентификатор участника документооборота
    • "Идентификатор": строка, код оператора ЭДО из трех символов
    • "Название": строка, название оператора ЭДО
  • "Основной": строка, используется при отправке документов по умолчанию. Возможные значения «Да» или «Нет»
  • "Роуминг": строка, признак, что у оператора ЭДО роуминг. Возможные значения «Да» или «Нет»
  • "СостояниеПодключения": объект
    • "Код": строка, код состояния подключения. Возможные значения
    • "Описание": строка, описание состояния подключения

Комментарий

1. Если параметр «ЧастноеЛицо» не передан, СБИС ищет сведения о контрагенте в доверенных источниках. Если информация найдена и контрагент окажется индивидуальным предпринимателем, то он будет создан как ИП. Иначе — как физическое лицо.
2. Идентификатор участника документооборота может меняться в процессе работы. Не рекомендуется сохранять и использовать этот идентификатор.
3. Обработка значения поля «Идентификатор»:
   • если передан полный идентификатор участника документооборота, он считается приоритетным для определения контрагента, прочие реквизиты игнорируются. СБИС находит контрагента по идентификатору и возвращает полные реквизиты, за исключением «АдресЮридический». Если заказан расширенный ответ метода, возвращает список идентификаторов. При этом запись в «Компании/Наши контрагенты» не создается;
   • если передан трехбуквенный префикс оператора ЭДО, то при поиске контрагента СБИС получает все его идентификаторы и возвращает в результат только те, у которых есть переданный префикс. Кроме этого возвращает остальные реквизиты — ИНН, КПП, Название, КодСтраны и другие.
4. Если в качестве идентификатора вернулась пустая строка или пустая выборка при выводе расширенной информации, значит, контрагент отказался от участия в электронном документообороте. Документы, которые вы попытаетесь ему отправить, не будут доставлены и попадут в реестр ошибок.
5. Если по переданным реквизитам (кроме «Идентификатор») контрагент не найден, СБИС создаст его в разделе «Компании/Наши контрагенты» и заполнит реквизиты по данным сервиса проверки партнеров.
6. Обработка значения поля «ДопПоля»:
   • «СписокИдентификаторов» — в результате метода в поле «Идентификатор» вернется список подключенных идентификаторов с расширенной информацией. Если контрагент не подключен — один виртуальный идентификатор. Если передан трехсимвольный идентификатор оператора в «Участник.Идентификатор», список идентификаторов будет отфильтрован по нему;
   • значение не передано — вернется основной идентификатор участника ДО.

Примеры

Запрос

Ответ

Запрос с дополнительным полем