OData и HTTP-сервис 1С: чем отличаются

Коротко

OData — основной канал чтения, создания документов, проведения и УПД; HTTP-сервис расширения — PDF и печатные формы. Для одной базы часто нужны две карточки подключения.

Два слоя к одной базе

СлойТипичный URLНазначение в Призме
OData…/odata/standard.odata/Справочники, документы, списки, создание счёта/контрагента, проведение (1c_post_document), запись УПД (1c_apply_upd), реализация (1c_create_sale — только OData)
HTTP…/hs/prizma/v1Health, те же бизнес-операции на слое B, PDF: 1c_get_invoice_pdf, 1c_list_print_forms, 1c_get_document_pdf
Форма подключения 1С типа «HTTP API расширения» в Призме AI: корень сервиса /hs/prizma/v1, путь проверки health и профиль http-buh
Подключение 1С по HTTP

Инструменты: что только на HTTP

По манифесту коннектора (notSupportedOn: odata):

  • 1c_get_invoice_pdf — PDF счёта;
  • 1c_list_print_forms — список печатных форм;
  • 1c_get_document_pdf — PDF произвольной печатной формы (УПД, ТОРГ-12, комплект и т.д.).

На OData эти вызовы возвращают code: not_supported с сообщением, что печать доступна только через HTTP API.

Инструменты: особенности слоя

  • 1c_apply_upd (запись поступления по УПД) — на OData; на HTTP-подключении → not_supported.
  • 1c_create_sale, 1c_get_document_edo_status — только OData (на HTTP → not_supported).
  • 1c_http_request — только HTTP-коннектор (произвольный GET/POST по маршрутам сервиса).
  • Workflow: 1c_parse_upd, 1c_match_counterparty, 1c_process_upd — через прокси connections_1c_invoke, не привязаны к одному транспорту.

Всего в реестре коннектора 37 имён tools с едиными названиями на OData и HTTP, где заявлен паритет.

Рекомендация

Для полного сценария «счёт + PDF + проведение» заведите две карточки 1С к одной ИБ: OData URL и HTTP URL. В хабе «Подключения» может отображаться подсказка integrationHint, если найдена только половина пары.

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

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

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