Compliance en archivering

PDF/A-3b API voor archivering en E-Invoice-processen

Genereer PDF/A-3b-output met gPdf en bepaal wanneer PDF/A-3b alleen een archiefprofiel is en wanneer het een E-Invoice-wrapper is.

PRIMAIRE API JSON Render
ENDPOINT /api/v1/pdf/render
SYSTEMEN nalevingsbackend / financieel systeem / juridisch archief / auditproces
Taak om op te lossen

Genereer PDF/A-3b-documenten voor archiveringsprocessen en kies het E-Invoice-endpoint wanneer PDF/A-3b ingebedde Factur-X- of ZUGFeRD-EN 16931 XML moet dragen.

Wanneer deze API past

  • U hebt een PDF/A-3b-archiefprofiel nodig voor een gerenderd document.
  • U moet de grens tussen gewone PDF/A en E-Invoice-packaging uitleggen.
  • Uw nalevingsproces controleert gegenereerde PDF's met veraPDF of een andere referentie-engine.
  • U hebt een publieke pagina nodig die PDF/A-3b-zoekintentie naar het juiste endpoint leidt.

Wat dit niet vervangt

  • U hebt willekeurige processen voor bestandsbijlagen nodig die niet in de publieke API zijn gedocumenteerd.
  • U hebt Factur-X- of ZUGFeRD-e-invoices via JSON Render nodig. Gebruik E-Invoice Render.
  • U hebt een validator-API nodig. Het huidige publieke validatoroppervlak is de /validator/-pagina.

Welk endpoint aanroepen

PRIMAIR

/api/v1/pdf/render

JSON Render is het standaardpad voor deze workflow.

SECUNDAIR 1

/api/v1/e-invoice/render

Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.

Minimale request

POST /api/v1/pdf/render - vraag PDF/A-3b-output aan voor een gerenderd document.

{
  "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" }
        }
      ]
    }
  ]
}

Wat gPdf afhandelt

  • PDF/A-profielkeuze via JSON Render-instellingen.
  • PDF/A-3b-E-Invoice-packaging bij gebruik van POST /api/v1/e-invoice/render.
  • Renderbare PDF-output die geschikt is voor controle door externe referentie-engines.
  • Duidelijke scheiding tussen archiefprofiel en juridisch E-Invoice-proces.

Wat uw systeem beheert

  • Het bewaarbeleid en de reden waarom PDF/A-3b vereist is.
  • Bedrijfsdata, XML-semantiek en externe acceptatiecriteria voor naleving.
  • Controlebewijs, auditrecords en langetermijnopslag na rendering.

Productiechecklist

  1. Kies JSON Render voor gewone PDF/A-3b-output.
  2. Kies E-Invoice Render wanneer ingebedde EN 16931 XML vereist is.
  3. Controleer PDF/A-output met /validator/ of uw eigen veraPDF-proces.
  4. Registreer het gevraagde profiel en request-ID bij het opgeslagen document.
  5. Claim geen ondersteuning voor willekeurige bijlagen tenzij de publieke documentatie die noemt.

Grenzen van de claim

  • PDF/A-3b is een archiefprofiel; E-Invoice-packaging is een smaller proces bovenop dat profiel.
  • Implicieer niet dat elk willekeurig proces met ingebedde bestanden wordt ondersteund.
  • De E-Invoice-route is vereist voor Factur-X- en ZUGFeRD-PDF/A-3b-pakketten.

PDF/A-3b is de wrapper, niet het hele proces

PDF/A-3b is een PDF-archiefprofiel. Het is belangrijk omdat het als wrapper voor hybride e-invoices kan dienen, maar het profiel alleen maakt een document nog geen juridische E-Invoice. Een gewoon gearchiveerd document kan PDF/A-3b gebruiken zonder ingebedde factuur-XML.

Gebruik voor Factur-X en ZUGFeRD POST /api/v1/e-invoice/render. Dat endpoint is verantwoordelijk voor E-Invoice-specifieke metadata en koppeling van het bijbehorende bestand.

Kies het endpoint op basis van intentie

Gebruik JSON Render wanneer uw doel is: “render dit document als PDF/A-3b”. Gebruik E-Invoice Render wanneer uw doel is: “verpak deze factuur als Factur-X of ZUGFeRD met EN 16931 CII XML”. Dat onderscheid houdt code duidelijk en voorkomt dat gewone archiveringstaken onbedoeld E-Invoice-aannames meenemen.

Controleer extern

PDF/A moet worden gecontroleerd met een referentie-engine, niet met een marketingclaim. Gebruik de publieke validator of uw eigen controlepipeline en bewaar het rapport bij uw auditbewijs.

FAQ

Is PDF/A-3b altijd een E-Invoice?
Nee. PDF/A-3b is een PDF-archiefprofiel. Factur-X- en ZUGFeRD-e-invoices gebruiken PDF/A-3b als wrapper voor ingebedde EN 16931 XML.
Welk endpoint maakt PDF/A-3b?
Gebruik POST /api/v1/pdf/render met settings.profile voor gewone PDF/A-3b. Gebruik POST /api/v1/e-invoice/render wanneer de output een Factur-X- of ZUGFeRD-e-invoice moet zijn.
Kan ik via deze pagina willekeurige bestanden koppelen?
Ga niet uit van ondersteuning voor willekeurige bijlagen tenzij de publieke API-documentatie dat proces vermeldt. Deze pagina richt zich op gedocumenteerd PDF/A-3b- en E-Invoice-gebruik.
Hoe controleer ik PDF/A-output?
Gebruik /validator/ of uw eigen pipeline met referentie-engines. Controleer voor e-invoices zowel de PDF/A-laag als de ingebedde XML-laag.