Odoo Community verbinden

Odoo Community ab Version 18 wird über die API angebunden, ohne Modul in Odoo. Rechnungskit fragt Odoo regelmäßig ab und liest nur, es schreibt nichts zurück. Wichtig ist eine Regel: Rechnungen stellt nach dem Verbinden nur noch Rechnungskit aus, nicht mehr Odoo. Was die Odoo-Anbindung leistet

Einrichtung

1. In Odoo die „Automatische Rechnung“ (Automatic Invoice) ausschalten, unter Website → Konfiguration → Einstellungen. Sonst erstellt Odoo bei jeder Online-Zahlung selbst eine Rechnung.

2. In Odoo einen eigenen Benutzer anlegen. Er braucht im Verkauf das Recht „Alle Dokumente“ (All Documents) und in der Buchhaltung „Abrechnung“ (Billing), denn nur damit lassen sich Zahlungen lesen. Im Profil des Benutzers unter „Konto-Sicherheit“ (Account Security) erstellst du den API-Schlüssel.

3. In Rechnungskit unter Verbindungen → Connect: Odoo-URL, Datenbank, Benutzer und API-Schlüssel eintragen und bestätigen, dass Odoo keine Rechnungen erstellt. Sieht der Benutzer mehrere Firmen, wählst du danach die Firma aus, die diese Verbindung lesen soll.

   

4. Rechnungskit prüft die Zugangsdaten und die Rechte mit einem Test-Abruf und übernimmt bis zu 50 Bestellungen der letzten 7 Tage. Ältere Bestellungen holt es nicht nach, und was vor deinem Belegstart liegt, bekommt keinen Beleg.

5. Nutzt du Stripe, stelle die Zuordnung deiner Stripe-Verbindung auf Odoo. Steht sie auf „Stripe Billing“ oder „API“, finden Zahlungen aus dem Odoo-Shop ihre Bestellung nicht und bleiben ohne Beleg. Die Verbindungskarte warnt dann. Abos aus Rechnungskit laufen davon unberührt weiter.

Wie die Daten ankommen

Alle 15 Minuten fragt Rechnungskit, welche Bestellungen, Zahlungen, Lieferungen und Belege sich in Odoo geändert haben. Alle 4 Stunden prüft ein zweiter Abruf die letzten 24 Stunden. Odoos eigene Webhook-Aktion wiederholt nichts, wenn eine Zustellung fehlschlägt, deshalb baut die Anbindung nicht auf ihr auf.

Übernommen werden alle bestätigten Verkaufsaufträge der gewählten Firma, aus dem Webshop und aus dem Backoffice. Angebote und Entwürfe bleiben draußen, ein stornierter Auftrag kommt als Stornierung an.

Ablehnung des Schlüssels oder eine nicht erreichbare Instanz meldet Rechnungskit als Aufgabe. Ab Odoo 18 läuft der API-Schlüssel eines normalen Benutzers nach höchstens 90 Tagen ab: Lege dann einen neuen an und verbinde Odoo erneut. Fehlende Bestellungen der letzten 24 Stunden holt Rechnungskit danach selbst nach.

Nur eine Stelle stellt Rechnungen aus

Zwei Rechnungen zum selben Verkauf können nach § 14c UStG die Umsatzsteuer doppelt auslösen. Rechnungskit übernimmt deshalb nie eine Rechnung aus Odoo und stellt keine zweite aus.

Den Knopf „Rechnung erstellen“ schaltet Odoo Community von Haus aus nicht ab, Rechnungskit kann so einen Beleg nur erkennen. Zeigt eine Bestellung einen gebuchten Beleg aus Odoo, hält Rechnungskit sie an und meldet es als Aufgabe. Was mit dem Odoo-Beleg passiert, klärst du mit deiner Steuerkanzlei.

Zahlungen und Erstattungen

Stripe-Zahlungen findet Rechnungskit über die Stripe-Referenz, die Odoo an der Zahlung speichert, egal ob zuerst die Zahlung oder die Bestellung ankommt. Bei Ware entsteht die Rechnung mit dem Versand, das liest Rechnungskit aus dem Lieferstatus des Moduls für Lagerverkäufe. Dienstleistungen wie Lizenzen werden sofort fakturiert.

Erstattungen über Stripe kommen direkt von Stripe und erzeugen die Stornorechnung. Eine Gutschrift, die jemand in Odoo bucht, wird nie zu einem Storno in Rechnungskit: Sie erscheint wie jeder andere Odoo-Beleg als Aufgabe.

Grenzen, ehrlich benannt

• Diese Anbindung ist neu und wurde bisher mit nachgestellten Odoo-Antworten getestet. Der erste Lauf gegen eine echte Odoo-Instanz steht noch aus. Schau dir deshalb im Testmodus die ersten Bestellungen an, bevor du live gehst.
• Gedacht ist die Anbindung für Odoo Community. Sie erkennt Enterprise und Odoo Online an der Versionsangabe und warnt dann, sperrt aber nicht. In diesen Tarifen gehört Odoos eigene Buchhaltung dazu, deshalb sind sie nicht unser Ziel.
• Odoo Community bringt selbst ein Modul für ZUGFeRD und XRechnung mit. Rechnungskit ersetzt es nach dem Verbinden, damit Rechnungen nur an einer Stelle entstehen.
• Unterstützt wird Odoo ab Version 18. Selbst angepasste Module können Felder oder Abläufe verändern, das erkennt Rechnungskit nur, wenn ein Feld ganz fehlt.
• Der API-Benutzer könnte in Odoo schreiben, weil das Lesen von Zahlungen das Buchhaltungsrecht „Abrechnung“ verlangt. Rechnungskit ruft nur lesende Methoden auf.
• Bestellungen, die nur in Odoo bezahlt wurden, ohne verbundenen Zahlungsanbieter, ordnet Rechnungskit nicht von selbst zu.
• Abos aus Odoo (etwa über OCA-Module) sind nicht vorgesehen, sie würden selbst Rechnungen erstellen. Abos laufen über die Abonnements von Rechnungskit.
• Produkte legt Rechnungskit aus den Bestellungen an, einen eigenen Katalog-Abgleich mit Odoo gibt es noch nicht.