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 : dans l'interface web d'esup-sgc, on retrouve le listing de ces erreurs via le menu 'Admin' > 'Erreurs CROUS'.
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. Une intervention par le CROUS est nécessaire. |
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 :
Une intervention par le CROUS est nécessaire. |
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". |