Zum Hauptinhalt springen

Wie funktioniert die Integration zwischen Okimia und Dolibarr ?

Okimia s'intègre à Dolibarr pour récupérer Ihre Kunden- und Lieferantenrechnungen, damit Sie beide Tools nahtlos nutzen können.

S
Verfasst von Support Okimia

Die Integration mit Dolibarr ermöglicht es Ihnen, Ihre Okimia-Oberfläche zu bereichern dank den automatischen Import Ihrer Kundenrechnungen et fournisseurs. Sobald die Verbindung hergestellt ist, Okimia récupère Ihre Rechnungen sur les 12 derniers mois et les rafraîchit à chaque Synchronisierung.

📖 Cette Integration 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 dedann Internet.

Mettre en place la Verbindung

Befolgen Sie die folgenden Schritte :

  1. In Ihrem Okimia-Konto, klicken Sie auf das Avatar-Symbol oben rechts, dann sur Intégrations

  2. Klicken Sie auf + Eine Integration hinzufügen

  3. Wählen Sie Dolibarr, dann klicken Sie auf Bestätigen

  4. Générez Ihr API-Schlüssel direkt dans Ihr compte Dolibarr (dedann la configuration de Ihr compte utilisateur), dann geben Sie ein-la dans Okimia accompagnée du domaine de Ihr instance Dolibarr (ex : monentreprise.dolibarr.app ou erp.monentreprise.fr) :

  5. Wählen Sie die Daten aus, die Sie importieren möchten dedann Dolibarr, dann klicken Sie auf Synchroniser les données

  6. Sobald die Synchronisierung abgeschlossen ist, klicken Sie auf Voir mon dashboard :

  7. Gehen Sie zur Registerkarte Échéances pour visualiser toutes Ihre Rechnungen importées

🔑 Où trouver Ihr API-Schlüssel Dolibarr ? Dans Dolibarr, ouvrez Ihr fiche utilisateur, dann die Registerkarte Utilisateur : la API-Schlüssel se génère dans dem Abschnitt dédiée. L'utilisateur associé à cette clé doit avoir les droits de lecture sur les tiers, les Kundenrechnungen et les Lieferantenrechnungen (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 Kundenrechnungen (échéances clients / 411) sur les 12 derniers mois

  • Les Lieferantenrechnungen (échéances fournisseurs / 401) sur les 12 derniers mois

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

Pour chaque Rechnung, Okimia récupère :

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

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

📖 Correspondance des statuts Dolibarr → Okimia

  • Brouillon (draft, statut 0)ignoré, la Rechnung 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 Rechnungen marquées comme spécimen dans Dolibarr (Rechnungen de démonstration) sont auch exclues de la Synchronisierung.

Bonnes pratiques pour une donnée propre dans Okimia

📅 Geben Sie ein 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 Rechnung sur Ihrer Liquiditätsprogunseree.

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

🔁 Volumes importants. La Synchronisierung traite jusqu'à environ 5 000 Rechnungen par Kategorie (clients / fournisseurs) à chaque rafraîchissement. Si Ihr 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 Lieferantenrechnungen comme source d'engagement de dépense, exploitation de champs personnalisés (extrafields) propres à Ihr 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 Integration sur-mesure adaptée à Ihr instance. Dazu, prenez contact mit Ihr référent Okimia ou mit le support en décrivant brièvement Ihr besoin et nous reviendrons vers Sie mit une proposition.

Besoin d'aide ? Zögern Sie nicht, sich zu wenden an unser Team support :
📞 01 76 50 33 88

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

Hat dies deine Frage beantwortet?