Arşivlenebilir PDF oluşturma için PDF/A API'si
Arşivlenebilir PDF çıktısı üretmek için gPdf PDF/A ayarları kullanın; PDF/A profil seçimini e-invoice paketleme ile karıştırmayın.
/api/v1/pdf/render Belge saklama veya uyumluluk gereksinimi PDF/A çıktısı istediğinde render isteğinde uygun PDF/A profilini seçmek ve legal e-invoice paketleme gerektiğinde e-invoice yoluna geçmek.
Bu API ne zaman kullanılır
- Oluşturulan PDF'in PDF/A profil ile render edilmesi gerekiyor.
- Arşiv veya uyumluluk iş akışınız çıktıyı referans doğrulayıcı ile kontrol ediyor.
- PDF/A ayarları ile sıradan PDF render işlemi arasındaki sınırı açık tutmak ve PDF/A-3b e-invoice paketleme'den daha geniş bir PDF/A sayfası istiyorsunuz.
- Factur-X/ZUGFeRD gerekip gerekmediğini endpoint seçimiyle ayırmanız gerekiyor.
Neyin yerine geçmez
- PDF/A doğrulama API bekliyorsunuz; current public validator surface /validator/ sayfasıdır.
- Legal e-fatura paketi gerekiyor. E-Invoice Render kullanın.
- Serbest biçimli attachments veya unsupported profils claim etmek istiyorsunuz.
Hangi endpoint çağrılır
/api/v1/pdf/render
JSON Render bu iş akışı için varsayılan yoldur.
/api/v1/e-invoice/render
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
POST /api/v1/pdf/render - PDF/A profil ile render isteği.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive-ready document",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf neyi üstlenir
- JSON Render ayarları üzerinden PDF/A profil çıktı.
- PDF metadata ve render çıktıyı.
- E-Invoice Render kullanıldığında Factur-X/ZUGFeRD PDF/A-3b paketleme yolu.
- Reference-engine doğrulama için renderable PDF yanıtı.
Sisteminiz neyi yönetir
- Neden PDF/A gerektiği, saklama politikası ve denetim kayıtları.
- Business data, legal/compliance acceptance ve doğrulama kanıtı.
- Depolama, erişim kontrolü ve long-term archive operations.
Production kontrol listesi
- Gereken PDF/A profilini seçin ve belgeleyin.
- Çıktıyı /validator/ veya kendi veraPDF pipeline'ınızla doğrulayın.
- PDF/A ve güvenlik ayarları arasındaki public API kısıtlarını kontrol edin.
- Request ID ve profili stored document ile saklayın.
- E-invoice gerekiyorsa /api/v1/e-invoice/render kullanın.
İddia sınırları
- PDF/A render setting'dir; saklama politikası veya hukuki danışmanlık yerine geçmez.
- gPdf archive acceptance veya compliance sertifikasyon kurumu değildir.
- Factur-X / ZUGFeRD paketleme sıradan PDF/A yolu'undan farklıdır.
PDF/A bir profil seçeneğidir
PDF/A, belgenin nasıl render edileceğine dair bir çıktı profilidır. Arşiv veya uyumluluk iş akışınız bu profili isteyebilir, ancak PDF/A tek başına saklama politikası, yasal kabul veya denetim süreci yerine geçmez.
Sıradan PDF/A çıktısı için JSON Render kullanın. Factur-X veya ZUGFeRD PDF/A-3b gibi e-invoice paketleri gerekiyorsa E-Invoice Render kullanın; çünkü gömülü XML ve ilişkili dosya metadata’sı bu yola aittir.
SSS
- gPdf PDF/A çıktısı üretebilir mi?
- Evet. JSON Render desteklenen PDF/A profil ayarları ile çıktı üretebilir.
- PDF/A ile e-invoice aynı mı?
- Hayır. PDF/A bir profildir. Factur-X/ZUGFeRD PDF/A-3b e-invoice için gömülü EN 16931 XML ve e-invoice yolu gerekir.
- PDF/A'yı nasıl doğrularım?
- /validator/ veya kendi referans motoru pipeline'ınızı kullanın.
- PDF/A saklama politikası yerine geçer mi?
- Hayır. gPdf PDF'i render eder; saklama, depolama ve denetim politika sizin sisteminizdedir.