Hibrit PDF/A-3b e-invoice'lar için Factur-X API'si
Çağıran sistemin sağladığı EN 16931 CII XML ile hibrit PDF/A-3b e-invoice üretmek 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 insan tarafından okunabilir PDF/A-3b fatura içine gömerek doğrulanabilir Factur-X e-fatura paketi üretmek.
Bu API ne zaman kullanılır
- Receiver veya iş akışı Factur-X paketlemesi istiyor.
- Sisteminiz EN 16931 CII XML'i doğru şekilde üretiyor.
- PDF/A-3b sarmalayıcı, ilişkili dosya metadata'sı ve Factur-X 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 semantiği, vergi kuralları veya alıcı/satıcı tanımlayıcıları üretmesini bekliyorsunuz.
- OpenAPI listelemeden başka bir 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 - Factur-X fatura paketi.
{
"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
- POST /api/v1/e-invoice/render üzerinden Factur-X PDF/A-3b paketleme.
- Çağıran sistemin sağladığı EN 16931 CII XML'i ilişkili dosya olarak gömme.
- Factur-X 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.
- Factur-X'in alıcı iş akışı için uygun olduğunu doğrulamak.
- Receiver, AP automation veya uyumluluk sistemi ile kabul testi.
Production kontrol listesi
- Capabilities endpoint ile Factur-X 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.
Factur-X bir e-invoice paketleme iş akışıdır
Factur-X çıktısı yalnızca görünen fatura PDF’i değildir. PDF/A-3b sarmalayıcı, ilişkili dosya metadata’sı, Factur-X XMP ve çağıran sistemin sağladığı EN 16931 CII XML birlikte üretilmelidir.
Bu nedenle Factur-X için POST /api/v1/e-invoice/render kullanılır. Sıradan fatura PDF’leri JSON Render veya Template Render ile üretilebilir; legal e-fatura paketi gerektiğinde e-invoice render yolune geçin.
SSS
- Factur-X API ayrı bir ürün mü?
- Hayır. 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.
- 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.
- Factur-X 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.
- Factur-X çı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.