Skip to content

Modèle de document · generic.customer.incident_report

Customer Incident Report

  • Rendu vérifié
  • Commercial
  • Version 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

Champs de ce modèle

Les données envoyées à l'API sont validées par le schéma JSON du modèle avant tout rendu. Ce modèle définit 26 champs :

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

POST /render

Générez-le

Un seul appel POST /render : envoyez votre JSON, recevez le PDF final. Ou passez-vous du JSON et décrivez le document en langage naturel sur 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": "fr"}
  }' -o incident-report.pdf

Questions fréquentes

Qu'est-ce qu'un « 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. Sur papii, ce document est disponible sous forme du modèle generic.customer.incident_report : un schéma JSON associé à un rendu PDF déterministe — les mêmes données produisent toujours le même document.

Puis-je générer un « Customer Incident Report » avec l'IA ?

Oui. chut.app — le back-office IA propulsé par papii — remplit ce modèle à partir d'une description en langage naturel : vous décrivez le document en une phrase, l'IA structure les données, papii les valide contre le schéma et génère le PDF. Les développeurs peuvent aussi appeler directement l'API papii avec du JSON structuré.

Le modèle « Customer Incident Report » est-il conforme juridiquement ?

Ce modèle est au rendu vérifié : son schéma, ses données d'exemple et sa sortie PDF sont testés automatiquement à chaque version. Il est publié avec le statut « ready », ce qui signifie qu'il n'a pas encore passé la revue juridique finale de papii. Lorsqu'il fait référence à une législation précise, celle-ci est indiquée dans la description du modèle — faites toujours vérifier par un professionnel les documents à portée juridique avant de vous y fier.