Liste des évolutions et correctifs apportés

vv21.2.32

ApplicationNuméroTitreTypeDescription
MyOPCA 33333 API - Dossier - Rajouter la fonction tutorale sur le patch Évolution
Dans l'API Dossier, rajouter la fonction tutorale dans la fonction patch.
MyOPCA 33414 API CFA - POST Dossiers - Mapping Nom / Nom de naissance Évolution
Lors de la création d'un dossier pour l'API CFA, voici la procédure de recherche et création des personnes :

Pour rechercher la personne :
  • cas 1 : le nom d'usage API CFA n'est pas renseigné
    • On cherche le nom de naissance API CFA sur le nom ET le nom de naissance MyOPCO => Si un des deux correspond, on rattache
  • cas 2 : le nom d'usage API CFA est renseigné
    • On cherche le nom d'usage API CFA sur le nom MyOPCO, et si pas trouvé, on cherche le nom de naissance API CFA sur le nom ET le nom de naissance MyOPCO => Si un des deux correspond, on rattache

Pour créer la personne :
  • cas 1 : le nom d'usage API CFA n'est pas renseigné
    • on met le nom de naissance API CFA dans le nom MyOPCO
  • cas 2 : le nom d'usage API CFA est renseigné et à la même valeur que le nom de naissance API CFA
    • on met le nom de naissance API CFA dans le nom MyOPCO
  • cas 3 : le nom d'usage API CFA est renseigné et n'a pas la même valeur que le nom de naissance API CFA
    • on met le nom d'usage API CFA dans le nom MyOPCO et le nom de naissance API CFA dans le nom de naissance MyOPCO
MyOPCA 33545 API CFA - Facture - RG - Date d'émission Évolution
Créer une RG VAL_FAC_CFA_Ctrl_Date_Emission qui contrôle que la date d'émission est
  • antérieure à la date du jour
  • postérieure à la date de début de toutes les échéances
La vérification que la date est saisie se fait déjà dans le code.
MyOPCA 33551 API CFA - Facture - RG - Iban de l'émetteur Évolution
Créer une RG VAL_FAC_CFA_Ctrl_Iban_Emetteur qui contrôle que l'IBAN de l'émetteur est saisi et que le complément comptable lié au tiers de la facture a bien cet IBAN.

L'accès à la variable Iban Emetteur se fait via les paramètres RG : "Outils.Parametres.StringValue("IBAN_EMETTEUR").
MyOPCA 33566 API CFA - Facture - RG - Ligne / numéro échéance Évolution
Créer une RG VAL_FAC_CFA_Ctrl_Numero_Echeance qui contrôle que le numéro d'échéance par ligne correspond à une échéance présente sur le dossier et active. Le numéro d'échéance peut être atteint par Outils.Parametres.StringValue("NUMERO_ECHEANCE").
L'API CFA doit être modifié afin de vérifier que le numéro d'échéance par ligne est bien saisi.
MyOPCA 33578 API CFA - Facture - RG - Numéro Évolution
Créer une RG VAL_FAC_CFA_Ctrl_Numero qui contrôle que le numéro est unique pour un même tiers de facturation.
Le contrôle de la saisie du numéro de la facture est déjà effectué dans le code de l'API.
MyOPCA 33584 API CFA - Facture - RG - Règles globales Évolution
Créer une RG VAL_FAC_CFA_Ctrl_Etat_Dossier qui contrôle que :
  • le dossier est à l'état engagé, en cours ou en cours de paiement
Les contrôles suivants sont déjà effectués dans le code :
  • Il doit y avoir une seule échéance par dossier
  • Il doit y avoir au moins une ligne facture
MyOPCA 33773 API CFA - Facture - RG - Codification échéance Évolution
Créer une RG VAL_FAC_CFA_Ctrl_Codification_Echeance qui vérifie que la codification échéance désigne une échéance présente sur le dossier et active.
Le contrôle de la saisie de la codification échéance est faite dans le code de l'API.
MyOPCA 33840 API CFA - Get Dossiers - Format des dates incorrect Évolution

Les formats de date retournés doivent être sans timezone et rester en UTC 0.

Exemple

       "dateNaissance": "2003-12-09T00:00:00.000Z" ou  "dateNaissance": "2003-12-09T00:00:00+00:00"
MyOPCA 33848 API CFA - GET Dossiers - Habilitations non respectées pour les dossiers pré-saisis Évolution
Lorsque l'on tente d'accéder à un pré-dossier, le contrôle des habilitations (via la clé API désignant le CFA) n'est pas fait.
MyOPCA 33861 API CFA - POST Documents - Restreindre les droits Évolution

Lors de l'appel au POST Documents, Il doit y avoir le contrôle suivant :

 Le dépot d'un document ne doit être possible que sur les dossiers/factures associés au CFA connecté via son X-API-KEY
MyOPCA 33866 API CFA - POST Dossiers - Restreindre les droits de création Évolution

A la manière de la méthode GET dossiers, il est nécessaire de restreindre le droit à un CFA de créer des contrats d'apprentissage uniquement pour les ou les CFA auxquels il est habilité.
MyOPCA 33878 API CFA - POST Dossiers - Initialiser les champs certifications et RNCP du CERFA Évolution

Initialiser dans le CERFA :

- Le champ Certification avec la même valeur que le code diplôme

- Le champ RNCP avec le champ code RNCP

