Skip to content

Documentsjabloon · generic.customer.incident_report

Customer Incident Report

  • Rendering geverifieerd
  • Commercieel
  • Versie 1.0.0

Customer-facing incident / post-mortem report delivered by a vendor to an affected customer. Distinct from internal security-incident documentation: this is the communication the customer receives with incident identification, severity, detection/resolution timestamps, customer-visible impact, root cause, event-level timeline, corrective and preventive actions, and any service credits. Format follows the ICS / ITIL v4 post-incident review vocabulary.

JSON Schema

Velden in dit sjabloon

Data die naar de API wordt gestuurd, wordt gevalideerd tegen het JSON-schema van het sjabloon vóór er iets wordt gerenderd. Dit sjabloon definieert 26 velden:

Veld Verplicht Type Beschrijving
vendor Verplicht object
vendor.name Verplicht string
vendor.address Verplicht string
vendor.contact_email Verplicht string
customer Verplicht object
customer.name Verplicht string
customer.account_id Verplicht string
incident_id Verplicht string
severity Verplicht enum
detected_on Verplicht string
resolved_on Verplicht string
duration Verplicht string Human-readable duration, e.g. '3h 52m'.
impact_on_customer Verplicht string Plain-language description of what the customer actually experienced.
root_cause Verplicht string Prose RCA (what happened, why it happened, contributing factors).
timeline Verplicht array of object
timeline[].timestamp Verplicht string
timeline[].event Verplicht string
corrective_actions Verplicht array of string
preventive_actions Verplicht array of string
service_credits_optional Optioneel object
service_credits_optional.amount Verplicht number
service_credits_optional.currency Verplicht string
signatory Verplicht object
signatory.name Verplicht string
signatory.title Verplicht string
signatory.date Verplicht date

POST /render

Genereer het

Eén POST /render-oproep: stuur je JSON, ontvang de afgewerkte PDF. Of sla de JSON over en beschrijf het document in gewone taal op chut.app.

curl
curl -X POST https://api.papii.eu/render \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "generic.customer.incident_report",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o incident-report.pdf

Veelgestelde vragen

Wat is een “Customer Incident Report”?

Customer-facing incident / post-mortem report delivered by a vendor to an affected customer. Distinct from internal security-incident documentation: this is the communication the customer receives with incident identification, severity, detection/resolution timestamps, customer-visible impact, root cause, event-level timeline, corrective and preventive actions, and any service credits. Format follows the ICS / ITIL v4 post-incident review vocabulary. Op papii is dit document beschikbaar als sjabloon generic.customer.incident_report: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Customer Incident Report” genereren met AI?

Ja. chut.app — de AI-backoffice aangedreven door papii — vult dit sjabloon in op basis van een beschrijving in gewone taal: jij beschrijft het document in één zin, de AI structureert de data, papii valideert die tegen het schema en rendert de PDF. Ontwikkelaars kunnen de papii-API ook rechtstreeks aanroepen met gestructureerde JSON.

Is het sjabloon “Customer Incident Report” juridisch conform?

Dit sjabloon heeft een geverifieerde rendering: het schema, de voorbeelddata en de PDF-uitvoer worden bij elke release automatisch getest. Het is gepubliceerd met status “ready”, wat betekent dat het de finale juridische review van papii nog niet heeft doorlopen. Waar het naar specifieke wetgeving verwijst, staat dat vermeld in de sjabloonbeschrijving — laat documenten met juridische gevolgen altijd door een professional nakijken voor je erop vertrouwt.