FAQ

Un webservice peut-il lire les tiers des autres ?

Non. Le seul droit de lecture accordé porte sur le catalogue du préfixe de l'appelant. La création d'un tiers dédoublonne certes sur le SIREN dans tout le fichier des tiers, de sorte qu'une société cliente de deux services ne compte qu'un seul tiers ; mais l'appelant n'obtient que l'identifiant du tiers qu'il a demandé, et jamais la fiche de ceux des autres services.

Pourquoi le lien de paiement vient-il du module, et non du webservice ?

Parce que la clé de sécurité de ce lien dérive d'un jeton global à l'instance Dolibarr. La confier à un webservice lui donnerait de quoi forger le lien de paiement de n'importe quelle commande de la maison. Le verbe de validation renvoie donc le lien tel que Dolibarr l'a construit.

Deux appels portant la même référence d'acte créent-ils deux commandes ?

Non. La référence d'acte sert de clé d'idempotence : le second appel renvoie la commande existante. Une commande émise deux fois, ce serait un abonnement encaissé deux fois.

Un service sans prix peut-il figurer sur une facture ?

Non, le verbe de commande le refuse. Un service créé sans prix vaut zéro, et non "non renseigné" : la facture à zéro est précisément le risque contre lequel ce refus protège. Corrigez la fiche produit, car le prix relève d'une décision commerciale qui se saisit dans Dolibarr.

Que se passe-t-il si une notification de règlement se perd ?

Le règlement demeure encaissé côté Dolibarr, et la notification reste inscrite au journal avec son état. Le verbe d'état de règlement la rejoue dès que le client final s'enquiert de sa situation, le bouton du journal permet de la renvoyer à la main, et le cron retente les échecs. Le webservice n'a jamais à reconstituer le lien de paiement, et il n'en a d'ailleurs pas les moyens.

Peut-on annuler une commande déjà réglée ?

Non, car une annulation ne rembourse rien. Un acte déjà réglé se corrige par un avoir partiel, qui ne porte que sur la ligne concernée et laisse intacte la facture d'origine, ainsi que les autres actes qu'elle contient.