HTTP-сервис 1С: как устроен и когда он нужен бизнесу
Подрядчик, который делает новый интернет-магазин, пишет: «Дайте нам API к 1С, иначе остатки на сайте будут обновляться раз в сутки». Менеджеры жалуются, что заказы с сайта перебивают в программу вручную, а CRM не видит, оплатил ли клиент счёт. Руководителю нужно решить, что заказывать, сколько это стоит и не сломается ли всё после очередного обновления.
Разбираем простыми словами, что такое HTTP-сервис 1С, чем он отличается от выгрузки файлов и стандартного интерфейса OData и в каких случаях он окупается.
С какими задачами к нам приходят
- остатки и цены на сайте или маркетплейсе отстают от учётной системы на несколько часов;
- заказы из интернет-магазина, CRM или приложения переносят в 1С руками;
- торговым представителям, курьерам и монтажникам нужны данные из 1С в телефоне;
- склад работает во внешней системе управления, а документы нужны в 1С;
- обмен файлами иногда молча останавливается, расхождения находят через неделю;
- подрядчик предлагает читать данные напрямую из таблиц SQL, минуя 1С.
Задачи разные, а вопрос один: как дать другой программе доступ к данным 1С быстро, надёжно и без риска для учёта.
Во что обходится запаздывающий обмен
Покупатель оплачивает на сайте товар, который час назад продали в розничном магазине. Заказ приходится отменять, клиент уходит к конкуренту и оставляет отзыв. Оператор перебивает сорок заказов в день по три минуты — это два часа рабочего времени ежедневно, плюс опечатки в адресах и количествах.
Хуже всего, когда цифры расходятся: в CRM одна задолженность клиента, в 1С другая. Менеджер звонит с напоминанием об оплате, которая уже прошла, а руководитель перестаёт доверять обоим отчётам.
Почему обходные пути не работают
Документация платформы «1С:Предприятие» выделяет несколько способов связать программы: обмен файлами, общая база данных, вызов программного интерфейса одной системы из другой и сервисная шина. У популярных обходных путей есть ограничения:
- Обмен файлами. Программы по расписанию выгружают и забирают файлы. Данные передаются, но вызвать действие — создать заказ и сразу получить его номер — нельзя, а свежесть данных зависит от расписания;
- Прямое чтение базы данных. Работает быстро, но структура таблиц 1С не является обещанием разработчика. После обновления конфигурации такие запросы перестают работать, и узнают об этом обычно от клиентов;
- Ручной перенос. Терпимо, пока заказов немного, затем становится узким местом и источником ошибок.
Что такое HTTP-сервис 1С
HTTP-сервис — объект конфигурации 1С, который принимает запросы по протоколу HTTP на заданный адрес и отвечает на них. Это программный вход в учётную систему: внешняя программа не видит базу целиком, а обращается к конкретным ресурсам, которые для неё описал разработчик, например «остатки по складу» или «заказ покупателя».
Адрес выглядит так: https://сервер/база/hs/корневой-адрес/ресурс. Часть hs показывает, что запрос адресован HTTP-сервису. Действие задаёт метод запроса: GET — получить данные, POST — передать новые, DELETE — удалить. За каждый метод отвечает обработчик на встроенном языке 1С: он проверяет запрос, читает или записывает данные и возвращает ответ, чаще всего в формате JSON. Такой подход часто называют REST API.
Чтобы сервис стал доступен другим программам, базу публикуют на веб-сервере, который поддерживает платформа: Apache или IIS. Для рабочей базы, к которой обращаются через интернет, фирма «1С» настоятельно рекомендует протокол HTTPS вместо HTTP.
HTTP-сервис, OData или обмен файлами: что выбрать
- Стандартный интерфейс OData встроен в платформу и даёт доступ к данным без изменения программного кода. Подходит, когда внешней системе достаточно читать справочники и документы как есть, например для аналитики. Минус: внешняя сторона должна разбираться в устройстве объектов 1С, а проверки и расчёты ложатся на неё;
- HTTP-сервис нужен, когда требуется свой понятный контракт: «верни остатки по складу», «создай заказ и сообщи номер», «покажи статус оплаты». Бизнес-правила остаются в 1С, внешней программе не нужно знать её внутреннее устройство;
- Обмен файлами или типовой обмен уместен, когда данных много, а срочность низкая, например каталог раз в сутки. Между базами 1С обычно хватает типовых механизмов — см. обмен данными между базами 1С.
Многие типовые программы фирмы «1С» уже содержат собственные HTTP-сервисы: например, в «1С:Управление службой поддержки» их пять. Поэтому перед разработкой мы проверяем, нет ли готового сервиса или модуля обмена для нужной системы.
Когда HTTP-сервис действительно нужен
- сайту или маркетплейсу нужны остатки и цены на текущий момент — интеграция сайта с 1С;
- заказ из внешней системы должен сразу появиться в учёте и вернуть номер и статус;
- CRM показывает менеджеру долги, оплаты и отгрузки клиента — интеграция 1С и Битрикс24;
- мобильное приложение торгового представителя, курьера или монтажника работает с данными 1С;
- внешние сервисы доставки, оплаты или телефонии сообщают 1С о событиях: посылка вручена, звонок завершён.
Если же раз в неделю нужно выгрузить прайс в Excel, сервис избыточен: хватит обычного отчёта или обработки.
Как мы делаем HTTP-сервис
- Описываем контракт. Вместе с подрядчиком внешней системы фиксируем ресурсы, поля, форматы и коды ошибок. Документ остаётся у вас;
- Разрабатываем в расширении. Сервис добавляем расширением конфигурации, типовая часть не меняется, поэтому обновления ставятся как обычно. При подключении расширения платформа проверяет, что корневой адрес сервиса уникален;
- Настраиваем доступ. Отдельный пользователь 1С с правами только на нужные данные, публикация на веб-сервере по HTTPS, при необходимости — ограничение по адресам;
- Проверяем. Тестируем на копии базы, даём подрядчику тестовый адрес, затем переносим в рабочую базу;
- Сопровождаем. Записываем ошибки обращений в журнал, после обновлений проверяем, что сервис отвечает.
Что получает компания
- данные во внешних системах совпадают с 1С без ручного переноса;
- заказы попадают в учёт сразу, без перебивки и опечаток;
- подрядчик сайта или приложения работает по описанному контракту, а не по структуре таблиц;
- обновления 1С не ломают обмен, а при сбое видно, какой запрос не прошёл;
- наружу открыты ровно те данные, которые нужны внешней программе.
Почему мы
Мы внедряем и сопровождаем 1С и сами пишем HTTP-сервисы: наши собственные системы обмениваются с 1С именно так. Типовые задачи выполняем по фиксированной цене за интеграцию — стоимость известна до начала работ, нестандартные оцениваем после того, как описан контракт.
Вопросы и ответы
Наружу открывается не база целиком, а конкретные ресурсы сервиса. Обращения идут по HTTPS под отдельным пользователем с ограниченными правами, а обработчик сам проверяет, что ему передали.
Сервис живёт в расширении, а контракт не зависит от устройства таблиц, поэтому обновления обычно проходят спокойно. После установки нового релиза мы проверяем, что сервис отвечает, и при необходимости адаптируем расширение.
Веб-сервис, адрес которого содержит /ws/, работает по протоколу SOAP с описанием в формате WSDL. HTTP-сервис с адресом /hs/ свободнее: формат запросов и ответов задаёт разработчик, обычно это JSON. Современным сайтам и приложениям удобнее второй вариант.
Нужен веб-сервер, который поддерживает платформа, — Apache или IIS, и на этом же компьютере должны быть компоненты 1С. Отдельная машина не обязательна: решаем по нагрузке и требованиям безопасности.
Для чтения данных подойдёт стандартный интерфейс OData: его включают без изменения кода программы. Если нужна своя логика — проверки, расчёты, создание документов, — понадобится HTTP-сервис.
Зависит от числа ресурсов и сложности правил. Типовые интеграции делаем по фиксированной цене, нестандартные оцениваем после описания контракта.
Расскажите, какую программу нужно связать с 1С и какие данные она должна получать или передавать, — специалист по 1С предложит способ интеграции и оценит работы.