---
title: "OBAPI"
weight: 1
description: "Module Dolibarr d'échange de données B2B via une API REST sécurisée entre instances Dolibarr."
category: "Administration; CRM & Commercial"
type: "module-dolibarr"
---

# 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](https://cap-rel.fr/).

## Support

- Support disponible via le [formulaire de contact CAP-REL](https://cap-rel.fr/sav-module-dolibarr/)
- Documentation du protocole OBAPI : [obapi.org](https://obapi.org)