PDF за шаблоном: API для production-систем
Генерація PDF за шаблоном зі структурованих backend-даних без браузера: gPdf відповідає за PDF-рендеринг, бізнес-правила залишаються у вашій системі.
/api/v1/template-render Генерація PDF за шаблоном як відтворюваного PDF зі структурованих даних. gPdf створює документ; ваша система відповідає за зміст даних і стан процесу.
Коли використовувати цю API
- Backend уже містить дані для PDF за шаблоном і потрібна стабільна PDF-відповідь.
- Потрібно уникнути Chromium або HTML-to-PDF в операційному документі.
- Потрібен повторюваний результат для передруку, аудиту або пакетної обробки.
Що вона не замінює
- gPdf не купує доставку, не подає податки, не створює зовнішні замовлення і не є фіскальною системою.
- gPdf не замінює бізнес-логіку, перевірку даних та інтеграції з marketplace.
Який endpoint викликати
/api/v1/template-render
Template Render — типовий шлях для цього сценарію.
/api/v1/pdf/render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний request
/api/v1/template-render - PDF за шаблоном
{
"template_id": "invoice",
"data": [
{
"invoice_number": "INV-2026-001",
"date_of_issue": "2026-05-29",
"date_due": "2026-06-28",
"issuer_name": "Acme Cloud Inc.",
"issuer_address": "88 Harbor Rd, Long Beach, CA",
"bill_to_name": "Receiver Inc.",
"bill_to_address": "123 Main St, Los Angeles, CA",
"subtotal": "$100.00",
"total": "$100.00",
"amount_due": "$100.00",
"items": [
{
"description": "Service A",
"qty": 1,
"unit_price": "$100.00",
"amount": "$100.00"
}
]
}
]
}
Що виконує gPdf
- PDF-рендеринг для PDF за шаблоном зі структурованого request.
- Текст, таблиці, лінії, штрихкоди, сторінки, метадані та параметри виводу згідно з request.
- Детермінований вивід для retries, передруку й аудиту.
Що контролює ваша система
- Коректні дані для PDF за шаблоном, бізнес-правила і стан операції.
- Автентифікація, зберігання, зовнішні workflow і приймальні перевірки.
Production checklist
- Перевірте на реальних даних і в системах, які прийматимуть PDF.
- Зберігайте request ID і докази перевірки для підтримки, аудиту та передруку.
- Переведіть затверджений layout у template, якщо ним користуються кілька систем.
Межі заявлених можливостей
- gPdf рендерить PDF із request; він не замінює workflow продукту, базу даних або бізнес-валідацію.
- Ваша система відповідає за семантику даних, retries, зберігання і фінальне приймання.
Форма API
API: PDF за шаблоном — production workflow на публічних API gPdf. Request описує дані, layout, settings і PDF-частини для рендерингу. gPdf створює PDF, а ваша система зберігає зміст бізнес-події.
Вибір endpoint
Для цього сценарію endpoint за замовчуванням — /api/v1/template-render. Template Render використовуйте після затвердження layout. E-Invoice Render використовуйте лише для Factur-X / ZUGFeRD PDF/A-3b із вбудованим EN 16931 CII XML.
Перевірка перед production
Перевіряйте PDF за шаблоном на реальних даних і в downstream-системах. Зберігайте request ID, PDF і результати перевірок для підтримки, аудиту та передруку.
FAQ
- Це окремий endpoint?
- API: PDF за шаблоном зіставляє сценарій з публічною API gPdf. Сторінка пояснює, який шлях викликати і що має містити request.
- Можна використовувати templates?
- Так. JSON Render підходить, поки layout змінюється; Template Render — коли layout затверджено і callers надсилають лише бізнес-дані.
- Що перевірити перед production?
- Перевіряйте реальні дані й downstream-системи: принтери, сканери, валідатори, бухгалтерію або marketplace.