Bu ayrı bir endpoint mi?

PDF makbuzlar API, workflow’u gPdf’in public API’lerinden birine bağlar. Sayfa hangi path’in çağrılacağını ve request’in neyi taşıyacağını açıklar.

Templates kullanabilir miyim?

Evet. Layout değişirken JSON Render, layout onaylandıktan ve callers yalnızca iş verisi gönderdikten sonra Template Render kullanın.

Production öncesi neyi doğrulamalıyım?

Gerçek veriyle ve workflow’daki yazıcı, scanner, validator, muhasebe sistemi veya marketplace ile doğrulayın.

Invoicing and finance

Production sistemleri için PDF makbuzlar API

PDF makbuzlar çıktısını yapılandırılmış backend verilerinden tarayıcı olmadan üretin; gPdf PDF rendering’i üstlenir, iş kuralları sisteminizde kalır.

ANA API JSON Render

ENDPOINT /api/v1/pdf/render

SİSTEMLER operasyon backend’i / finans sistemi / compliance workflow / doküman servisi

Playground’da dene → Dokümantasyonu oku

Çözülecek iş

PDF makbuzlar çıktısını yapılandırılmış veriden tekrarlanabilir PDF olarak üretmek. gPdf PDF’i render eder; veri anlamı ve süreç durumu sisteminizde kalır.

Bu API ne zaman kullanılır

Backend’inizde PDF makbuzlar verisi zaten var ve kararlı bir PDF yanıtı gerekiyor.
Operasyon belgesi için Chromium veya HTML-to-PDF kullanmak istemiyorsunuz.
Reprint, audit veya batch için tekrarlanabilir çıktı gerekiyor.

Neyin yerine geçmez

gPdf kargo satın almaz, vergi beyan etmez, dış sipariş oluşturmaz ve mali sistem değildir.
Veri doğrulama, iş kuralları veya marketplace entegrasyonlarının yerine geçmez.

Hangi endpoint çağrılır

ANA

/api/v1/pdf/render

JSON Render bu iş akışı için varsayılan yoldur.

İKİNCİL 1

/api/v1/template-render

İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.

Minimum request

/api/v1/pdf/render - PDF makbuzlar

{
  "pages": [
    {
      "size": "a6",
      "elements": [
        {
          "type": "text",
          "x": 10,
          "y": 12,
          "content": "Receipt R-2026-1001",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 10,
          "y": 28,
          "content": "Order total: $82.40\nPaid by card ending 4242\nTax: $6.10",
          "style": { "font_size": 10, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "qrcode",
          "content": "https://example.com/receipts/R-2026-1001",
          "x": 10,
          "y": 58,
          "width": 28,
          "height": 28
        }
      ]
    }
  ]
}

gPdf neyi üstlenir

Yapılandırılmış request üzerinden PDF makbuzlar için PDF rendering.
Request’e göre metin, tablo, çizgi, barkod, sayfa, metadata ve çıktı ayarları.
Retry, reprint ve audit için deterministik çıktı.

Sisteminiz neyi yönetir

PDF makbuzlar için doğru veri, iş kuralları ve operasyon durumu.
Kimlik doğrulama, kalıcı kayıt, dış workflow ve alıcı sistem doğrulamaları.

Production checklist

Gerçek veri ve PDF’i tüketecek sistemlerle test edin.
Support, audit ve reprint için request ID ve doğrulama kanıtlarını saklayın.
Onaylı layout birden fazla sistemde kullanılacaksa template’e taşıyın.

İddia sınırları

gPdf request’ten PDF render eder; ürün workflow’u, database veya business validation yerine geçmez.
Data semantics, retries, storage ve final acceptance sisteminizdedir.

API şekli

PDF makbuzlar API, gPdf public API’leri üzerinde çalışan bir production workflow’dur. Request veriyi, layout’u, settings’i ve render edilecek PDF parçalarını açıkça tarif eder. gPdf PDF’i üretir; iş olayının semantiği sisteminizde kalır.

Endpoint seçimi

Bu workflow için varsayılan endpoint /api/v1/pdf/render. Layout onaylandıktan sonra Template Render kullanın. E-Invoice Render yalnızca EN 16931 CII XML gömülü Factur-X / ZUGFeRD PDF/A-3b paketleme gerektiğinde kullanılır.

Production öncesi doğrulama

PDF makbuzlar çıktısını gerçek veriyle ve downstream sistemlerle doğrulayın. Support, audit ve reprint için request ID, render edilen çıktı ve doğrulama kanıtlarını saklayın.

FAQ

Bu ayrı bir endpoint mi?: PDF makbuzlar API, workflow’u gPdf’in public API’lerinden birine bağlar. Sayfa hangi path’in çağrılacağını ve request’in neyi taşıyacağını açıklar.
Templates kullanabilir miyim?: Evet. Layout değişirken JSON Render, layout onaylandıktan ve callers yalnızca iş verisi gönderdikten sonra Template Render kullanın.
Production öncesi neyi doğrulamalıyım?: Gerçek veriyle ve workflow’daki yazıcı, scanner, validator, muhasebe sistemi veya marketplace ile doğrulayın.