Aller au contenu

Dolibarr · tiers, ventes et gestion commerciale

Reliez Dolibarr à vos ventes et à vos outils métier

Les commandes arrivent dans votre boutique, les clients sont suivis ailleurs et les équipes complètent encore Dolibarr à la main. Dawap développe les échanges adaptés à votre instance, à ses modules et à vos règles de gestion, puis organise leur suivi et leur maintenance.

Le premier lot vérifie les droits, les références et le résultat d’une commande, même après une coupure.

  • Shopify
  • PrestaShop
  • Symfony
  • RabbitMQ
  • OpenAPI

L’intégration

Relier Dolibarr à vos opérations commerciales

Dawap développe les connexions entre Dolibarr, l’e-commerce et les applications métier. Nous vérifions les modules existants et les interfaces disponibles, puis définissons les données, les validations et les reprises avec les utilisateurs et la DSI.

  • Confirmer les opérations disponibles sur votre instance.
  • Relier les références entre systèmes.
  • Contrôler les résultats avant de reprendre une opération.

Périmètre du projet

Garder le lien entre le tiers, la commande et le document.

Les modules activés, la version et les droits déterminent les opérations disponibles. Nous les vérifions dans l’explorateur API de votre instance.

Clients et contacts

Rapprocher les tiers et leurs références dans vos outils pour éviter de recréer un client connu.

Commandes e-commerce

Transmettre les lignes, les remises, les frais et les références nécessaires, puis contrôler le résultat dans Dolibarr.

Documents et facturation

Séparer création, validation et règlement selon vos règles. Préserver le lien entre le document source et les opérations réalisées.

Produits et stocks

Relier les références et les entrepôts. Définir l’origine des mouvements et la quantité à transmettre aux canaux de vente.

Champs et modules spécifiques

Prendre en compte les champs complémentaires et les règles propres à votre installation dans les données et les tests.

Suivi et maintenance

Rendre les rejets lisibles, retrouver les opérations et documenter les reprises après une interruption.

Registre d’écriture · scénario illustratif

Une réponse manque : vérifiez si la commande existe avant de la recréer.

La société, la commande, les identifiants, les montants et les horaires ci-dessous sont fictifs. Ce dossier montre comment retrouver l’objet Dolibarr avant de décider si une écriture peut reprendre.

Dossier de commandeAtelier Mistral · WC-8427
Instance
Recette · entité 1
Objet
Commande client
Issue
Timeout après POST
RELECTURE REQUISE
01 · Pièce source

Une commande WooCommerce prête à devenir un brouillon Dolibarr.

COMMANDE #842710:04:11
Tiers rapproché
socid 742
Référence externe
WC-8427
2 lignes produit
240,00 € HT
Transport
18,00 € HT
TVA témoin
51,60 €
Total témoin309,60 € TTC

Exemple de test : produits, taxes, devise, adresses, modules et règles de validation doivent être recalculés sur le dossier réel.

02 · Contrôles avant validation

Six contrôles avant de valider la commande.

  1. 01
    Explorerorders visible pour ce token
    VU
  2. 02
    Droitslecture + création · validation à confirmer
    BORNÉS
  3. 03
    Tierssocid 742 · adresse facturable
    LIÉ
  4. 04
    ref_extWC-8427 · clé stable
    UNIQUE
  5. 05
    Lignes & TVA258,00 € HT · 309,60 € TTC
    ÉGALES
  6. 06
    Effet de validationstock, facture et automatismes à tester
    ATTENTE

03 · Chemin de reprise

Relire par ref_ext avant de rejouer.

La référence externe est ici une règle de conception du middleware. Elle permet de chercher le résultat possible du premier POST ; elle ne transforme pas l’API en mécanisme d’idempotence universel.

  1. 10:04:1101
    Commande reçuesource WC · clé WC-8427
    QUALIFIÉE
  2. 10:04:1202
    Tiers rapprochésocid 742 · droits lus
    PRÊT
  3. 10:04:1303
    POST /ordersréponse perdue côté client
    INCONNU
  4. 10:04:1904
    GET /orders/ref_ext/WC-8427id 582 · statut brouillon
    RETROUVÉ
  5. 10:04:2005
    Validation séparéeattend le contrôle 06 et les tests
    GELÉE
Trace source · EVT-8427

L’intention d’écriture.

source
WooCommerce
ref_ext
WC-8427
total
309,60 €
décision
créer un brouillon
Trace cible · id 582

Le résultat retrouvé.

objet
orders
socid
742
statut
brouillon
lecture
ref_ext identique
Décision de reprise · DOL-17

