Присоединяйтесь!

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

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

Команда «СБИС.ИнформацияОКонтрагенте» возвращает информацию о контрагенте по ИНН и КПП — например, можно узнать идентификатор участника документооборота. Если по переданным параметрам карточка контрагента не найдена, будет создана новая.

Адрес запроса: https://online.sbis.ru/service/?srv=1

Для организации
Для организации
Для ИП
Для ИП
Для физического лица
Для физического лица

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

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

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

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


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

Результат

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

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

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

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

Комментарий

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

Примеры

Запрос

Ответ

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

Ответ

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

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

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

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


  • "Участник": объект:
    • "Идентификатор": строка, идентификатор участника документооборота либо трехсимвольный префикс идентификатора оператора ЭДО
    • "СвФЛ": объект:
      • "ЧастноеЛицо": строка со значением «Нет»
      • "ИНН"*: строка, 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. Обработка значения поля «ДопПоля»:
    • «СписокИдентификаторов» — в результате метода в поле «Идентификатор» вернется список подключенных идентификаторов с расширенной информацией. Если контрагент не подключен — один виртуальный идентификатор. Если передан трехсимвольный идентификатор оператора в «Участник.Идентификатор», список идентификаторов будет отфильтрован по нему;
    • значение не передано — вернется основной идентификатор участника ДО.

Примеры

Запрос

Ответ

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

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.