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 (par défaut les erreurs non prises en compte / connues d'esup-sgc sont considérées 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 ; à corriger/revoir au fil de l'eau en fonction des améliorations conjointes d'esup-sgc et de l'api crous.
| 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. Dans les logs système, on peut récupérer le corps de la requête JSON envoyé à l'API CROUS en REST, on peut s'assurer que les informations sont correctes (mail bien formé, date ok ...). |
| 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 / Le compte est cloturé | 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". |
| Ayant droit | -42 | Client incconu | Oui | Une intervention par le CROUS est nécessaire. |
| Carte | non_unique | La carte est déjà présente (zdcUniqueNumber) | Oui | La zdcUniqueNumber est le numéro unique de la carte pour le CROUS/IZLY. |
| Ayant droit | Il existe plusieurs comptes avec le même ine | Oui | ||
| Carte | 423 | La carte est associée à un compte cloturée. Réutilisation impossible dans le cadre d'Izly | Non | Le compte est clôturé côté CROUS/IZLY après un certain temps d'inactivité (RGPD) ou après un certain temps sans que l'utilisateur n'ait activé son compte crous/izly. |
| Ayant droit | 406 | Le compte a un rne prioritaire qui est différent du rne proposé | Non | Lorsque l'étudiant est inscrit dans 2 établissements, seul l'établissement propriétaire peut modifier le compte. |
| Ayant droit | 405 | La création des comptes étudiants est suspendue jusqu'en septembre | Oui | En juillet/aôut, la création de comptes étudiants par les établissements est suspendue pour privilégier la création des comptes via le flux de la CVEC. Durant cette période, cette erreur est donc remontée tant que l'étudiant n'est pas retrouvé dans izly via l'api crous.La création pour les étudiants qui ne sont pas assujettis à la CVEC est à nouveau possible en septembre. |
| Ayant droit | -11 | Client existant | Oui | Le compte a été partiellement supprimé côté CROUS/IZLY et ne peut pas être recréé via l'API CROUS. |
| Ayant droit | 423 | Le compte est gelé ou refusé | Non | Compte refusé : l'ayant droit a refusé le service izly (une case à cocher sur le formulaire d'inscription) |
| Ayant droit | 442 | Il existe plusieurs comptes avec le même ine | Oui | Cas rare où il y a déjà 2 comptes crous/izly avec le même INE mais dont l'identifiant lui-même n'est pas l'INE. |