Initialisation d'un champ
Un champ inclus sans valeur dans une requête API effacera la donnée sPAIEctacle.
Par exemple, la requête suivante permet de mettre à jour l'IBAN renseigner dans sPAIEctacle et d'effacer le BIC.
POST/ salaries/lad
{
"iban" : "FR99 1234 ...",
"bic" : "",
}
Inversement, la requête suivante permet de mettre à jour l'IBAN renseigner dans sPAIEctacle sans effacer l'éventuel BIC déjà renseigné.
POST/ salaries/lad
{
"iban" : "FR99 1234 ..."
}
En import de fichier plat, un champ donné (ou colonne) ne peut pas être 'supprimé' pour une ligne uniquement. Le fonctionnement est donc inverse, une cellule vide est sans effet sur la valeur préalablement renseignée dans sPAIEctacle, et il convient de préciser explicitement [vide] pour réinitialiser une donnée.
Articulation avec le Niveau de confidentialité
Pour chaque salarié, il est possible de définir ou non un niveau de confidentialité (aucun, Bas, Moyen ou Haut).
Par défaut, lorsqu'un niveau de confidentialité est défini, le salarié n'est pas accessible par API. Une option Disponible API permet néanmoins d'ajuster ce comportement.
- Salarié avec niveau de confidentialité défini (Bas Moyen ou Haut) et option Disponible API non cochée
Toutes les API sont fermées - Salarié avec niveau de confidentialité défini (Bas Moyen ou Haut) et option Disponible API cochée
- API Salariés ouverte (GET et PUT - POST non autorisé)
- Mise à jour des rubriques de paie possible via l'API Paies (PUT & POST rubriques_paies) - Salarié avec niveau de confidentialité non défini (aucun)
Toutes les API sont ouvertes
Recherches sans résultat
Si la ressource primaire n'existe pas, un code 404 est renvoyé.
Par exemple GET /salaries/{matricule n'existant pas}/donnees_personnalisees retournera un code 400.
Si la ressource primaire existe mais qu'aucun résultat n'est trouvé, un code 200 est renvoyé.
Par exemple GET /salaries/{matricule existant}/donnees_personnalisees retournera une liste vide et un code 200 si le salarié concerné n'a pas aucun donnée personnalisée renseignée.