XML-RPC fonctionne toujours dans Odoo 19, mais il est déprécié et la documentation officielle indique que sa suppression est prévue dans Odoo 22. Pour tout ce que vous modifiez maintenant, passez à l'API JSON-2.
Migrer le portail vers JSON-2
- Créez un utilisateur d'intégration dédié disposant uniquement des droits nécessaires.
- Depuis les Préférences de cet utilisateur, sous Sécurité du compte, créez une Nouvelle clé API avec une description claire et une durée courte. Les clés ne peuvent pas dépasser trois mois ; prévoyez donc leur renouvellement.
- Appelez POST /json/2/sale.order/ suivi du nom de la méthode, en envoyant la clé comme jeton bearer dans l'en-tête Authorization.
- Chaque appel constitue sa propre transaction ; évitez donc de répartir une même commande sur plusieurs appels.
Vérifiez aussi votre formule : la documentation précise que l'accès à l'API externe n'est disponible qu'avec les formules tarifaires Personnalisé.
Éviter les doublons
- Enregistrez le numéro de commande du portail sur la commande client, par exemple dans la référence client ou dans un champ dédié.
- Avant toute création, recherchez cette référence et, si elle existe, mettez à jour la commande au lieu d'en créer une nouvelle.
Paiements
Vérifiez d'abord si votre passerelle figure dans la liste sous Configuration, puis Fournisseurs de paiement. Un fournisseur intégré vaut mieux qu'un webhook personnalisé. S'il n'est pas répertorié, créez une règle d'automatisation avec le déclencheur Sur webhook, activez Journaliser les appels, gardez l'URL secrète et testez l'ensemble sur une base dupliquée avant la mise en production.