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, modifier |
| /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/pieces | Pièces comptables : ventes, avoirs et achats des applications actives, avec lignes, tiers et règlements | Non |
| /api/v1/facturation/factures | Factures, lignes, règlements reçus, statut de plateforme, envoi programmé | 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 |
| /api/v1/urssaf/echeancier | Échéances Urssaf de l'entreprise individuelle : micro-social (bases par nature, cotisations, contributions) ou réel (provisionnel, régularisation, provision) | Non |
| /api/v1/urssaf/historique | Périodes closes et échéances passées : estimé, déclaré, payé, paiement pointé sur la banque | Non |
| /api/v1/urssaf/parametres | Périodicité, début d'activité, Acre, nature, hypothèses du micro-social ou du réel (revenu déclaré, échéancier reçu, revenu attendu) | Modifier |
| /api/v1/impots/echeancier | Échéances de TVA, d'IS, de CFE et de CVAE, TVA à reverser, impôts estimés et provisions, alertes de seuils | Non |
| /api/v1/impots/tva | Livre de TVA mensuel : bases et TVA par taux, déductible, crédit reporté | Non |
| /api/v1/impots/historique | Périodes et échéances closes : estimé, déclaré, payé, paiement pointé sur la banque | Non |
| /api/v1/comptabilite/ecritures | Écritures comptables par journal, période et état, avec leurs lignes et justificatifs | Saisir une opération diverse ou un à-nouveau |
| /api/v1/comptabilite/balance | Balance par compte et résultat provisoire, tous états ou validées seulement | Non |
| /api/v1/comptabilite/grand-livre | Grand livre : solde antérieur, lignes et solde progressif par compte | Non |
| /api/v1/comptabilite/parametres | Début de tenue, mode du prochain exercice, option créances et dettes, compte de l'exploitant, seuil d'immobilisation | Modifier |
| /api/v1/impots/parametres | Crédit de TVA, TVA et IS de l'an dernier, résultat attendu, CFE, chiffre d'affaires et valeur ajoutée de la CVAE, hypothèses de ventes et d'achats | 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.