Requête salariés

La table des Salariés est disponible en consultation, ajout ou modification.

{
    "code_societe": "LBAC
    "matricule": "MA1",
    "nom": "LANDRAGIN
    "prenom": "Drissia",
    "nom_naissance": " ",
    "pseudonyme": " ",
    "genre": "Madame",
    "adresse": "73 la belle rue",
    "complement_adresse": "",
    "code_postal": "75010",
    "ville": "PARIS",
    "code_pays": null,
    "code_pays_nationalite": null,
    "telephone": "0612345678",
    "mail": "mail@mail.fr",
    "refus_dematerialisation": false,
    "date_naissance": "1987-11-05",
    "lieu_naissance": "Pontoise",
    "departement_naissance": "95",
    "code_pays_naissance": "FR",
    "numero_securite_sociale": "288059512345674",
    "numero_conges_spectacles": " ",
    "retraite": false,
    "fiscalite": "metropole",
    "abattement": "oui",
    "choix_abattement": [
        {
            "exercice": "2023",
            "valeur": "non"
        },
        {
            "exercice": "2024",
            "valeur": "oui"
        }
    ],
    "date_visite_medicale": "2022-02-28",
    "date_prochaine_visite_medicale": "2027-02-27",
    "date_entree": "0000-00-00",
    "date_anciennete": "2000-01-15",
    "compte_racine": "421",
    "compte_terminaison": "MAR",
    "libelle_racine": "NAP",
    "libelle_terminaison": "MARCHAND Ethan",
    "mode_reglement": null,
    "IBAN": "",
    "BIC": "",
    "statut_handicape": 11,
    "statut_handicape_date_debut": "2022-01-02",
    "niveau_confidentialite": "(aucun)",
    "titre_sejour_numero": "123456789",
    "titre_sejour_fin_validite": "2025-01-15"
}

PUT - CRÉER UN SALARIÉ

La réponse retournera l’ensemble des informations (dont le matricule GHS du salarié éventuellement créé s’il était non renseigné.

La réponse retournera également des métadonnées :

PUT/salaries
{
    "__meta": {
        "source": "api",
        "date_maj": "2021-05-15T12:34:56.789Z"
    }
}

GET - Consulter un salarié

L’identifiant à passer en paramètre est le matricule GHS du salarié

GET /salaries/lad

GET - Rechercher/Lister des salariés

Il est possible de faire une recherche à partir du nom ou du prénom du salarié :

GET /salaries/?nom=landragin ou GET /salaries/?prenom=drissia

Il est également possible de lister les salariés d’une société à partir du code société :

GET /salaries/?code_societe=SocA

POST - Mettre à jour un salarié

L’identifiant à passer en paramètre est le matricule GHS du salarié.

POST/salaries/lad 

GET - Synchroniser les salariés

On initialise une synchronisation avec la route 

GET /salaries/?from=init.

L’intégralité des salariés sera alors récupérée.

Par la suite, on demande les salariés créés ou modifiés depuis le dernier timestamp renvoyé par la dernière requête.

Exemple : 

GET /salaries/?from=2021-05-15T12:34:56.789Z

Les lignes renvoyées sont triées par timestamp. Le timestamp d’un salarié se trouve dans __meta.date_maj.

Le nombre de lignes renvoyées par requête est limité à 200 maximum (valeur par défaut). On peut limiter à tout nombre entre 1 et 200 en ajoutant le paramètre {limit}=[nombre].

Exemple : 

GET /salaries/?from=2021-05-15T12:34:56.789Z&limit=50

Pour récupérer la suite des lignes, il faut passer le paramètre {from} avec comme valeur le timestamp de la dernière ligne de la requête précédente.