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à connue 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é un certain temps, sa carte se voit archivée. |
| Carte | -35 | Support existant | Non | Une carte avec les mêmes identifiants pour cette même personne est déjà connue 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é 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. |
Card has not the CROUS/IZLY application encoded
Si vous avez une erreur de type "org.esupportail.sgc.exceptions.SgcRuntimeException: Card with csn 04******* has not the CROUS/IZLY application encoded ?" lors de l'activation ou désactivation de la carte auprès de l'API CROUS/IZLY, cela signifie qu'esup-sgc n'a pas retrouvé la carte dans la table crous_smart_card.
Cette table peut être peuplée de 2 manières :
- lors de l'encodage du crous/izly pour les esup-sgc qui encodent eux-mêmes le crous/izly (possibilité dépréciée, plus maintenue et non recommandée par le crous, et esup-portail)
- lors de l'importation des fichiers CSV résultant de la commande/livraison des cartes pré-encodées (par la société selp actuellement, avril 2026)
Aussi, si vos cartes sont préencodées par la selp :
- si l'erreur est systématique pour l'ensemble des cartes avec le crous/izly de demandé, le problème le plus commun est un oubli d'import du CSV depuis l'interface web d'esup-sgc : onglet "Admin" < "Cartes CROUS"
- si cela ne concerne qu'une carte, cela peut être une carte non présente dans le fichier CSV proposé avec la commande (cas extrêmement rare, vous pouvez vous retourner auprès du fournisseur ou faire simplement une nouvelle carte)
Si vos cartes sont issues d'un ancien SGC, cela peut venir du fait que vous n'avez pas importé le CSV correspondant à l'encodage.
Enfin, cela peut simplement dire que la carte n'a effectivement pas l'application crous/izly desfire d'encodée - vous pouvez le vérifier avec un lecteur NFC, depuis un Android en utilisant NXP Tag Info par exemple : cf Tags NFC - getting started