Requête contrats

La table des Contrats est disponible en consultation, ajout ou modification.

{
    "code_societe": "LBAC",
    "matricule": "MA1",
    "code_contrat": "MA1.24.01",
    "categorie_salariale": "Cas Général",
    "code_profession": "SeAdj",
    "type_contrat": "Permanent CDD",
    "debut_contrat": "2024-01-15",
    "heure_embauche": "09:30:00",
    "fin_contrat": "2024-01-15",
    "contrat_termine": false,
    "temps_partiel": 100,
    "qualification": "",
    "echelon": "",
    "coefficient": 0,
    "dates_travaillees[],
    "base_calcul_inverse": "",
    "montant_calcul_inverse": 0,
    "rubriques_contrat [
        {
            "code": "J7",
            "libelle": "Journée(s) de 7 heures",
            "quantite": 1,
            "base": 150,
            "code_analytique": "D6B001DBF02F40F38318E2096E45929D"
        },
        {
            "code": "PPa",
            "libelle": "Prime de précarité",
            "quantite": 1,
            "base": 15,
            "code_analytique": "8E45972F030643ADB2BD307859C6982E"
        },
        {
            "code": "CCdd",
            "libelle": "ICCP CDD cumulée",
            "quantite": 1,
            "base": 16.5,
            "code_analytique": "12A3540FA5254743AEA93604FC260659"
        },
        {
            "code": "DNS",
            "libelle": "Défraiement non soumis",
            "quantite": 1,
            "base": 100,
            "code_analytique": null
        }
    ],
    "compte_analytique": null,
    "code_analytique": null,
    "numero_objet": null,
    "convention_collective": "1518",
    "total_brut": 181.5,
    "mutuelle": null,
    "motif_cdd": "Accroissement d'activité",
    "reference_dpae": "LDRF54HE"
}

PUT - Créer un contrat

La réponse retournera l’ensemble des informations (dont le code contrat GHS éventuellement créé s’il était non renseigné).

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

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

GET - Consulter un contrat

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

GET /contrats/lad.22.01

GET - Rechercher / Lister des contrats

Il est possible de faire une recherche sur le nom ou le matricule du salarié, ainsi que sur sur la date de début de contrat :

GET /contrats/?nom=landragin&debut_contrat=2024-01-15
GET /contrats/?matricule=lad 

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

GET /contrats/?code_societe=SocA

POST - Mettre à jour un contrat

L’identifiant à passer en paramètre est le code contrat GHS.

POST/ contrats/lad.22.01 

GET - Synchroniser les contrats

On initialise une synchronisation avec la route 

GET /contrats/?from=init.

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

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

Exemple : 

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

Les lignes renvoyées sont triées par timestamp. Le timestamp d’un contrat 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 /contrats/?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.