CONSERVER LA COMMANDE EXISTANTE

Le premier appel a créé le brouillon 582. Reprendre sur ce document après le contrôle 06 ; une nouvelle création produirait un doublon.

Validation : ADV et équipe intégration

Cycle documentaire

Quatre objets, quatre effets à ne pas fusionner.

01

Tiers

Identité facturable, contacts, adresses, statut client et champs spécifiques.

Vérifier la fiche avant utilisation
02

Commande

Lignes, frais, taxes, ref_ext, brouillon, validation et exécution.

Relire avant tout nouveau POST
03

Facture

Création, validation, acompte, avoir, échéance et paiements liés.

Protéger le document engageant
04

Stock

Produit, entrepôt, quantité, sens, origine et date de mouvement.

Rattacher chaque effet à sa cause
01Timeout après créationLa relecture retrouve l’objet et interdit le second POST.
02Droit retiréLe refus reste explicable sans élargir le compte en administrateur.
03TVA divergenteLe brouillon reste à vérifier avant validation.
04Champ spécifique absentLe contrôle signale le champ manquant avant de poursuivre.
05Stock déjà corrigéUn événement ancien n’écrase pas une intervention plus récente.

Interfaces Dolibarr

Vérifier les opérations dans l’explorateur API de votre instance.

La documentation décrit les interfaces et les droits à configurer. Les opérations disponibles et leurs effets sont ensuite vérifiés sur votre version, avec vos modules, vos extensions et vos automatismes.

Premier lot recommandé

Une commande, un tiers, deux lignes et un timeout provoqué.

Nous cadrons la référence externe, les droits, le mapping, le brouillon, la validation et la relecture sur votre instance. Le lot est terminé quand le support sait retrouver l’objet et choisir attendre, corriger ou reprendre sans doublon.

Cadrer mon flux Dolibarr

Premier périmètre

Choisir une commande à intégrer dans votre Dolibarr.

Une commande, une mise à jour de stock ou un dossier client permet de préciser les interfaces, les règles et les tests. Le chiffrage distingue le développement initial et son suivi.

Périmètre et livrables

  • Inventaire de la version, des modules, des droits et des opérations API.
  • Correspondances des tiers, produits, documents et champs spécifiques.
  • Connecteur ou middleware avec contrôles et suivi des erreurs.
  • Tests sur les créations, validations et reprises après interruption.
  • Documentation, déploiement et maintenance convenus.
Un connecteur documenté pour votre environnement
  • Inventaire de la version, des modules, des droits et des opérations API.
  • Correspondances des tiers, produits, documents et champs spécifiques.
  • Connecteur ou middleware avec contrôles et suivi des erreurs.
  • Tests sur les créations, validations et reprises après interruption.
  • Documentation, déploiement et maintenance convenus.

Cas de recette

Vérifier la création, la validation et la reprise sans doublon.

Ces scénarios illustratifs sont adaptés aux modules et aux règles de votre instance pendant la recette.

ClientLa commande provient d’un client déjà connu.
Scénario terrain
Le client existe dans Dolibarr avec une référence différente de celle de la boutique.
Architecture
Conserver une correspondance entre les identifiants et vérifier l’adresse de facturation.
Livrable
Une commande de test reliée au tiers existant.
Décision
Demander une validation si plusieurs tiers peuvent correspondre.
Résultat vérifiable
La commande est rattachée au bon client sans créer une seconde fiche.
ValidationUne commande contient une taxe différente.
Scénario terrain
La boutique et Dolibarr ne calculent pas le même montant sur les lignes reçues.
Architecture
Comparer lignes, remises, frais et taxes avant validation.
Livrable
Un brouillon, le détail de l’écart et le test après correction.
Décision
Faire corriger la règle concernée avant de poursuivre.
Résultat vérifiable
La commande validée présente les montants attendus.
RepriseLe résultat d’une création n’arrive pas au connecteur.
Scénario terrain
Une interruption empêche de savoir immédiatement si Dolibarr a créé la commande.
Architecture
Rechercher le document par sa référence avant toute nouvelle tentative.
Livrable
Un test de coupure, le document retrouvé et le journal des appels.
Décision
Continuer sur le document existant après contrôle de son état.
Résultat vérifiable
Une commande unique reste reliée à sa référence source.
Parcours Dolibarr

Nous choisissons le premier échange selon la charge de ressaisie et les incidents rencontrés.

Transformer une commande boutique en dossier Dolibarr contrôlé

