Получить поставщиков

HTTP-сервис suppliers, метод GetSuppliers. Возвращает контрагентов с признаком Поставщик (Справочник.Контрагенты, Поставщик = Истина) без пометки на удаление.

Endpoint

GET /main/hs/suppliers/get

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

Все параметры опциональны. Читаются из query string (ПараметрыЗапроса) или из URL-шаблона (ПараметрыURL).

Параметр	Тип	Описание
`name`	string	Фильтр по наименованию контрагента. Поиск ПОДОБНО — подстрока в `Наименование`
`inn`	string	Фильтр по ИНН. Поиск ПОДОБНО — подстрока в `ИНН`
`full`	boolean	Расширенный ответ: массив действующих договоров вместо сводки. Истина: `1`, `true`, `yes`, `да`

Фильтры можно комбинировать. Без параметров возвращаются все поставщики (с учётом прав публикации 1С).

Примеры запросов

GET /main/hs/suppliers/get
GET /main/hs/suppliers/get?name=Пример
GET /main/hs/suppliers/get?inn=7700
GET /main/hs/suppliers/get?name=ООО&inn=52
GET /main/hs/suppliers/get?inn=7700000002&full=true

Формат ответа

Базовый ответ

{
  "data": [
    {
      "Наименование": "ООО «ПримерПоставка»",
      "НаименованиеПолное": "Общество с ограниченной ответственностью «ПримерПоставка»",
      "ИНН": "7700000001",
      "КПП": "770001001",
      "ОГРН": "1027700000000",
      "КодПоОКПО": "00000001",
      "ЮрФизЛицо": "Юр. лицо",
      "СрокВыполненияЗаказа": 5,
      "ТакжеПокупатель": false,
      "НеРезидент": false,
      "Комментарий": "",
      "Договоры": {
        "Есть": true,
        "Количество": 2
      }
    }
  ],
  "errors": []
}

Расширенный ответ (`full=true`)

Поле Договоры — массив действующих договоров контрагента (Справочник.ДоговорыКонтрагентов, без пометки на удаление):

{
  "data": [
    {
      "Наименование": "ООО «ПримерПоставка»",
      "ИНН": "7700000001",
      "Договоры": [
        {
          "Наименование": "Поставка материалов 2025",
          "Номер": "ДГ-DEMO-12",
          "Дата": "15.01.2025",
          "СрокДействия": "31.12.2025",
          "Организация": "ООО «ДемоСтрой Альфа»",
          "ВидДоговора": "С поставщиком",
          "Валюта": "руб."
        }
      ]
    }
  ],
  "errors": []
}

Поля ответа

Поставщик

Поле	Тип	Источник в 1С	Описание
`data`	array	—	Массив поставщиков. Сортировка: наименование по возрастанию
`data[].Наименование`	string	`Наименование`	Краткое наименование
`data[].НаименованиеПолное`	string	`НаименованиеПолное`	Полное наименование
`data[].ИНН`	string	`ИНН`	ИНН
`data[].КПП`	string	`КПП`	КПП
`data[].ОГРН`	string	`ОГРН`	ОГРН
`data[].КодПоОКПО`	string	`КодПоОКПО`	Код по ОКПО
`data[].ЮрФизЛицо`	string	`ЮрФизЛицо`	Представление юр./физ. лица
`data[].СрокВыполненияЗаказа`	number	`СрокВыполненияЗаказаПоставщиком`	Срок выполнения заказа поставщиком (дней)
`data[].ТакжеПокупатель`	boolean	`Покупатель`	Контрагент также является покупателем
`data[].НеРезидент`	boolean	`НеЯвляетсяРезидентом`	Не резидент РФ
`data[].Комментарий`	string	`Комментарий`	Комментарий
`errors`	array	—	Ошибки обработки запроса

Договоры

Без full — сводка { Есть, Количество }. При full=true — массив договоров, сортировка по дате договора убыв.

Поле	Тип	Источник в 1С	Описание
`Договоры.Есть`	boolean	—	Есть ли договоры (только без `full`)
`Договоры.Количество`	number	—	Количество договоров (только без `full`)
`Договоры[].Наименование`	string	`Наименование`	Наименование договора
`Договоры[].Номер`	string	`Номер`	Номер договора
`Договоры[].Дата`	string	`Дата`	Дата договора (`ДД.ММ.ГГГГ`) или пустая строка
`Договоры[].СрокДействия`	string	`СрокДействия`	Срок действия (`ДД.ММ.ГГГГ`) или пустая строка
`Договоры[].Организация`	string	`Организация`	Организация
`Договоры[].ВидДоговора`	string	`ВидДоговора`	Вид договора
`Договоры[].Валюта`	string	`ВалютаВзаиморасчетов`	Валюта взаиморасчётов

HTTP-коды

Код	Когда	Тело
200	Запрос обработан	`{ "data": [...], "errors": [...] }`
500	Непредвиденная ошибка на стороне 1С	`{ "error": "текст ошибки" }`

Примечания

В выборку попадают только контрагенты с флагом Поставщик и без пометки на удаление.
Договоры отбираются по владельцу-контрагенту; отдельного фильтра по сроку действия в запросе нет — исключаются только помеченные на удаление.
При full=true параметр code не требуется (в отличие от методов документов с табличной частью).
Ответ содержит заголовок Access-Control-Allow-Origin: *.