L'integrazione con Dolibarr ti permette di arricchire la tua interfaccia Okimia grazie a l'importazione automatica delle tue fatture clienti et fournisseurs. Una volta stabilita la connessione, Okimia récupère le tue fatture sur les 12 derniers mois et les rafraîchit à chaque sincronizzazione.
📖 Cette integrazione s'adresse aux utilisateurs de Dolibarr en mode SaaS hébergé ou auto-hébergé, dès lors que l'API REST de Dolibarr est activée et accessible depoi Internet.
Mettre en place la connessione
Segui i seguenti passaggi :
Nel tuo account Okimia, clicca su l'icona avatar in alto a destra, poi sur
IntégrationsClicca su
+ Aggiungi un'integrazioneSeleziona
Dolibarr, poi clicca suConfermareGénérez il tuo chiave API direttamente dans il tuo compte Dolibarr (depoi la configuration de il tuo compte utilisateur), poi inserisci-la dans Okimia accompagnée du domaine de il tuo instance Dolibarr (ex :
monentreprise.dolibarr.appouerp.monentreprise.fr) :Seleziona i dati che desideri importare depoi
Dolibarr, poi clicca suSynchroniser les donnéesUna volta completata la sincronizzazione, clicca su
Voir mon dashboard:Vai alla scheda
Échéancespour visualiser toutes le tue fatture importées
🔑 Où trouver il tuo chiave API Dolibarr ? Dans Dolibarr, ouvrez il tuo fiche utilisateur, poi la scheda Utilisateur : la chiave API se génère dans la sezione dédiée. L'utilisateur associé à cette clé doit avoir les droits de lecture sur les tiers, les fatture clienti et les fatture fornitori (et, le cas échéant, les commandes fournisseurs).
Ce qui est remonté dans Okimia
Selon les cases cochées à l'étape 5, Okimia remonte :
Les fatture clienti (échéances clients / 411) sur les 12 derniers mois
Les fatture fornitori (échéances fournisseurs / 401) sur les 12 derniers mois
Le tiers associé à chaque fattura (client ou fournisseur), con son nom légal
Pour chaque fattura, Okimia récupère :
Le numéro de fattura et la date d'émission
La date d'échéance (et la date de paiement si la fattura est soldée)
Les montants HT, TVA et TTC en multidevises (utilisation des champs multicurrency de Dolibarr)
Le restant dû, calculé comme TTC – montant déjà payé
Le statut, mappé depoi les statuts Dolibarr
📖 Correspondance des statuts Dolibarr → Okimia
Brouillon (draft, statut 0) → ignoré, la fattura n'est pas remontée tant qu'elle reste en brouillon
Validée / impayée (statut 1) → En cours (ou En retard si la date d'échéance est dépassée)
Payée (statut 2) → Payée
Annulée (statut 3) → Annulée
Les fatture marquées comme spécimen dans Dolibarr (fatture de démonstration) sont anche exclues de la sincronizzazione.
Bonnes pratiques pour une donnée propre dans Okimia
📅 Inserisci systématiquement la date d'échéance dans Dolibarr (champ date limite de règlement côté client, date d'échéance côté fournisseur). Sans ce champ, Okimia ne peut pas positionner correctement la fattura sur la tua previsione di liquidità.
🏷️ Tenez à jour les statuts. Les fatture qui restent en brouillon dans Dolibarr ne remontent pas dans Okimia : si tu ne voyez pas une fattura, vérifiez d'abord qu'elle est bien validée. À l'inverse, une fattura passée en statut Payée côté Dolibarr disparaît automaticamente de i tuoi échéances Okimia.
🔁 Volumes importants. La sincronizzazione traite jusqu'à environ 5 000 fatture par categoria (clients / fournisseurs) à chaque rafraîchissement. Si il tuo volume dépasse ce seuil, contactez le support pour qu'on cale ensemble la stratégie d'import la plus adaptée.
Intégrations sur-mesure
⚙️ Certaines configurations Dolibarr sortent du cadre standard décrit ci-dessus : utilisation des commandes fournisseurs (supplier orders) à la place des fatture fornitori comme source d'engagement de dépense, exploitation de champs personnalisés (extrafields) propres à il tuo instance pour véhiculer des informations métier (numéro de projet, code analytique, libellé enrichi…), ou règles de mapping spécifiques.
Ces cas sont gérables : Okimia peut configurer une integrazione sur-mesure adaptée à il tuo instance. Per farlo, prenez contact con il tuo référent Okimia ou con le support en décrivant brièvement il tuo besoin et nous reviendrons vers tu con une proposition.
Besoin d'aide ? Non esitare a contattare il nostritro team support :
📞 01 76 50 33 88
📧 [email protected]
📝 contactez-nous via le chat