Client, adresses, lignes, coupon, frais, taxes et paiement sont qualifiés avant création puis relus par référence externe.

Une commande unique, explicable après timeout.

Normaliser plusieurs canaux avant l’ERP

Les identifiants, statuts, commissions et retours propres à chaque canal entrent dans un modèle pivot avant Dolibarr.

L’ERP ne devine pas les différences de marketplace.

Décider quand la commande peut devenir facture

Création, validation, acompte, avoir, paiement et clôture gardent leurs conditions et leurs propriétaires métier.

Aucune pièce engageante produite sur une ambiguïté.

Rattacher le mouvement à son origine et à son entrepôt

Produit, entrepôt, quantité, type de mouvement et objet source sont vérifiés avant toute écriture de stock.

Un écart de quantité remonte avec son histoire.

Déroulement

Expliquer ce qui a été créé, refusé ou reste à vérifier.

Nous partons d’une commande ou d’un document représentatif. Nous vérifions les interfaces, les règles de validation et les effets sur la gestion. La recette couvre aussi la donnée manquante, le doublon et l’interruption avant de généraliser le flux.

  1. Examiner l’instance

    Version, modules, champs spécifiques et accès API.

  2. Définir le parcours

    Données, références et règles de validation.

  3. Tester les cas difficiles

    Doublon, erreur métier et réponse manquante.

  4. Préparer le suivi

    Journaux, alertes, reprise et maintenance.

Quand Dolibarr doit échanger avec le reste de l’activité

Le besoin peut concerner une nouvelle connexion, des règles spécifiques ou une intégration devenue difficile à maintenir.

Les commandes nécessitent une ressaisie

Clients, références, montants et statuts sont transférés manuellement avant la préparation ou la facturation.

Les modules spécifiques modifient le parcours

Champs personnalisés, validations et règles locales doivent être pris en compte dans les échanges.

Les reprises créent des doublons ou des écarts

Le traitement doit vérifier ce qui a déjà été réalisé avant de renvoyer une création ou un mouvement.

Préparer notre échange
  • Version de Dolibarr et modules utilisés.
  • Logiciels à connecter et champs spécifiques.
  • Exemple de commande ou d’erreur à traiter.

Quelle opération doit passer de votre boutique ou de votre logiciel métier vers Dolibarr ?

Réalisations Dawap

Des projets de commandes, de gestion et de logistique

Ces références concernent notamment Odoo, Aster, Cegid Y2 et Shippingbo. Elles illustrent le travail de Dawap sur les échanges métier et ne sont pas présentées comme des intégrations Dolibarr livrées.

Passerelle métier entre le site B2B de 1UP Distribution et Odoo Intégration API 1UP Distribution : passerelle B2B–Odoo Voir le projet
  • 15 janvier 2024
  • Lecture ~12 min

Dawap a relié le portail B2B de 1UP Distribution à Odoo pour orchestrer catalogue, comptes clients, disponibilités et commandes dans une chaîne cohérente et exploitable.

Intégration Aster et PrestaShop réalisée pour Art’Sacs Intégration API France Appro / Art’Sacs : catalogue Aster dans PrestaShop Voir le projet
  • 28 janvier 2020
  • Lecture ~14 min

Pour Art’Sacs, activité reprise depuis par France Appro, Dawap a relié Aster et PrestaShop afin de transformer le catalogue fournisseur, synchroniser les quantités, enrichir les fiches et préparer les commandes dropshipping. Les tâches, états et erreurs donnent aux équipes un flux pilotable plutôt qu’une synchronisation opaque.

Hub API ShippingBo Odoo et Wix pour 1UP Distribution Intégration API 1UP Distribution : de Wix à ShippingBo et Odoo Voir le projet
  • 16 octobre 2025
  • Lecture ~18 min

Pour 1UP Distribution, Dawap a relié les commandes Wix, l’exécution logistique ShippingBo et les écritures Odoo dans un hub Symfony. Files dédiées, journaux, écrans de suivi et reprises ciblées permettent de retrouver chaque commande, de localiser une exception et d’agir au bon endroit.

Commandes Cegid, ASN fournisseur et attendus de réception ShippingBo pour Fauré Le Page Intégration API Fauré Le Page : de la commande Cegid à la réception ShippingBo Voir le projet
  • 14 août 2025
  • Étude de cas · 27 min

Dawap a relié les commandes d’achat Cegid Y2 aux attendus de réception ShippingBo, puis construit le portail où chaque fournisseur prépare son ASN ligne par ligne. Quantités expédiées, lots, réception réelle et fichier retour RCP restent rattachés à la même histoire métier.

