OBAPI

OBAPI

Présentation

OBAPI (Open Business API) est un module Dolibarr qui permet l'échange de données commerciales entre deux instances Dolibarr (ou tout système compatible) via une API REST sécurisée. Il fonctionne en mode client et/ou serveur :

  • Mode serveur : vous exposez vos factures, commandes, devis, tiers, produits et expéditions à vos clients via un point d'accès REST protégé par JWT.
  • Mode client : vous consultez et importez dans votre Dolibarr les données mises à disposition par vos fournisseurs (factures fournisseur, commandes fournisseur, tiers, contacts).

Pourquoi OBAPI ?

Vous travaillez avec des partenaires qui utilisent aussi Dolibarr. Plutôt que d'échanger des fichiers par email ou de ressaisir manuellement les documents, OBAPI crée un lien direct et sécurisé entre vos deux ERP. Vos clients récupèrent leurs factures en un clic, vous recevez leurs commandes automatiquement.

Fonctionnalités principales

  • API REST complète : factures, avoirs, commandes, devis, tiers, contacts, produits, expéditions, dictionnaires
  • Authentification JWT : connexion par clé pré-partagée temporaire, puis jeton JWT signé
  • Import automatique : import des factures fournisseur, commandes fournisseur, tiers et contacts depuis un serveur OBAPI distant
  • Envoi de commandes : transmission directe d'une commande fournisseur vers le serveur OBAPI du fournisseur depuis la fiche commande
  • Synchronisation des paiements : récupération de l'état des paiements sur les factures fournisseur importées
  • Gestion des droits par client : contrôle fin des objets exposés (lecture/écriture) pour chaque tiers client
  • Journal des accès : traçabilité complète des requêtes API (IP, méthode, URL, code HTTP, user-agent)
  • Onglet dédié sur la fiche tiers : configuration client et serveur regroupée sur un même écran
  • Téléchargement de documents : accès aux PDF des factures, commandes, devis et expéditions via l'API
  • Multi-entité : compatible avec les installations Dolibarr multi-entités

Objets exposés par l'API serveur

Objet Lecture Écriture
Factures Oui Non
Avoirs Oui Non
Commandes Oui Oui (création)
Devis Oui Non
Tiers Oui Non
Contacts Oui Non
Produits Oui Non
Expéditions Oui Non
Dictionnaires Oui Non
Documents PDF Oui Non

Prérequis

  • Dolibarr 14.0 ou supérieur
  • PHP 7.4 ou supérieur
  • Extension PHP sodium (pour le chiffrement des identifiants)

Éditeur

Module développé par CAP-REL.

Support

Installation