PDF/A-3b her zaman e-invoice mıdır?

Hayır. PDF/A-3b bir arşiv PDF profilidır. Factur-X ve ZUGFeRD e-invoice'ları gömülü EN 16931 XML için sarmalayıcı olarak PDF/A-3b kullanır.

PDF/A-3b hangi endpoint ile oluşturulur?

Sıradan PDF/A-3b için settings.profile ile POST /api/v1/pdf/render kullanın. Çıktı Factur-X veya ZUGFeRD e-invoice olmalıysa POST /api/v1/e-invoice/render kullanın.

Bu sayfa üzerinden serbest biçimli files attach edebilir miyim?

Public API dokümanları bu iş akışı listelemedikçe serbest biçimli attachment desteği varsaymayın. Bu sayfa belgelenmiş PDF/A-3b ve e-invoice kullanımına odaklanır.

PDF/A çıktıyı nasıl doğrularım?

/validator/ veya kendi referans motoru pipeline'ınızı kullanın. E-invoice'larda hem PDF/A katman'ını hem gömülü XML katman'ını doğrulayın.

Uyumluluk ve arşivleme

Arşiv ve e-invoice iş akışları için PDF/A-3b API'si

gPdf ile PDF/A-3b çıktısı üretin ve PDF/A-3b'nin ne zaman yalnızca arşiv profili, ne zaman e-invoice sarmalayıcı olduğunu ayırın.

ANA API JSON Render

ENDPOINT /api/v1/pdf/render

SİSTEMLER compliance backend'i / finans sistemi / hukuki arşiv / denetim iş akışı

Playground’da dene Dokümantasyonu oku

Çözülecek iş

Arşiv iş akışları için PDF/A-3b belgeleri üretmek ve PDF/A-3b gömülü Factur-X veya ZUGFeRD EN 16931 XML taşıması gerektiğinde e-invoice endpoint'ini seçmek.

Bu API ne zaman kullanılır

Render edilmiş belge için PDF/A-3b arşiv profil gerekiyor.
Sıradan PDF/A ile e-invoice paketleme arasındaki sınırı açıklamanız gerekiyor.
Compliance iş akışınız oluşturulan PDFs'i veraPDF veya başka referans motoru ile doğruluyor.
PDF/A-3b search intent'ini doğru endpoint'e yönlendiren public sayfa gerekiyor.

Neyin yerine geçmez

Public API'de belgelenmeyen serbest biçimli file-attachment iş akışları gerekiyor.
JSON Render üzerinden Factur-X veya ZUGFeRD e-invoice istiyorsunuz. E-Invoice Render kullanın.
Validator API gerekiyor. Mevcut public validator surface /validator/ sayfasıdır.

Hangi endpoint çağrılır

ANA

/api/v1/pdf/render

JSON Render bu iş akışı için varsayılan yoldur.

İKİNCİL 1

/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 - render edilmiş belge için PDF/A-3b çıktı isteği.

{
  "settings": {
    "profile": "pdfa-3b"
  },
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Archive copy",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

gPdf neyi üstlenir

JSON Render ayarları üzerinden PDF/A profil selection.
POST /api/v1/e-invoice/render kullanıldığında PDF/A-3b e-invoice paketleme.
Harici referans motoru doğrulama için uygun renderable PDF çıktısı.
Arşiv profil ile legal e-invoice iş akışı arasında açık ayrım.

Sisteminiz neyi yönetir

Saklama politikası ve PDF/A-3b gereksiniminin nedeni.
Business data, XML semantics ve harici compliance kabul kriterleri.
Doğrulama evidence, denetim kayıtları ve render işlemi sonrası long-term depolama.

Production kontrol listesi

Sıradan PDF/A-3b çıktı için JSON Render seçin.
Gömülü EN 16931 XML gerekiyorsa E-Invoice Render seçin.
PDF/A çıktıyı /validator/ veya kendi veraPDF iş akışınızla doğrulayın.
Requested profil ve request ID'yi stored document ile kaydedin.
Public dokümanlar listelemedikçe serbest biçimli attachments desteği claim etmeyin.

İddia sınırları

PDF/A-3b arşiv profildir; e-invoice paketleme bunun üzerinde daha dar bir iş akışıdır.
Her serbest biçimli embedded-file iş akışın desteklendiğini ima etmeyin.
Factur-X ve ZUGFeRD PDF/A-3b paketleri için e-invoice route gereklidir.

PDF/A-3b sarmalayıcı’dır, tüm iş akışı değildir

PDF/A-3b bir PDF arşiv profildir. Hibrit e-invoice’lar için sarmalayıcı görevi görebildiği için önemlidir, ancak profil tek başına bir belgeyi legal e-invoice yapmaz. Sıradan arşiv belgesi, embedded fatura XML’i olmadan PDF/A-3b kullanabilir.

Factur-X ve ZUGFeRD için POST /api/v1/e-invoice/render kullanın. Bu endpoint e-invoice’a özgü metadata ve ilişkili dosya bağlamasından sorumludur.

Endpoint’i niyete göre seçin

Amacınız “bu belgeyi PDF/A-3b olarak render et” ise JSON Render kullanın. Amacınız “bu faturayı EN 16931 CII XML ile Factur-X veya ZUGFeRD olarak paketle” ise E-Invoice Render kullanın. Bu ayrım kodu açık tutar ve sıradan arşiv jobs içine yanlışlıkla e-invoice varsayımları taşınmasını önler.

Dışarıda doğrulayın

PDF/A bir marketing iddiası ile değil referans motoru ile doğrulanmalıdır. Public validator veya kendi doğrulama pipeline’ınızı kullanın ve raporu denetim kanıtı ile saklayın.

SSS

PDF/A-3b her zaman e-invoice mıdır?: Hayır. PDF/A-3b bir arşiv PDF profilidır. Factur-X ve ZUGFeRD e-invoice'ları gömülü EN 16931 XML için sarmalayıcı olarak PDF/A-3b kullanır.
PDF/A-3b hangi endpoint ile oluşturulur?: Sıradan PDF/A-3b için settings.profile ile POST /api/v1/pdf/render kullanın. Çıktı Factur-X veya ZUGFeRD e-invoice olmalıysa POST /api/v1/e-invoice/render kullanın.
Bu sayfa üzerinden serbest biçimli files attach edebilir miyim?: Public API dokümanları bu iş akışı listelemedikçe serbest biçimli attachment desteği varsaymayın. Bu sayfa belgelenmiş PDF/A-3b ve e-invoice kullanımına odaklanır.
PDF/A çıktıyı nasıl doğrularım?: /validator/ veya kendi referans motoru pipeline'ınızı kullanın. E-invoice'larda hem PDF/A katman'ını hem gömülü XML katman'ını doğrulayın.