Développeurs
L'API de Litos
Nous exposons les données de chaque société par une API en lecture et en écriture. Elle sert nos propres applications et les outils que vous connectez : tableau de bord, comptabilité, automatisations. La description complète est publiée au format OpenAPI.
Description OpenAPI Créer un jeton
Authentification
Un jeton se crée dans Ma société, rubrique Intégrations, avec une portée lecture ou écriture. Il donne accès aux données de cette seule société et se révoque à tout moment. Il se transmet dans l'en-tête Authorization: Bearer.
curl -H "Authorization: Bearer litos_votre_jeton" https://litos.fr/api/v1/societeFormat
JSON, clés en français, montants en centimes d'euro, dates au format ISO 8601. Les listes sont paginées par curseur : la réponse porte donnees et suivant, à renvoyer en paramètre apres pour la page suivante, jusqu'à 200 éléments par page.
Erreurs
Toute erreur répond par un objet erreur avec un code stable et un message en français : non_authentifie, acces_refuse, lecture_seule, application_inactive, introuvable, parametres_invalides, trop_de_requetes. La limite est de 300 requêtes par minute et par jeton.
Ressources
| Chemin | Contenu | Écriture |
|---|---|---|
| /api/v1/societe | Identité et profil fiscal de la société | Non |
| /api/v1/activites | Activités de la société | Créer, renommer |
| /api/v1/clients | Clients et leur rattachement aux activités | Créer, modifier |
| /api/v1/banque/operations | Opérations bancaires, ventilées par activité | Déposer, idempotent par référence |
| /api/v1/flux | Flux de trésorerie réalisés et attendus, toutes sources actives | Non |
| /api/v1/facturation/factures | Factures, lignes, règlements reçus, statut de plateforme | Non |
| /api/v1/facturation/devis | Devis et leur décision | Non |
| /api/v1/facturation/achats | Factures fournisseurs reçues par la plateforme agréée | Non |
| /api/v1/facturation/reglements | Règlements enregistrés sur les factures | Non |
| /api/v1/previsionnel/lignes | Lignes prévisionnelles : encaissements, dépenses, dividendes | Créer, modifier, supprimer |
| /api/v1/previsionnel/projection | Projection de trésorerie mensuelle, consolidée ou par activité | Non |
| /api/v1/previsionnel/parametres | Solde de départ, horizon, seuil, hypothèses fiscales et sociales | Modifier |
Les ressources d'une application répondent 404 tant que l'application n'est pas activée pour la société. La création de factures par l'API n'est pas ouverte : elle engage la numérotation légale et fera l'objet d'une version ultérieure.
Flux de trésorerie
Le point /api/v1/flux agrège ce que la suite sait de la trésorerie : le réalisé vient des opérations bancaires, importées, saisies ou déposées par l'API ; l'attendu vient des applications actives, par exemple les factures en attente, les devis acceptés et les factures fournisseurs à payer pour Facturation. Chaque flux porte sa date, son sens, sa nature, son activité et sa source.