Principes généraux

L'utilisation des API Silae Web Service repose sur quelques principes généraux. Cette fiche décrit ces principes généraux.

URL de connexion :

En fonction du domaine et du dossier auquel vous souhaitez accéder, l'url à utiliser pour les appels API sera différente.
L'url est du type https://moncabinet-api.silae.fr/silae/sws/sws.asmx (où "moncabinet" représente le sous-domaine configuré dans le domaine contenant le dossier). L'url correspondante pour se connecter à Silae est https://moncabinet.silae.fr/silae.

Dates et périodes :

Les dates sont toutes au format AAAA-MM-JJT00:00:00.00Z avec :
- AAAA = Année
- MM = Mois
- JJ = Jour
Les périodes, comme les périodes de paie par exemple, sont toutes au format AAAA-MM-01T00:00:00.00Z (le jour est toujours le premier jour du mois) avec :
- AAAA = Année
- MM = Mois

Mise à jour conditionnelle

Dans de nombreuses fonctions, les champs sont "doublés" d'un booléen permettant d'indiquer si la valeur du champ correspondant doit être prise en compte (true) ou non (false). Ces booléens ont le même nom que le champ auquel ils font référence, précédé d'un 'b'. Par exemple : "bPrenom" fait référence au champ "Prenom".

Fonctionnement des emplois et utilisation des identifiants

Dans Silae, chaque modification de la fiche salarié qui a un impact sur la paie génère un nouvel "emploi" (ou "emploi actif" ou "emploi en cours") avec un nouvel "identifiant emploi". L'emploi précédent devient alors un "emploi archivé".
Ces différents emplois au sens Silae ne reflètent pas forcément de vrais changements d'emplois.
Par exemple, un changement de salaire va générer dans Silae un nouvel emploi alors qu'il n'y a pas eu de changement de contrat pour le salarié.
Pour qu'au niveau des API il soit possible de faire la différence entre les changements d'emplois au sens Silae et les vrais changements d'emploi (type sortie/entrée du salarié), il existe la notion d'identifiant emploi externe. Dans l'utilisation des APIs c'est toujours cet "identifiant emploi externe" qui est présent.
Ainsi, pour un salarié qui garde le même emploi avec divers changements (comme des augmentations par exemple), l'identifiant emploi externe sera toujours le même, alors même qu'il y aura eu plusieurs emplois archivés dans Silae.