Ir al contenido principal

¿Cómo funciona la integración entre Okimia y Dolibarr ?

Okimia s'intègre à Dolibarr pour récupérer sus facturas de clientes y proveedores, permitiéndole utilizar ambas herramientas de forma sencilla.

S
Escrito por Support Okimia

La integración con Dolibarr le permite enriquecer su interfaz de Okimia gracias a la importación automática de sus facturas de clientes et fournisseurs. Una vez establecida la conexión, Okimia récupère sus facturas sur les 12 derniers mois et les rafraîchit à chaque sincronización.

📖 Cette integración 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 deluego Internet.

Mettre en place la conexión

Siga los siguientes pasos :

  1. En su cuenta de Okimia, haga clic en el icono de avatar en la parte superior derecha, luego sur Intégrations

  2. Haga clic en + Añadir una integración

  3. Seleccione Dolibarr, luego haga clic en Confirmar

  4. Générez su clave API directamente dans su compte Dolibarr (deluego la configuration de su compte utilisateur), luego introduzca-la dans Okimia accompagnée du domaine de su instance Dolibarr (ex : monentreprise.dolibarr.app ou erp.monentreprise.fr) :

  5. Seleccione los datos que desea importar deluego Dolibarr, luego haga clic en Synchroniser les données

  6. Una vez finalizada la sincronización, haga clic en Voir mon dashboard :

  7. Vaya a la pestaña Échéances pour visualiser toutes sus facturas importées

🔑 Où trouver su clave API Dolibarr ? Dans Dolibarr, ouvrez su fiche utilisateur, luego la pestaña Utilisateur : la clave API se génère dans la sección dédiée. L'utilisateur associé à cette clé doit avoir les droits de lecture sur les tiers, les facturas de clientes et les facturas de proveedores (et, le cas échéant, les commandes fournisseurs).

Dolibarr user for api.png

Ce qui est remonté dans Okimia

Selon les cases cochées à l'étape 5, Okimia remonte :

  • Les facturas de clientes (échéances clients / 411) sur les 12 derniers mois

  • Les facturas de proveedores (échéances fournisseurs / 401) sur les 12 derniers mois

  • Le tiers associé à chaque factura (client ou fournisseur), con son nom légal

Pour chaque factura, Okimia récupère :

  • Le numéro de factura et la date d'émission

  • La date d'échéance (et la date de paiement si la factura 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é deluego les statuts Dolibarr

📖 Correspondance des statuts Dolibarr → Okimia

  • Brouillon (draft, statut 0) → ignoré, la factura 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 facturas marquées comme spécimen dans Dolibarr (facturas de démonstration) sont también exclues de la sincronización.

Bonnes pratiques pour une donnée propre dans Okimia

📅 Introduzca 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 factura sur su previsión de tesorería.

🏷️ Tenez à jour les statuts. Les facturas qui restent en brouillon dans Dolibarr ne remontent pas dans Okimia : si usted ne voyez pas une factura, vérifiez d'abord qu'elle est bien validée. À l'inverse, une factura passée en statut Payée côté Dolibarr disparaît automáticamente de sus échéances Okimia.

🔁 Volumes importants. La sincronización traite jusqu'à environ 5 000 facturas par categoría (clients / fournisseurs) à chaque rafraîchissement. Si su 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 facturas de proveedores comme source d'engagement de dépense, exploitation de champs personnalisés (extrafields) propres à su 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 integración sur-mesure adaptée à su instance. Para ello, prenez contact con su référent Okimia ou con le support en décrivant brièvement su besoin et nous reviendrons vers usted con une proposition.

​Besoin d'aide ? No dude en ponerse en contacto con nuestro equipo support :
​📞 01 76 50 33 88

📧 [email protected]
​📝 contactez-nous via le chat

Artículos relacionados
¿Ha quedado contestada tu pregunta?