Esup-SGC utilise l'API CROUS pour synchroniser/pousser les comptes (RightHolder) et cartes associées.
Pour ce faire, esup-sgc est donc client de l'API CROUS et peut récupérer des erreurs remontées par l'API CROUS.
Il est à noter que l'API CROUS appelle elle-même de manière synchronisée un Web Service IZLY : les erreurs qui sont remontées parl 'API CROUS peuvent donc elles-mêmes correspondre directement à des erreurs de l'API IZLY.
esup-sgc enregistre en base et présente au travers de son IHM les éventuelles erreurs rencontrées lors de la synchronisation de l'ayant droit (RightHolder) et ou de la carte.
Certaines erreurs sont considérées par esup-sgc comme bloquantes, esup-sgc avorte alors l'action en cours (acivation de la carte, ou encore désactivation), d'autres (normalement la plupart) sont considérées comme non bloquantes et esup-sgc enregistre simplement cette erreur en base pour que le gestionnaire puisse constater que la synhcronisation de l'ayant droit / carte côté crous ne peut pas avoir lieu.
esup-sgc permet aussi de patcher l'identifiant d'un ayant droit : celà permet notamment de fusionner 2 comptes d'un même ayant droit avec des identifiants différents.
Cette page tente de lister et expliquer chaque erreur possible que peut rencontrer esup-sgc ; en cours d'élaboration, à corriger/revoir au fil de l'eau.
Type d'erreur | Code | Message | Bloquant | Description |
---|---|---|---|---|
Ayant droit | -117 | Client Anonymisé | Non | Le compte est clôturé côté CROUS/IZLY à la demande de l'usager (RGPD). |
Carte | 404 | Ayant droit inconnu | Non | Le compte est bien créé côté CROUS, mais lorsque la carte est envoyée l'ayant droit n'est finalement pas récupéré : pb de synchronisation CROUS/IZLY ? |
Ayant droit | -40 | Requête erronée | Oui | La requête est vue comme erronnée par IZLY : pb côté IZLY. |
Carte | -9 | Support en opposition | Non | La carte a été mise intentionnellement en opposition côté CROUS. |
Carte | 404 | Unknown RightHolder | Non | Le détenteur de la carte n'est pas ou plus connu (RGPD, cloture du compte d'ayant droit côté IZLY), si l'action avait pour objet de désactiver la carte, ce n'est pas bloquant. |
Ayant droit | non_unique | Account already exist | Oui | Un compte ayant doit avec cet identifiant existe déjà côté CROUS/IZLY ; il ne peut pas être récupéré / utilisé par esup-sgc car ce dernier ne dispose pas des droits nécessaires pour ce faire car :
|
Ayant droit | 423 | Account is closed | Non | Le compte est clôturé côté CROUS/IZLY à la demande de l'usager ou après un certain temps d'inactivité (RGPD) ou par un gestionnaire. |
Carte | -31 | Support déjà associé | Non | Une carte avec les mêmes identifiants est déjà connu du système : dans un usage normal la seule explication est que la carte a été archivée côté crous/izly : si le détenteur est désactivée un certain temps, sa carte se voit archivée. |
Carte | 404 | Unknown Card | Non | Peut arriver quand on tente de désactiver une carte qui n'avait pas été (pu être) activée côté CROUS/IZLY. |
Carte | -8 | Date de fin de validité de la carte dépassée | Non | Peut arriver quand on tente de désactiver une carte dont la date de vailidité est dépassée (date de validité de l'ayant droit en fait) ; arrive notamment quand le sgc rend une carte "caduque". |