PDF/A-3b hibrit faturalar için ZUGFeRD API'si
EN 16931 CII XML içeren PDF/A-3b hibrit faturalar için gPdf'in public e-invoice render yolunu kullanın.
/api/v1/e-invoice/render Çağıran sistemin sağladığı EN 16931 CII XML'i okunabilir PDF/A-3b fatura içine gömerek doğrulanabilir ZUGFeRD e-fatura paketi üretmek.
Bu API ne zaman kullanılır
- Receiver veya iş akışı ZUGFeRD package istiyor.
- Sisteminiz doğru EN 16931 CII XML üretiyor.
- PDF/A-3b sarmalayıcı, ilişkili dosya metadata'sı ve ZUGFeRD XMP bağlaması gerekiyor.
- OpenAPI ve capabilities endpoint'i ile public sözleşmeyi doğrulamak istiyorsunuz.
Neyin yerine geçmez
- Yalnızca sıradan fatura PDF'i istiyorsunuz. JSON Render veya Template Render kullanın.
- gPdf'in fatura XML'i, vergi semantiği veya alıcı/satıcı tanımlayıcıları üretmesini bekliyorsunuz.
- OpenAPI listelemeden başka ulusal e-invoice formatı istiyorsunuz.
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
POST /api/v1/e-invoice/render - ZUGFeRD fatura paketi.
{
"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
- POST /api/v1/e-invoice/render üzerinden ZUGFeRD PDF/A-3b paketleme.
- Çağıran sistemin sağladığı EN 16931 CII XML'i ilişkili dosya olarak gömme.
- ZUGFeRD metadata ve XMP bağlaması.
- Yetenek keşfi için /api/v1/e-invoice/capabilities.
Sisteminiz neyi yönetir
- XML iş doğruluğu, vergi semantiği, fatura numaralandırması ve ticari taraf verisi.
- ZUGFeRD'in alıcı iş akışı için uygun olduğunu doğrulamak.
- Receiver, AP automation veya uyumluluk sistemi ile kabul testleri.
Production kontrol listesi
- Capabilities endpoint ile ZUGFeRD profilini doğrulayın.
- XML'i gömmeden önce önceki sistemde doğrulayın.
- Çıktıyı veraPDF, Mustang veya kendi referans doğrulama hattınızla test edin.
- Request ID, profil, XML version ve doğrulama kanıtı kaydedin.
- Sıradan PDF oluşturma ile e-invoice paketleme kodunu ayrı tutun.
İddia sınırları
- gPdf Factur-X / ZUGFeRD PDF/A-3b için public e-invoice endpoint kullanır.
- gPdf XML iş doğruluğu üretmez veya garanti etmez.
- OpenAPI listelemedikçe başka ulusal e-invoice çıktılarını native destek gibi sunmayın.
ZUGFeRD e-invoice render yolu kullanır
ZUGFeRD çıktısı, okunabilir PDF ile gömülü EN 16931 CII XML’i PDF/A-3b sarmalayıcı içinde birleştirir. Bu yüzden sıradan JSON Render isteği değil, e-invoice render yolu kullanılmalıdır.
Sisteminiz XML semantics’i ve iş doğruluğunu üretir. gPdf ilişkili dosya metadata’sı, XMP bağlaması ve PDF/A-3b paketlemeyi uygular.
SSS
- ZUGFeRD API ayrı bir ürün mü?
- Hayır. 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.
- gPdf vergi portalına gönderim yapar mı?
- Hayır. gPdf PDF/e-invoice dosyasını render edip paketler; vergi portalları ve yasal yönlendirme sisteminizde kalır.
- ZUGFeRD için JSON Render kullanabilir miyim?
- Normal PDF'ler için evet. Yapılandırılmış e-fatura paketi gerekiyorsa E-Invoice Render kullanın.
- ZUGFeRD çıktısını nasıl doğrulamalıyım?
- PDF/A katman'ını ve gömülü EN 16931 XML katman'ını referans motoru'lerle doğrulayın.