Обмен 1С с сайтом: HTTP-сервис или OData, авторизация и частые ошибки

Сайт и 1С обмениваются данными в двух типовых сценариях: сайт забирает из 1С каталог, цены и остатки, а 1С забирает заказы и заявки с сайта. Разберём два способа и правила, которые не дают обмену превратиться в источник сбоев.

Два способа: OData и HTTP-сервис

Практическое правило: для каталога и остатков чаще удобнее свой HTTP-сервис с компактным ответом, а OData годится для быстрых прототипов и административных задач.

OData: пример чтения из Python

После включения OData и публикации базы объекты доступны по адресу вида http://сервер/база/odata/standard.odata/Catalog_Номенклатура.

import requests

BASE = "https://example.com/base/odata/standard.odata"


def items(top: int = 10) -> list[dict]:
    r = requests.get(
        f"{BASE}/Catalog_Номенклатура",
        params={"$format": "json", "$top": top},
        auth=("integration", "пароль-из-хранилища"),
        timeout=20,
    )
    r.raise_for_status()
    return r.json()["value"]

Логин и пароль берите из переменных окружения или хранилища секретов, а не из кода.

HTTP-сервис: пример метода

В конфигураторе создаётся объект «HTTP-сервис» с корневым URL и шаблоном. Обработчик метода возвращает ответ с JSON:

Функция ТоварыGET(Запрос)

	Данные = Новый Массив;
	// ... заполнение данных из справочника ...

	Запись = Новый ЗаписьJSON;
	Запись.УстановитьСтроку();
	ЗаписатьJSON(Запись, Данные);

	Ответ = Новый HTTPСервисОтвет(200);
	Ответ.Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");
	Ответ.УстановитьТелоИзСтроки(Запись.Закрыть(), КодировкаТекста.UTF8);
	Возврат Ответ;

КонецФункции

Адрес метода формируется как http://сервер/база/hs/корневойURL/шаблон. Проверяйте синтаксис на своей версии платформы.

Правила безопасности

• Не открывайте базу в интернет напрямую. Ставьте перед 1С обратный прокси (например, nginx) с HTTPS и ограничением по IP-адресам сайта.
• Отдельный пользователь для интеграции с минимальной ролью: только те объекты и права, которые нужны обмену.
• HTTPS обязательно. Логин и пароль в Basic-авторизации по HTTP уходят открытым текстом.
• Пароли и токены не хранят в коде. Переменные окружения или хранилище секретов.
• Ограничьте объём выдачи: пагинация и лимиты, чтобы один запрос не загрузил сервер 1С.

Правила надёжности обмена

1. Идемпотентность. Каждому заказу присваивайте уникальный идентификатор. Если запрос ушёл повторно, 1С должна понять, что заказ уже есть, а не создать дубль.
2. Очередь и повторы. Не пишите в 1С прямо из обработчика на сайте. Сохраняйте заказ у себя и передавайте в 1С отдельным процессом с повторными попытками.
3. Статус обмена. Храните у каждого заказа признак «передан в 1С» и время. Это позволит найти потерянные и увидеть сбои.
4. Не блокируйте пользователя. Если 1С недоступна, сайт должен принять заказ и передать позже.
5. Версии и совместимость. Меняя формат ответа, сохраняйте старые поля или версионируйте методы (/v1/, /v2/).
6. Логи. Пишите в журнал каждый вызов и ошибку, иначе разбор сбоев превращается в угадывание.

Типичные ошибки

• Кодировка. Отправляйте и принимайте JSON в UTF-8 и явно указывайте её в заголовке.
• Тяжёлые выборки. Запрос «все товары» с реквизитами и остатками вешает сеанс. Делайте страницы и отдельный метод остатков.
• Сеансы и лицензии. Каждое обращение использует сеанс базы: проверьте лицензирование и настройте тайм-ауты.
• Часовые пояса и даты. Передавайте даты в едином формате и часовом поясе.
• Изменили конфигурацию. После обновления проверьте, что методы опубликованы, права на месте и формат не изменился.

Что дальше

Если нужно связать 1С с сайтом, интернет-магазином, Telegram и другими сервисами, подробности в разделе «1С и учётные системы» и в услуге «Интеграции и API». Родственные темы: отправка сообщений из 1С в Telegram.