Introduction
Contrairement à certains éditeurs qui ont fait le choix d'une logique "boîte noire", Listo a choisi au contraire une approche transparente.
En complément de la récupération des données comptables, il est également possible de suivre la gestion des DSN mais également de récupérer des versions détaillées des bulletins.
Nos partenaires peuvent également consulter nos données de référence
Télécharger les DSN générées et transmises par Listo
Récupération de la liste des DSN déposées
curl --location --request GET "<Environnement>/api/dsns?period.id=<ID Période>&period.etablissement.id=<ID Etablissement>" \
--header 'Authorization: Bearer <Token>'
Retour
{
"idFlux": "!Identifiant du flux métier!",
"nomFichier": "!Nom du fichier généré!",
"etat": "dsn_acceptée", "#dsn_acceptée dans le cas d'un dépôt réussi, dsn_sans_erreur dans le cas d'une DSN générée et contrôlée, dsn_generée dans le cas d'une simple génération",
"updatedAt": "!Date de dernière mise à jour de l'état!"
}
Seules les DSN à l'état "dsn_acceptée" ont été transmises aux administrations. Nous ne conservons que la dernière DSN transmise ou en cours de transmission.
Récupération d'une DSN
curl --location --request GET "<Environnement>/api/etablissements/<ID Etablissement>/<Date de début de la période AAAA-MM-JJ>/<Date de fin de la période AAAA-MM-JJ>/dsn" \
--header 'Authorization: Bearer <Token>'
Le fichier DSN correspondant est retourné par l'API, au format .txt
Si la DSN n'est pas à l'état "dsn_acceptée" pour la période de recherche, alors l'API retourne un code 212 et le message "Aucune DSN valide disponible - Veuillez vous rapprocher du support".
Consulter un bulletin de paie détaillé sur la période en cours
Afin de faciliter les contrôles sur la paie de la période courante, il est possible de récupérer les bulletins de paie détaillés en format CSV.
curl --location --request GET "<Environnement>/api/contrats/<ID Contrat>/bulletin.csv?debug=true" \
--header 'Authorization: Bearer <Token>'
Le bulletin CSV est retourné par l'API
Consulter la version centralisée des bulletins de paie des bulletins d'un établissement pour une période donnée
Il est possible de récupérer une version centralisée des bulletins de paie d'un établissement sur une période donnée au format CSV.
curl --location --request GET "<Environnement>/api/etablissements/<ID Etablissement>/<Date début AAAA-MM-JJ>/<Date fin AAAA-MM-JJ>/bulletin_centralise?inclus_contextes_calculs=true" \
--header 'Authorization: Bearer <Token>'
Le fichier CSV est retourné par l'API
Consulter la centralisation de paie d'un établissement pour une période donnée
Il est également possible de récupérer la centralisation de paie.
La centralisation est un document comptable généré automatiquement qui retranscrit toutes les informations liées aux bulletins de paie, à l’URSSAF, au chômage, à la retraite et aux autres charges à payer.
Ceci permet donc à la solution de la paie de vérifier et de réguler les montants à payer, tous les mois.
La centralisation est disponible en renseignant une période de début et une période de fin, que ce soit par établissement ou par employé.
Centralisation par établissement
curl --location --request GET "<Environnement>/api/etablissements/<ID Etablissement>/<Période début AAAA-MM-JJ>/<Période début AAAA-MM-JJ>/centralisation" \
--header 'Authorization: Bearer <Token>'
Centralisation par employé
curl --location --request GET "<Environnement>/api/employees/<ID Employee>/<Période début AAAA-MM-JJ>/<Période début AAAA-MM-JJ>/centralisation" \
--header 'Authorization: Bearer <Token>'