API Escalade des Plaintes

Endpoint pour l'escalade manuelle des plaintes.

Endpoint

Methode	Endpoint	Description
POST	/api/plaintes/{id}/escalader	Escalader une plainte

---

Escalader une plainte

POST /api/plaintes/{id}/escalader

Corps de requete

{
  "motif": "Plainte complexe necessitant decision managériale. Le plaignant conteste les criteres de ciblage utilises."
}

Champs

Champ	Type	Obligatoire	Description
motif	string	Oui	Raison de l'escalade (min 20 caracteres)

Exemple

curl -X POST "https://sig.ucp-pch.org/api/plaintes/550e8400-e29b-41d4-a716-446655440000/escalader" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"motif": "Plainte complexe necessitant decision managériale."}'

Reponse

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "niveauEscalade": 1,
    "niveauPrecedent": 0,
    "dateEscalade": "2026-03-15T14:30:00+00:00",
    "escaladePar": {
      "id": 1,
      "nom": "M. Mendes"
    },
    "motif": "Plainte complexe necessitant decision managériale."
  }
}

---

Niveaux d'escalade

Les plaintes peuvent etre escaladees jusqu'a 5 niveaux :

Niveau	Code	Description
0	Initial	Traitement par l'agent assigne
1	Senior	Agent senior ou chef d'equipe
2	Superviseur	Superviseur regional
3	Coordinateur	Coordinateur national
4	Direction	Direction du programme

Niveaux configurables par phase

Depuis la version recente, les niveaux d'escalade sont configurables par phase du workflow. Chaque phase peut avoir ses propres niveaux avec :

• Delai avant escalade (heures)
• Role responsable
• Couleur d'affichage
• Notifications (email/SMS)

Consultez la section Escalade des Plaintes du guide utilisateur pour plus de details sur la configuration.

---

Contraintes

Qui peut escalader ?

• L'agent assigne a la plainte
• Un superviseur de l'equipe
• Un administrateur

Plaintes escaladables

Une plainte peut etre escaladee si :

• Elle n'est pas cloturee (statut != fermee)
• Elle n'est pas deja au niveau maximum
• Le niveau suivant est configure pour la phase actuelle

Motif obligatoire

Le motif doit :

• Contenir au minimum 20 caracteres
• Expliquer clairement la raison de l'escalade
• Etre conserve dans l'historique

---

Historique

Chaque escalade est enregistree dans l'historique de la plainte :

{
  "type": "escalade",
  "date": "2026-03-15T14:30:00+00:00",
  "utilisateur": "M. Mendes",
  "details": {
    "niveauPrecedent": 0,
    "nouveauNiveau": 1,
    "motif": "Plainte complexe necessitant decision managériale."
  }
}

---

Notifications

Lors d'une escalade, le systeme envoie des notifications selon la configuration du niveau :

Destinataire	Email	SMS
Responsable du nouveau niveau	Configurable	Configurable
Agent precedent	Toujours	Non
Superviseur	Si configure	Si configure

Exemple d'email d'escalade

ESCALADE - Plainte PLT-2026-00123

Une plainte a ete escaladee vers vous.

Reference: PLT-2026-00123
Niveau: 1 (Senior)
Escalade par: M. Mendes
Motif: Plainte complexe necessitant decision managériale.

Details:
- Categorie: Paiement
- Priorite: Haute
- Plaignant: Mamadou Diallo
- Date de creation: 10/03/2026

[Voir la plainte]

---

Codes d'erreur

Code	Description
400	Requete invalide (motif trop court)
401	Non authentifie
403	Permission refusee (pas assigne ou superviseur)
404	Plainte non trouvee
409	Plainte deja au niveau max ou fermee
422	Motif invalide

Permissions

Action	Condition
Escalader	Agent assigne, superviseur ou admin
Configurer les niveaux	admin.settings