---
title: "FAQ"
weight: 50
description: "Questions fréquentes sur le module OBAPI pour Dolibarr."
---

# FAQ

## Questions générales

### Qu'est-ce que le protocole OBAPI ?

OBAPI (Open Business API) est un protocole ouvert d'échange de données commerciales entre ERP. Il définit un format standard pour exposer et consommer des factures, commandes, devis, tiers et autres objets métier via une API REST. La spécification complète est disponible sur [obapi.org](https://obapi.org).

### Mon fournisseur n'utilise pas Dolibarr. Peut-il quand même utiliser OBAPI ?

Oui. Le protocole OBAPI est indépendant de l'ERP. Tout système capable d'exposer une API REST conforme au protocole OBAPI peut communiquer avec votre module client. Votre fournisseur doit simplement implémenter les points d'entrée du protocole.

### Puis-je utiliser OBAPI uniquement en mode client ou uniquement en mode serveur ?

Oui. Les deux modes sont indépendants. Vous pouvez activer le mode serveur sans jamais utiliser le mode client, et inversement. La configuration de chaque mode se fait séparément dans les [réglages du module](/obapi/configuration).

## Connexion et authentification

### La clé temporaire a expiré avant que mon client ait pu se connecter. Que faire ?

Rendez-vous sur la fiche du tiers client, onglet **Obapi**. Une nouvelle clé temporaire est générée automatiquement à chaque affichage de la page. Transmettez la nouvelle clé à votre client. Vous pouvez aussi augmenter la durée de validité dans la [configuration](/obapi/configuration).

### Mon client reçoit un message "Token expiré". Comment résoudre le problème ?

Ce message indique que le jeton JWT utilisé par le client a expiré. Le client doit relancer la procédure de connexion initiale avec une nouvelle clé temporaire. Fournissez-lui les informations de connexion depuis l'onglet **Obapi** de sa fiche tiers.

### Comment révoquer l'accès d'un client ?

Sur la fiche du tiers client, onglet **Obapi**, cliquez sur **Supprimer l'accès OBAPI**. Le jeton du client est immédiatement invalidé et il ne peut plus accéder à vos données.

## Import de données

### Les factures importées sont-elles validées automatiquement ?

Non. Les factures fournisseur importées via OBAPI sont créées en mode **brouillon**. Vous devez les vérifier puis les valider manuellement. Cela vous permet de contrôler les données avant de les intégrer dans votre comptabilité.

### Un produit référencé dans une facture importée n'existe pas dans mon Dolibarr. Que se passe-t-il ?

Le module recherche le produit selon plusieurs critères : référence produit, référence externe, code-barres, code douanier, référence fournisseur. Si aucune correspondance n'est trouvée, un message d'erreur indique la référence manquante. Vous devez créer le produit ou ajouter la référence fournisseur correspondante avant de réimporter.

### Comment synchroniser les paiements de mes factures fournisseur ?

Sur l'onglet **Obapi** du fournisseur, cochez les factures concernées puis cliquez sur **Synchroniser les paiements**. Le module compare les paiements locaux et distants puis crée les écritures manquantes. Un compte bancaire par défaut doit être configuré pour le tiers.

## Mode serveur

### Quelles données sont accessibles par mes clients via l'API ?

Seuls les objets que vous avez activés dans la [configuration](/obapi/configuration) (paramètre **Liste des objets partagés**) sont exposés. Pour chaque client, vous contrôlez ensuite individuellement les droits de lecture et d'écriture depuis l'onglet **Obapi** de sa fiche tiers.

### Un client peut-il voir les données d'un autre client ?

Non. L'authentification JWT identifie le tiers appelant. Chaque client ne voit que ses propres données : ses factures, ses commandes, ses contacts. Le cloisonnement est garanti par l'API.

### Comment consulter les accès API de mes clients ?

Sur la fiche du tiers client, onglet **Obapi**, un lien en bas de page permet d'accéder au journal des accès filtré pour ce client. Vous y retrouvez la date, l'adresse IP, la méthode HTTP, l'URL demandée, le code de réponse HTTP et le user-agent.

## Problèmes courants

### Le message "Version du serveur distant incompatible" apparaît

Ce message indique que le serveur OBAPI de votre fournisseur utilise la version 1.x du protocole, qui n'est pas compatible avec le client OBAPI 2.0. Demandez à votre fournisseur de mettre à jour son module OBAPI.

### Le bouton "OBAPI: Envoyer la commande" n'apparaît pas

Ce bouton apparaît uniquement si :

- La commande fournisseur est au statut **Validée** ou **Commande envoyée**
- Le tiers fournisseur a une adresse de service OBAPI configurée (champ supplémentaire sur la fiche tiers)

Vérifiez que la connexion OBAPI est bien établie avec ce fournisseur.

### L'erreur "Adresse email manquante" apparaît sur l'onglet serveur

Le mode serveur utilise l'adresse email du tiers comme identifiant de connexion. Ajoutez une adresse email valide sur la fiche du tiers client pour pouvoir générer les informations de connexion.