Page tree
Skip to end of metadata
Go to start of metadata

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 closedNon

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-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
  • No labels