Команда «СБИС.ИнформацияОКонтрагенте» возвращает информацию о контрагенте по ИНН и КПП — например, можно узнать идентификатор участника документооборота. Если по переданным параметрам карточка контрагента не найдена, будет создана новая.
Адрес запроса: 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
- "Название>": строка, название организации
- "АдресЮридический>": строка, юридический адрес головной организации
- "Идентификатор": массив объектов, содержит список идентификаторов абонентских ящиков:
- "ИдентификаторУчастника": строка, идентификатор участника документооборота
- "Комментарий": строка, комментарий к идентификатору участника документооборота
- "Оператор": объект, описание оператора ЭДО, выдавшего идентификатор участника документооборота
- "Идентификатор": строка, код оператора ЭДО из трех символов
- "Название": строка, название оператора ЭДО
- "Основной": строка, используется при отправке документов по умолчанию. Возможные значения «Да» или «Нет»
- "Роуминг": строка, признак, что у оператора ЭДО роуминг. Возможные значения «Да» или «Нет»
- "СостояниеПодключения": объект
- "Код": строка, код состояния подключения. Возможные значения
- "Описание": строка, описание состояния подключения
Комментарий
- Если передан объект «Ответственный», то при создании нового контрагента он устанавливается в качестве ответственного.
- Идентификатор участника документооборота может меняться в процессе работы. Не рекомендуется сохранять и использовать этот идентификатор.
- Обработка значения поля «Идентификатор»:
- если передан полный идентификатор участника документооборота, он считается приоритетным для определения контрагента, прочие реквизиты игнорируются. СБИС находит контрагента по идентификатору и возвращает полные реквизиты, за исключением «АдресЮридический». Если заказан расширенный ответ метода, возвращает список идентификаторов. При этом запись в «Компании/Наши контрагенты» не создается;
- если передан трехбуквенный префикс оператора ЭДО, то при поиске контрагента СБИС получает все его идентификаторы и возвращает в результат только те, у которых есть переданный префикс. Кроме этого возвращает остальные реквизиты — ИНН, КПП, Название, КодСтраны и другие.
- Если в качестве идентификатора вернулась пустая строка или пустая выборка при выводе расширенной информации, значит, контрагент отказался от участия в электронном документообороте. Документы, которые вы попытаетесь ему отправить, не будут доставлены и попадут в реестр ошибок.
- Если по переданным реквизитам (кроме «Идентификатор») контрагент не найден, СБИС создаст его в разделе «Компании/Наши контрагенты» и заполнит реквизиты по данным сервиса проверки партнеров.
- Обработка значения поля «ДопПоля»:
- «СписокИдентификаторов» — в результате метода в поле «Идентификатор» вернется список подключенных идентификаторов с расширенной информацией. Если контрагент не подключен — один виртуальный идентификатор. Если передан трехсимвольный идентификатор оператора в «Участник.Идентификатор», список идентификаторов будет отфильтрован по нему;
- «СФилиалами» — вернется идентификатор участника ДО головной организации и филиалов, которые совпадают по ИНН и КПП;
- значение не передано — вернется основной идентификатор участника ДО.
Примеры
Запрос
Ответ
Запрос с расширенной информацией об идентификаторах участников документооборота
Ответ
Параметры запроса
** — условно-обязательный параметр.
- "Участник": объект:
- "Идентификатор": строка, идентификатор участника документооборота либо трехсимвольный префикс идентификатора оператора ЭДО
- "СвФЛ": объект:
- "ЧастноеЛицо": строка со значением «Нет»
- "ИНН"*: строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
- "Фамилия"*: строка
- "Имя"*: строка
- "Отчество": строка
- "КодФилиала": строка
- "GLN": строка, международный идентификатор организации
- "Ответственный": объект:
- "Фамилия": строка
- "Имя": строка
- "Отчество": строка
- "Идентификатор": строка, идентификатор во внешней системе
- "Подразделение": объект:
- "Название": строка, название подразделения
- "Идентификатор": строка, код подразделения
- "ДопПоля": строка. Возможные значения: «СписокИдентификаторов» и «СФилиалами»
Результат
Стандартный вариант без вывода информации по дополнительным полям
- "СвЮЛ": объект:
- "ИНН": строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
- "КПП": строка, 9 символов
- "КодФилиала": строка
- "КодСтраны": строка, код страны по стандарту ISO 3166-1 numeric
- "Название": строка, название организации
- "АдресЮридический": строка, юридический адрес головной организации
- "Идентификатор": строка, содержит идентификатор участника документооборота (на момент запроса). Пустая строка, если контрагент отказался от участия в документообороте
С выводом расширенной информации
- "СвЮЛ": объект:
- "ИНН": строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
- "КПП": строка, 9 символов
- "КодФилиала": строка
- "КодСтраны": строка, код страны по стандарту ISO 3166-1 numeric
- "Название": строка, название организации
- "АдресЮридический": строка, юридический адрес головной организации
- "Идентификатор": массив объектов, содержит список идентификаторов абонентских ящиков:
- "ИдентификаторУчастника": строка, идентификатор участника документооборота
- "Комментарий": строка, комментарий к идентификатору участника документооборота
- "Оператор": объект, описание оператора ЭДО, выдавшего идентификатор участника документооборота
- "Идентификатор": строка, код оператора ЭДО из трех символов
- "Название": строка, название оператора ЭДО
- "Основной": строка, используется при отправке документов по умолчанию. Возможные значения «Да» или «Нет»
- "Роуминг": строка, признак, что у оператора ЭДО роуминг. Возможные значения «Да» или «Нет»
- "СостояниеПодключения": объект
- "Код": строка, код состояния подключения. Возможные значения
- "Описание": строка, описание состояния подключения
Комментарий
- Если передан объект «Ответственный», то при создании нового контрагента он устанавливается в качестве ответственного.
- Если параметр «ЧастноеЛицо» не передан, СБИС ищет сведения о контрагенте в доверенных источниках. Если информация найдена и контрагент окажется индивидуальным предпринимателем, то он будет создан как ИП. Иначе — как физическое лицо.
- Идентификатор участника документооборота может меняться в процессе работы. Не рекомендуется сохранять и использовать этот идентификатор.
- Обработка значения поля «Идентификатор»:
- если передан полный идентификатор участника документооборота, он считается приоритетным для определения контрагента, прочие реквизиты игнорируются. СБИС находит контрагента по идентификатору и возвращает полные реквизиты, за исключением «АдресЮридический». Если заказан расширенный ответ метода, возвращает список идентификаторов. При этом запись в «Компании/Наши контрагенты» не создается;
- если передан трехбуквенный префикс оператора ЭДО, то при поиске контрагента СБИС получает все его идентификаторы и возвращает в результат только те, у которых есть переданный префикс. Кроме этого возвращает остальные реквизиты — ИНН, КПП, Название, КодСтраны и другие.
- Если в качестве идентификатора вернулась пустая строка или пустая выборка при выводе расширенной информации, значит, контрагент отказался от участия в электронном документообороте. Документы, которые вы попытаетесь ему отправить, не будут доставлены и попадут в реестр ошибок.
- Если по переданным реквизитам (кроме «Идентификатор») контрагент не найден, СБИС создаст его в разделе «Компании/Наши контрагенты» и заполнит реквизиты по данным сервиса проверки партнеров.
- Обработка значения поля «ДопПоля»:
- «СписокИдентификаторов» — в результате метода в поле «Идентификатор» вернется список подключенных идентификаторов с расширенной информацией. Если контрагент не подключен — один виртуальный идентификатор. Если передан трехсимвольный идентификатор оператора в «Участник.Идентификатор», список идентификаторов будет отфильтрован по нему;
- «СФилиалами» — вернется идентификатор участника ДО головной организации и филиалов, которые совпадают по ИНН и КПП;
- значение не передано — вернется основной идентификатор участника ДО.
Примеры
Запрос
Ответ
Запрос с расширенной информацией об идентификаторах участников документооборота и фильтрацией по трехсимвольному префиксу участника ЭДО
Ответ
Параметры запроса
** — условно-обязательный параметр. Обязательно должны присутствовать либо один из параметров, либо оба параметра. Используются в паре с параметром «ЧастноеЛицо».
- "Участник": объект:
- "Идентификатор": строка, идентификатор участника документооборота
- "СвФЛ": объект:
- "ДопПоля": строка. Если передать значение «СписокИдентификаторов», изменится формат вывода поля «Идентификатор» в результате метода — будет выводиться расширенная информация об идентификаторах участника документооборота
Результат
Стандартный вариант без вывода информации по дополнительным полям
- "СвФЛ": объект:
- "ИНН>": строка, 12 символов для российских физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
- "Фамилия": строка
- "Имя>": строка
- "Отчество": строка
- "СНИЛС": строка
- "ЧастноеЛицо": строка "Да"
- "Идентификатор": строка, содержит идентификатор участника документооборота (на момент запроса). Пустая строка, если контрагент отказался от участия в документообороте
С выводом расширенной информации
- "СвФЛ": объект:
- "ИНН": строка, 12 символов для российских индивидуальных предпринимателей и физических лиц. Для иностранных организаций номер определяется требованиями законодательства их стран
- "Фамилия": строка
- "Имя": строка
- "Отчество": строка
- "СНИЛС": строка
- "ЧастноеЛицо": строка "Да"
- "Идентификатор": массив объектов, содержит список идентификаторов абонентских ящиков:
- "ИдентификаторУчастника": строка, идентификатор участника документооборота
- "Комментарий": строка, комментарий к идентификатору участника документооборота
- "Оператор": объект, описание оператора ЭДО, выдавшего идентификатор участника документооборота
- "Идентификатор": строка, код оператора ЭДО из трех символов
- "Название": строка, название оператора ЭДО
- "Основной": строка, используется при отправке документов по умолчанию. Возможные значения «Да» или «Нет»
- "Роуминг": строка, признак, что у оператора ЭДО роуминг. Возможные значения «Да» или «Нет»
- "СостояниеПодключения": объект
- "Код": строка, код состояния подключения. Возможные значения
- "Описание": строка, описание состояния подключения
Комментарий
- Если параметр «ЧастноеЛицо» не передан, СБИС ищет сведения о контрагенте в доверенных источниках. Если информация найдена и контрагент окажется индивидуальным предпринимателем, то он будет создан как ИП. Иначе — как физическое лицо.
- Идентификатор участника документооборота может меняться в процессе работы. Не рекомендуется сохранять и использовать этот идентификатор.
- Обработка значения поля «Идентификатор»:
- если передан полный идентификатор участника документооборота, он считается приоритетным для определения контрагента, прочие реквизиты игнорируются. СБИС находит контрагента по идентификатору и возвращает полные реквизиты, за исключением «АдресЮридический». Если заказан расширенный ответ метода, возвращает список идентификаторов. При этом запись в «Компании/Наши контрагенты» не создается;
- если передан трехбуквенный префикс оператора ЭДО, то при поиске контрагента СБИС получает все его идентификаторы и возвращает в результат только те, у которых есть переданный префикс. Кроме этого возвращает остальные реквизиты — ИНН, КПП, Название, КодСтраны и другие.
- Если в качестве идентификатора вернулась пустая строка или пустая выборка при выводе расширенной информации, значит, контрагент отказался от участия в электронном документообороте. Документы, которые вы попытаетесь ему отправить, не будут доставлены и попадут в реестр ошибок.
- Если по переданным реквизитам (кроме «Идентификатор») контрагент не найден, СБИС создаст его в разделе «Компании/Наши контрагенты» и заполнит реквизиты по данным сервиса проверки партнеров.
- Обработка значения поля «ДопПоля»:
- «СписокИдентификаторов» — в результате метода в поле «Идентификатор» вернется список подключенных идентификаторов с расширенной информацией. Если контрагент не подключен — один виртуальный идентификатор. Если передан трехсимвольный идентификатор оператора в «Участник.Идентификатор», список идентификаторов будет отфильтрован по нему;
- значение не передано — вернется основной идентификатор участника ДО.
Примеры
Запрос
Ответ
Запрос с дополнительным полем