Requête sociétés

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

{
   "code_societe": "LBAC",
   "raison_sociale": "LA BOITE A CONTRAT",
   "nom_abrege": "LA BOITE A CONTRAT",
   "forme_juridique": "SARL",
   "activite": "Foire et expositions",
   "nom_signataire": "Lescure",
   "prenom_signataire": "Jean",
   "qualite_signataire": "PDG",
   "nom_contact": "Lebray",
   "genre_contact": "madame",
   "courriel_contact": "mail@mail.com",
   "telephone_contact": "0153342525",
   "convention_collective": "1218",
   "iban": "FR760214557456625666",
   "bic": "BICFRPP",
   "adresse": "3 rue de la gare",
   "complement_adresse": "immeuble B",
   "code_postal": "75010",
   "ville": "Paris",
   "code_pays": "FR",
   "telephone": "0153342525",
   "telecopie": "",
   "siret": "32792095500041",
   "code_ape": "9002Z",
   "debut_exercice_conges_payes": 6,
   "soumis_taxe_salaires": true,
   "abattement_taxe_salaires": false,
   "motif_non_soumis_taxe_apprentissage": "18",
   "numero_suivant_aed": 54,
   "agrement_aem": "",
   "numero_suivant_aem": 1,
   "licence_spectacle": null,
   "label_prestataire": null,
   "code_commune_insee": null,
   "dsn_fraction_declaration": "11",
   "heure_embauche": "09:30:00",
   "choix_abattement": [
      {
         "exercice": "2022",
         "valeur": "salarie",
      },
      {
         "exercice": "2024",
         "valeur": "salarie",
      }
   ],
   "activation": true,
   "certification_sociale": null
}

PUT - Créer une société

PUT /societes

La réponse retournera l’ensemble des informations enregistrées.

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

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

GET - Consulter une société

L’identifiant à passer en paramètre est le code société GHS.

GET /societes/SocA

POST - Mettre à jour une société

L’identifiant à passer en paramètre est le code société GHS.

POST /societes/SocA

GET - Synchroniser des sociétés

On initialise une synchronisation avec la route 

GET /societes/?from=init.

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

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

Exemple : 

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

Les lignes renvoyées sont triées par timestamp. Le timestamp d’une société 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 /societes/?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.