Связать сайт, CRM или мобильное приложение с 1С:Бухгалтерия — задача, с которой сталкивается каждый второй средний бизнес. Стандартные инструменты платформы — OData, COM-соединение, типовые веб-сервисы — рассчитаны на 1С-разработчиков. Команда на PHP, Python или Node.js хочет JSON, понятные URL и документацию в духе OpenAPI.
Почему OData не всегда подходит
OData — штатный способ «вытащить» данные из 1С. Он мощный, но:
- запросы к метаданным и справочникам тяжёлые — легко перегрузить сервер;
- контракт «весь справочник контрагентов» шире, чем нужно интеграции;
- безопасность и права доступа требуют отдельной проработки;
- фронтенд-разработчик тратит недели на изучение специфики 1С.
Для узкой задачи — «создать счёт, акт, найти контрагента» — REST-слой поверх типовой конфигурации закрывает 90% потребностей быстрее.
Как устроен bit_http_api
Расширение bit_http_api для 1С:Бухгалтерия предприятия 3.0 публикует HTTP-сервис с ресурсами:
/invoices— счета на оплату;/acts— акты выполненных работ;/counterparties— контрагенты (поиск и создание).
Аутентификация — Basic Auth. Тело запроса — JSON. Ответ — JSON с номером документа и ссылкой на PDF, если настроена печатная форма.
Пример сценария
Интернет-магазин принимает оплату → backend отправляет POST на /hs/bit_http_api/invoices → в 1С появляется счёт с привязкой к контрагенту → клиент получает PDF по ссылке или из вашего сервиса.
Быстрый старт за один день
- Скопируйте тестовую базу 1С:Бухгалтерия 3.0 или используйте демо.
- Установите расширение штатными средствами («Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения»).
- Опубликуйте HTTP-сервис на IIS или Apache — как обычный веб-сервис 1С.
- Создайте пользователя с ролью
bitHttpApi_ОсновнаяРоль— не используйте учётку администратора. - Отправьте тестовый POST из Postman или curl с Basic Auth.
- Проверьте документ в 1С и сверьте JSON со схемой в Swagger.
Безопасность и эксплуатация
- HTTPS обязателен на боевом сервере.
- Отдельный пользователь API с минимальными правами.
- Логирование запросов на стороне reverse proxy (nginx) — проще разбирать инциденты.
- Обновления расширения — через типовой механизм 1С, без снятия с поддержки конфигурации.
Когда REST API — правильный выбор
Подходит, если нужны счета, акты, контрагенты и PDF для сайта, CRM, биллинга или мобильного приложения. Не заменяет полноценный обмен каталогом — для номенклатуры и остатков смотрите CommerceML или комбинируйте оба канала.
Полная документация, примеры curl и Swagger — на странице REST API для 1С:Бухгалтерия. Внедрение и публикация на вашем сервере — CodeLab.