Какой endpoint использовать для общего PDF/A output?

Используйте POST /api/v1/pdf/render с подходящим значением settings.profile для ordinary PDF/A output.

Когда нужен E-Invoice Render?

Используйте E-Invoice Render, когда документ должен быть Factur-X или ZUGFeRD PDF/A-3b package со встроенным CII XML.

Валидирует ли gPdf archival acceptance?

Нет. gPdf рендерит PDF/A output. Ваша система должна валидировать output по archive или customer acceptance policy.

Можно ли совместить PDF/A с security settings?

Не в текущем public Render API. settings.profile и settings.security взаимоисключающие, а invalid combinations не проходят validation.

Compliance и архивирование

PDF/A API для archival PDF generation

Генерируйте PDF/A output из JSON Render requests для archival workflows, четко разделяя PDF/A profiles и e-invoice packaging.

ОСНОВНАЯ API JSON Render

ENDPOINT /api/v1/pdf/render

СИСТЕМЫ compliance backend / archive service / ERP export service / document automation service

Попробовать в Playground Читать документацию

Задача сценария

Генерировать PDF/A-profile output из structured document requests, когда business workflow нужны archival-friendly PDFs, выбирая E-Invoice Render только там, где требуется embedded XML invoice packaging.

Когда использовать эту API

Workflow требует PDF/A profile, выбранный в render settings.
Нужен archival invoice, statement, report или document output.
Нужна общая PDF/A page, которая шире PDF/A-3b e-invoice packaging.
Вы можете валидировать produced file собственным archival acceptance workflow.

Что она не заменяет

Нужен Factur-X или ZUGFeRD со встроенным EN 16931 CII XML. Используйте E-Invoice Render.
Нужен validator-only workflow. Используйте страницы validator для validation context.
Нужны encrypted output и PDF/A в одном request. Public Render API считает security settings и PDF/A profile settings взаимоисключающими.

Какой endpoint вызывать

ОСНОВНОЙ

/api/v1/pdf/render

JSON Render — путь по умолчанию для этого сценария.

ДОПОЛНИТЕЛЬНЫЙ 1

/api/v1/e-invoice/render

Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.

Минимальный запрос

POST /api/v1/pdf/render - обычная настройка PDF/A output.

{
  "settings": {
    "profile": "pdfa-2b"
  },
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Archive-ready document",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

Что выполняет gPdf

PDF/A profile settings на JSON Render requests.
Document rendering с text, tables, images, barcodes, metadata и profile output.
PDF/A-3b e-invoice packaging только через E-Invoice Render path.
Binary PDF response с общим error behavior.

Что контролирует ваша система

Archival policy, profile selection, validation workflow, retention и legal acceptance.
Document semantics, business data и любые required external evidence.
Storage, access control и future migration policy.

Production-чеклист

Выберите PDF/A profile, который требует ваш archive или customer.
Прогоняйте output через ваш validator и retention acceptance workflow.
Держите PDF/A и security settings в отдельных render flows, пока public docs не добавят совместимый contract.
Используйте E-Invoice Render, когда требуется embedded CII XML.
Храните source data или returned PDF согласно retention policy.

Границы заявлений

PDF/A output — не то же самое, что legal e-invoice packaging.
gPdf не заменяет ваш archival acceptance или validator workflow.
Ваша система отвечает за retention и compliance interpretation.

PDF/A — это выбор profile

Для ordinary archival documents PDF/A выбирается через render settings. Это держит workflow близко к JSON Render: ваша система описывает document и задает нужный profile.

E-invoice packaging — другой workflow. Когда документу нужен Factur-X или ZUGFeRD со встроенным CII XML, используйте E-Invoice Render endpoint.

FAQ

Какой endpoint использовать для общего PDF/A output?: Используйте POST /api/v1/pdf/render с подходящим значением settings.profile для ordinary PDF/A output.
Когда нужен E-Invoice Render?: Используйте E-Invoice Render, когда документ должен быть Factur-X или ZUGFeRD PDF/A-3b package со встроенным CII XML.
Валидирует ли gPdf archival acceptance?: Нет. gPdf рендерит PDF/A output. Ваша система должна валидировать output по archive или customer acceptance policy.
Можно ли совместить PDF/A с security settings?: Не в текущем public Render API. settings.profile и settings.security взаимоисключающие, а invalid combinations не проходят validation.