Production sistemleri için Factur-X faturaları API
Factur-X 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 Factur-X 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 Factur-X 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 - Factur-X faturaları
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"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": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf neyi üstlenir
- Yapılandırılmış request üzerinden Factur-X 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
- Factur-X 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
Factur-X 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
Factur-X 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?
- Factur-X 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.