Skip to main content

Finalisation d’un signalement

Cette API permet à un utilisateur du backoffice de finaliser un signalement après la fin des actions de traitement.

La finalisation marque la fin du cycle opérationnel du signalement.

Lorsqu’un signalement est finalisé :

  • le statut passe à FINALIZATION
  • l’état de finalisation passe à COMPLETED
  • la date de finalisation est enregistrée
  • l’utilisateur ayant finalisé le signalement est enregistré
  • un délai de finalisation (finalization_delay) est calculé
  • un historique de traitement est généré
  • les systèmes liés sont synchronisés

Endpoint : POST /reports/{reportUniqId}/finalize

Authentification : Bearer Token

Headers requis

Authorization: Bearer <access_token>
Content-Type: application/json
Accept: application/json

Paramètres de requête :

ChampTypeRequisDescription
reportUniqIdstringOuiIdentifiant unique du signalement
commentstringNonCommentaire de finalisation

Requête :

curl -X POST "https://clients-api-services.mazone-test.ansut.ci/api/v1.0/reports/ZOB69FCAEC983556/finalize" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "comment": "Le signalement a été traité et finalisé avec succès."
  }'

Réponse succès (200) :

{
  "error": false,
  "message": "Successfully",
  "data": {
    "id": "ZOB69FCAEC983556"
  }
}

Signalement inexistant (400) :

{
  "error": true,
  "statusCode": 400,
  "message": "Le type de traitement n'existe pas."
}

Signalement finalisé (400):

{
  "error": true,
  "statusCode": 400,
  "message": "Le signalement a déjà été traité."
}

Comportement métier

  • Lors de la finalisation d’un signalement :
  • Recherche du signalement via uniq_id
  • Vérification de l’existence du signalement
  • Vérification que le signalement n’est pas déjà finalisé
  • Calcul du délai de finalisation (finalization_delay)
  • Mise à jour :
  • finalized_at
  • finalized_by
  • status = FINALIZATION
  • state = COMPLETED
  • finalization_state = COMPLETED
  • finalized_comment
  • Création d’un historique de finalisation (FINALYSE)
  • Envoi des logs système
  • Synchronisation avec la demande liée (RequestReport)