Arborescence des pages

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'erreurCodeMessage

Bloquant

Description
Ayant droit-117Client AnonymiséNonLe compte est clôturé côté CROUS/IZLY à la demande de l'usager (RGPD).
Carte404Ayant droit inconnuNonLe 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-40Requête erronéeOui

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 ...).
Si le contenu est bien formé, le problème est alors côté IZLY et une intervention par le CROUS est alors nécessaire.

Carte-9Support en oppositionNonLa carte a été mise intentionnellement en opposition côté CROUS.
Carte404Unknown RightHolderNonLe 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 droitnon_uniqueAccount already existOui

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 :

  • l'ayant droit est contrôlé par un autre établissement,
  • l'ayant droit a en fait été archivé (rgpd notamment) dans les bases crous/izly, l'identifiant est grillé et ne peut pas être dégrillé directement via l'API

Une intervention par le CROUS est nécessaire.

Ayant droit423Account 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.
A partir de la version 1.9.0 d'esup-sgc, l'utilisateur a la possibilité de le déclôturer lui-même depuis sa vue utilisateur esup-sgc.

Carte-31Support déjà associéNonUne 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.
Carte404Unknown CardNonPeut arriver quand on tente de désactiver une carte qui n'avait pas été (pu être) activée côté CROUS/IZLY.
Carte-8Date de fin de validité de la carte dépasséeNonPeut 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-42Client incconuOui

Une intervention par le CROUS est nécessaire.

Cartenon_uniqueLa carte est déjà présente (zdcUniqueNumber)
Oui

La zdcUniqueNumber est le numéro unique de la carte pour le CROUS/IZLY.
Cette erreur arrive lorsque la carte a été archivée côté CROUS/IZLY, elle est considérée comme obsolète chez eux et donc plus utilisable.
Ils vous faut ici éditer une nouvelle carte pour l'utilisateur concerné (cette carte étant de toute manière assez/très ancienne).

Ayant droit
Il existe plusieurs comptes avec le même ineOui
Carte423La carte est associée à un compte cloturée. Réutilisation impossible dans le cadre d'IzlyNon

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.
La réutilisation de la carte n'est plus possible pour le crous/izly ; si l'utilisateur souhaite utiliser une carte avec les services crous/izly, la seule solution est de lui rééditer une nouvelle carte.

Ayant droit406Le 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.
Par contre, tous les établissements peuvent ajouter une carte.
Note : s'il y a changement de date de fin de validité (== nouvelle année, nouvelle inscription) alors l'update est ok : reset de ce rne prioritaire.

Ayant droit405La création des comptes étudiants est suspendue jusqu'en septembreOui

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-11Client existantOui

Le compte a été partiellement supprimé côté CROUS/IZLY et ne peut pas être recréé via l'API CROUS.
Une intervention par le CROUS est nécessaire si l'utilisateur souhaite effectivement bénéficier des services CROUS.

Ayant droit423Le compte est gelé ou refuséNon

Compte refusé : l'ayant droit a refusé le service izly (une case à cocher sur le formulaire d'inscription)
Compte gelé : l'ayant droit a fait des opérations non conformes au CGV et son compte a été bloqué par l'opérateur izly
Une intervention par le CROUS est nécessaire si l'utilisateur souhaite effectivement bénéficier des services CROUS.

Ayant droit442Il existe plusieurs comptes avec le même ineOui

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.
Ce cas tente à disparaître avec l'usage de l'INE comme identifiant des comptes étudiants crous/izly.
Cette erreur se fait sur un GET et n'est pas sauvegardée en base dans esup-sgc actuellement.
Une intervention par le CROUS/CNOUS est nécessaire.

  • Aucune étiquette