Production sistemleri için ZUGFeRD faturaları API
ZUGFeRD faturaları çıktısını yapılandırılmış backend verilerinden tarayıcı olmadan üretin; gPdf PDF rendering’i üstlenir, iş kuralları sisteminizde kalır.
/api/v1/e-invoice/render ZUGFeRD faturaları çı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 ZUGFeRD faturaları 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
/api/v1/e-invoice/render
E-Invoice Render bu iş akışı için varsayılan yoldur.
/api/v1/e-invoice/capabilities
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
/api/v1/e-invoice/render - ZUGFeRD faturaları
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "zugferd",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "ZUGFeRD invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf neyi üstlenir
- Yapılandırılmış request üzerinden ZUGFeRD faturaları 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
- ZUGFeRD faturaları 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 Factur-X / ZUGFeRD PDF/A-3b için public e-invoice endpoint kullanır.
- Vergi portalları, PDP, SDI, KSeF, ZATCA, IRP, Peppol ve yasal yükümlülükler scope dışıdır.
- Buyer data, vergi mantığı, routing ve yerel hukuk yorumu sisteminizdedir.
API şekli
ZUGFeRD faturaları 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/e-invoice/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
ZUGFeRD faturaları çı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?
- ZUGFeRD faturaları API, Factur-X / ZUGFeRD PDF/A-3b gerektiğinde public e-invoice endpoint kullanır. Ayrı bir ürün yüzeyi değildir.
- Yerel clearance ağlarını kapsar mı?
- Hayır. gPdf PDF/e-invoice dosyasını render edip paketler; vergi portalları ve yasal routing sisteminizde kalır.
- JSON Render kullanmaya devam edebilir miyim?
- Normal PDF’ler için evet. Yapılandırılmış e-invoice paketi gerekiyorsa E-Invoice Render kullanın.