Des interfaces à vérifier sur votre installation
Des interfaces à vérifier sur votre installation
Le module REST et l’explorateur de votre instance permettent de vérifier les opérations réellement disponibles. Les champs et règles propres à votre organisation sont testés avec vos équipes.
Modules et droits déterminent les services visibles
Dolibarr recommande l’explorer de l’instance. Le token, l’utilisateur, l’entité et les modules activés bornent ce qui peut être appelé.
Référence externe, création et validation sont distinctes
L’API documente la lecture d’une commande par ref_ext, la création d’un brouillon puis une action de validation séparée.
Facture et paiements ont leurs propres contrôles
Création depuis une commande, validation et lecture des paiements demandent des droits et des décisions propres au document.
Un mouvement exige produit, entrepôt, quantité et sens
L’API expose l’origine et l’entrepôt, mais le contrôle de la légitimité métier du mouvement reste à la charge du projet.

Guides de cadrage

Préparer votre connexion à Dolibarr

Des guides sur les interfaces, les échanges e-commerce et les reprises.

Vos questions

Vos questions sur l’intégration Dolibarr

Le périmètre, les accès et les conditions de réalisation.

Faut-il développer un connecteur spécifique ?

Pas toujours. Des modules de synchronisation existent, notamment pour l’e-commerce. Nous examinons leur couverture avant de proposer un développement pour les données, règles ou contrôles qui restent non couverts.

Comment vérifiez-vous les possibilités de notre Dolibarr ?

Nous examinons la version, les modules et les droits, puis les opérations visibles dans l’explorateur REST de l’instance. Deux installations peuvent exposer des possibilités différentes.

Pouvez-vous connecter Dolibarr à WooCommerce ?

Oui, selon le périmètre retenu et les interfaces disponibles. Nous définissons les correspondances clients, produits et commandes ainsi que les règles de stock et de validation.

Prenez-vous en compte nos champs personnalisés ?

Oui. Les champs et modules spécifiques sont recensés et intégrés aux correspondances et à la recette. Le comportement de chaque extension est vérifié sur votre environnement.

Comment gérez-vous une réponse manquante après création ?

Nous recherchons le résultat à partir des références conservées avant de relancer une écriture. Les cas incertains sont isolés pour éviter une seconde commande ou un second mouvement.

Pouvez-vous reprendre nos scripts existants ?

Oui. Nous examinons le code accessible et les incidents avant de proposer des corrections ciblées ou une transition progressive vers une intégration maintenable.

Comment estimez-vous le budget et le délai ?

À partir des interfaces, des règles, des champs spécifiques et des tests nécessaires. Le développement, la livraison et la maintenance sont distingués dans la proposition.

Pouvez-vous assurer le suivi après livraison ?

Oui, selon les conditions convenues. Nous définissons les alertes, les interlocuteurs et la prise en charge des adaptations, avec une documentation utilisable par votre équipe technique.

Systèmes connectés

Les échanges respectent les fonctions et les responsabilités de chaque application.

Les profils derrière votre projet

Des interlocuteurs qui comprennent vos flux et votre métier.

Votre sujet : Intégrateur Dolibarr : API et e-commerce sur mesure

Relier un ERP, un CRM ou une application métier demande de trancher les responsabilités autant que les contrats de données. Nous rapprochons architecture, usages et priorités pour livrer des échanges testables et maintenables.

Découvrir l’agence
Portrait de Jérémy Chomel

Direction · architecture

Jérémy Chomel

Conception des API et middlewares, mapping, reprise sur erreur, observabilité et mise en production.

  • API
  • Architecture
  • DevOps
Portrait d’Arnault Frier

Direction · produit

Arnault Frier

Analyse des processus métier, choix du premier flux utile et accompagnement des utilisateurs.

  • Produit
  • Cadrage
  • Formation
Portrait de Loïc Orue

Product Owner / Scrum Master

Loïc Orue

Product Owner / Scrum Master : backlog d’intégration, dépendances SI, recette et coordination des parties prenantes.

  • PO
  • Scrum
  • Backlog

Consultant senior mobilisable

La composition de l’équipe et sa disponibilité sont confirmées selon votre périmètre, les accès nécessaires et le niveau de service attendu.

Votre premier échange

Quelle vente voulez-vous faire entrer proprement dans Dolibarr ?

Présentez votre instance et les logiciels à relier. Nous définirons les échanges, les validations et le premier périmètre à développer.

Étudier mon intégration Dolibarr