XML-RPC funktioniert in Odoo 19 noch, ist aber veraltet, und laut offizieller Dokumentation ist die Entfernung für Odoo 22 vorgesehen. Für alles, was Sie jetzt anfassen, sollten Sie auf die JSON-2-API umsteigen.
Das Portal auf JSON-2 umstellen
- Legen Sie einen eigenen Integrationsbenutzer an, der nur die nötigen Rechte hat.
- Erstellen Sie in den Einstellungen dieses Benutzers unter „Kontosicherheit“ einen neuen API-Schlüssel mit einer klaren Beschreibung und einer kurzen Gültigkeitsdauer. Schlüssel dürfen höchstens drei Monate gültig sein; planen Sie also die Rotation.
- Rufen Sie POST /json/2/sale.order/ gefolgt vom Methodennamen auf und senden Sie den Schlüssel als Bearer-Token im Authorization-Header.
- Jeder Aufruf ist eine eigene Transaktion; verteilen Sie einen Auftrag daher nicht auf viele Aufrufe.
Prüfen Sie auch Ihren Tarif: Laut Dokumentation ist der Zugriff über die externe API nur in den Tarifen Custom verfügbar.
Duplikate vermeiden
- Speichern Sie die Bestellnummer des Portals am Verkaufsauftrag, zum Beispiel in der Kundenreferenz oder einem eigenen Feld.
- Suchen Sie vor dem Anlegen nach dieser Referenz und aktualisieren Sie den Datensatz, statt einen neuen anzulegen, falls er bereits existiert.
Zahlungen
Prüfen Sie zuerst, ob Ihr Zahlungsdienstleister in der Liste unter Konfiguration > Zahlungsanbieter steht. Ein integrierter Anbieter ist besser als ein eigener Webhook. Ist er nicht gelistet, legen Sie eine Automatisierungsregel mit dem Auslöser „Bei Webhook“ an, aktivieren Sie „Aufrufe protokollieren“, halten Sie die URL geheim und testen Sie alles in einer duplizierten Datenbank, bevor Sie live gehen.