HTTP-сервис 1С для PDF и health

Коротко

Расширение prizma с URL /hs/prizma/v1 даёт health-проверку и печать PDF; без него OData работает, но 1c_get_invoice_pdf вернёт not_supported.

Зачем отдельный HTTP-слой

Печать макетов в 1С — серверный вызов, через OData недоступна. Призма получает PDF только через HTTP: 1c_get_invoice_pdf, 1c_get_document_pdf, 1c_list_print_forms.

Настройка перед первым подключением

  1. Установите расширение конфигурации с HTTP-сервисом prizma (модуль BSL из комплекта документации коннектора).
  2. Опубликуйте сервис на том же веб-сервере, что OData; базовый URL для Призмы: http(s)://хост/публикация/hs/prizma/v1.
  3. После изменений на IIS выполните перезапуск веб-сервера (в инструкции по установке — iisreset).
  4. Создайте в Призме вторую карточку 1С: тип HTTP, профиль «HTTP Бухгалтерия (http-buh)» (то же, что http-1c), тот же логин/пароль.
    Подключение 1С по HTTP в Призме AI: корень сервиса, путь проверки health и результат «HTTP OK» после кнопки «Проверить»
    HTTP-подключение 1С прошло проверку

Ключевые маршруты

  • GET /health (или путь из поля healthPath) — JSON {"ok": true} для probe.
  • GET /invoices/{ref}/print — PDF счёта.
  • GET /documents/{type}/{ref}/print?form=… — PDF формы.
  • GET /print-forms?type=… — список форм.

{ref} — GUID документа (как Ref_Key в OData), не номер на печати.

Как проверить, что адрес публикации работает
GET …/hs/prizma/v1/health
Authorization: Basic …

Ответ 2xx и JSON с ok: true. Иначе probe вернёт health_not_ok или HTTP-код в detail.

Как проверить, что интеграция заработала

Кнопка Проверить на HTTP-карточке — «HTTP OK». В чате запрос «Сохрани PDF последнего счёта» должен положить файл в каталог проекта .prizma-exports/1c/, а не not_supported.

Не нашли ответ? Задайте вопрос

Или напишите на info@prizmaai.ru

Была ли статья полезна?