Attention, contrairement à ce qui est indiqué dans le swagger, nous n'avons pas activé les contrôles que le diplôme et le code RNCP sont bien dans les listes de France compétences. Il ne faut donc faire cette initialisation que si on trouve la valeur dans le référentiel.
MyOPCA 33882 API CFA - GET Dossiers - Ne remonter que les échéances actives Évolution
Dans la méthode GET dossiers, dans le noeud échéances, il ne doit y avoir que les échéances actives
MyOPCA 33896 API CFA - GET Dossiers - Le NIR et la nationalité ne sont pas récupérés sur le stagiaire Évolution
Dans la méthode GET Dossiers, le NIR ne remonte pas alors qu'il est renseigné sur le dossier.
Le soucis vient du fait que l'on remonte le NIR de la personne et pas du stagiaire.
Le même problème est présent pour la nationalité.
MyOPCA 33913 API CFA - Impossible de copier-coller la clé API Évolution
Dans MyOpco dans l'onglet Utilisateur de la fiche Personne, il est impossible de sélectionner dans la grille Token CFA la clé API générée.
Rajouter un bouton qui permet de copier la valeur.
MyOPCA 33943 API CFA - RG - Contrôle du courriel Apprenti Évolution
Modifier la RG VAL_DOS_ASS_CFA_Ctrl_Apprenti_Courriel afin de rajouter un contrôle sur le format du courriel de l'apprenti (même chose que pour l'employeur).
MyOPCA 33954 API - GRID 700011 - Gestion des utilisateurs - Optimisations des performances Évolution
Modification de la requête SQL pour augmenter le temps de réponse.
MyOPCA 33957 API CFA - RG - Contrôle des années rémunération Évolution
Adapter les RG VAL_DOS_ASS_CFA_Ctrl_ContratDateDebXAnneeY pour contrôler que la date de début de la période est égale à la date de fin de la période précédente + 1 jour.

Créer des RG pour contrôler que les dates saisies pour une année sont bien sur une année uniquement (il ne faut pas que la date de fin de la période dépasse la date de début de la période + 1 an).
MyOPCA 33960 API - Demandes - Optimisation si pas de RG à lancer Évolution
Ne plus chercher des informations sur les RG si on n'a pas de RG à lancer.
MyOPCA 33971 API CFA - Dossiers - Engagement des frais annexes Évolution API CFA - Get Dossiers - Le champ engagementsFraisAnnexe constitué des 4 champs suivants :
  • quantité : quantité engagé du frais
  • prixunitaire : prix unitaire du frais
  • montanttotal : montant engagé du frais
  • naturefrais : même correspondance que dans les natures de lignes du POST Factures
MOBILITE = Frais 18
HEBERGEMENT = Frais 4
RESTAURATION = Frais 6 ou 10
PREMIEREQUIPEMENT = Frais 19
MyOPCA 34001 API CFA - Problème sur le format des erreurs Évolution

Le format de retour des appels JSON n'est pas celui demandé dans le swagger :

Exemple de format retourné actuellement :

{
    "code": 1,
    "description": "Le code de 'Dossiers[].Trainees[].Cerfa.Contract.NatureCode' n'a pas été trouvé (valeur : '148')"
}
 
Le format attendu est le suivant :
{
  "errors": [
    {
      "code": 1,
       "description": "Le code de 'Dossiers[].Trainees[].Cerfa.Contract.NatureCode' n'a pas été trouvé (valeur : '148')"
    }
  ],
  "status": "error"
}
MyOPCA 34009 API CFA - POST Documents - Problème de gestion de l'idobjet Évolution
Il est possible de passer une valeur alphanumérique dans le champ IdObjet et cela rattache le document à un dossier différent à chaque fois.
Le problème vient du fait qu'on s'attend à avoir uniquement des chiffres et lors de l'appel à l'API V11, il n'arrive pas à récupérer l'identifiant et donc lance une recherche sans filtrer par identifiant dossier.

Empêcher ce comportement en générant une erreur si l'idobjet fourni n'est pas composé uniquement de chiffres. Faire la même chose sur le GET dossiers pour le numéro interne.
MyOPCA 34023 API CFA - POST Documents - Impossible d'associer un document à un dossier présaisi Évolution
Il est impossible d'associer via la route POST Documents un document à un dossier présaisi (le numéro est passé dans IdObjet pour le type DOSSIER_APPRENTISSAGE.
MyOPCA 34051 API CFA - Téléphone 13 caractères Évolution
Si le numéro de téléphone fait 13 caractères ou moins, on le retourne sans transformation.
S'il fait plus de 13 caractères, on supprime les espaces, les points et les tirets puis on le retourne mais on ne vérifie pas le nombre de caractères restants.

Si on ne veut pas dépasser les 13 caractères, un nettoyage en base de données serait à prévoir chez le client.
MyOPCA 34082 API CFA - GET Dossiers - Renvoyer null lorsque les champs ne sont pas valorisés Évolution

Les champs ci-dessous, lorsqu'ils sont à null dans MyOPCO, ont une valeur par défaut renvoyée alors qu'il faut renvoyer null dans ces cas là :

  • Employeur : TypeEmployeur
  • Apprenti : Nationalite, RegimeSocial, SituationAvantContrat, Diplome, DiplomePrepare
  • Contrat : ModeContractuel, TypeContratApp
MyOPCA 34096 API CFA - GET Dossiers - Les numéros interne et externe doivent correspondre au même dossier Évolution

Lors d'un appel à la méthode GET dossiers, on peut envoyer 3 paramètres différents : numéro interne, numéro externe et numéro DECA.

Si on envoie les 3 et que le numéro externe + le numéro DECA renvoient un dossier, le numéro interne n'est pas contrôlé.

Il faut contrôler que les 3 valeurs correspondent au même dossier.
MyOPCA 34101 API CFA - GET Dossiers - Siret de l'organisme de formation Évolution
Si le champ SIRET du pavé "OrganismeFormation" du CERFA est à null, remonter le SIRET de la fiche du CFA associé au dossier.