Odoo
Integration mit der Buchhaltungssoftware Odoo für Kunden und Rechnungen
Zuletzt aktualisiert am
Die Odoo-Verknüpfung in Tillor exportiert Kunden und gebuchte Rechnungen nach Odoo. Zahlungsberichte nach Odoo folgen in einem späteren Release. Bis dahin nutzen Sie Admisol, wenn Sie Zahlungsberichte automatisch weiterleiten möchten.
Installation
- Gehen Sie zu Einstellungen und öffnen Sie den App Marketplace.
- Suchen Sie die Odoo-Karte und klicken Sie auf Installieren.
- Füllen Sie zuerst unter Verbindung Folgendes aus:
- Odoo-URL - zum Beispiel
https://mijnbedrijf.odoo.comoder nurmijnbedrijf(Tillor ergänzt dann die.odoo.com-URL) - Benutzername - Benutzer mit API-Zugriff
- API-Schlüssel - API-Schlüssel (Odoo: Benutzerprofil > API-Schlüssel)
- Odoo-URL - zum Beispiel
- Klicken Sie auf Weiter zur Datenbank. Tillor ruft die verfügbaren Datenbanken ab (oder lässt Sie den Namen manuell eingeben).
- Wählen Sie die Datenbank unter Datenbank und schließen Sie die Installation ab.
Beim Speichern testet Tillor die Verbindung.
Ein aktives Buchhaltungssystem
Sind sowohl Admisol als auch Odoo installiert, verwendet Tillor Admisol für den Export (feste Priorität). Installieren Sie Odoo nur, wenn Sie Admisol nicht mehr nutzen.
Buchhaltungsparameter (Odoo-App)
Nach der Installation legen Sie die Exportparameter unter Einstellungen der Odoo-App fest (neben URL, Datenbank, Benutzer und API-Schlüssel). Tillor ruft Verkaufsjournale und Erlöskonten live aus Odoo ab. Sie wählen sie über ein Suchfeld (Code und Name).
| Feld in der App | Standard | Bedeutung |
|---|---|---|
| Code Verkaufsjournal | INV | Verkaufsjournal in Odoo mit diesem Code |
| Standard-Erlöskonto | 700000 | Erlöskonto, wenn die Rechnungszeile keine eigene Sachkontonummer hat |
| Rechnungen automatisch buchen | aus | Nach dem Export sofort in Odoo buchen |
| Rechnungs-PDF anhängen | ein | Tillor-Rechnungs-PDF als Anhang an der Odoo-Rechnung |
| Peppol UBL anhängen | ein | Peppol-UBL als zusätzlicher Anhang (nur wenn Tillor diese UBL bereits hat) |
Tillor sucht pro Rechnungszeile zuerst ein Odoo-Konto mit demselben Code wie die Sachkontonummer der Zeile, sonst das Standard-Erlöskonto. Für die MwSt. sucht Tillor in Odoo eine Verkaufssteuer mit demselben Prozentsatz wie auf der Zeile.
MwSt.-Regime
Eine Rechnungszeile mit einem Regime ohne MwSt., etwa Reverse Charge, braucht in Odoo eine eigene Verkaufssteuer: Eine gewöhnliche 0 % landet im falschen Feld Ihrer Steuererklärung. Tragen Sie daher bei den Exporteinstellungen für jedes Regime, das Sie verwenden, den Namen der Verkaufssteuer in Odoo ein, genau so, wie er in Odoo unter Buchhaltung > Konfiguration > Steuern steht (in einem belgischen Odoo zum Beispiel 0% EU S für EU-Dienstleistungen). Es gibt fünf Felder: Reverse Charge (EU-Dienstleistungen), Reverse Charge (Vertragspartner), innergemeinschaftliche Lieferung, Ausfuhr außerhalb der EU und von der MwSt. befreit.
Ist das Feld eines Regimes leer oder existiert die Steuer in Odoo nicht, bricht der Export dieser Rechnung mit einer Fehlermeldung ab. Tragen Sie den Namen ein und senden Sie die Rechnung erneut.
Rechnungs-PDF in Odoo
Mit Rechnungs-PDF anhängen (standardmäßig ein) lädt Tillor dieselbe PDF hoch wie in Tillor. Bei einem neuen Export geschieht das vor dem Buchen in Odoo, damit die Vorschau rechts an der Rechnung verknüpft werden kann. Der Dateiname folgt der Tillor-Rechnungsnummer (z. B. INV_2026_0001.pdf). Tillor setzt diese PDF auch als Hauptanhang an der Odoo-Rechnung.
Unter Ereignisse der Tillor-Rechnung sehen Sie, ob der Export gelungen ist, einschließlich Kunde, Rechnung, PDF und UBL.
- Existiert die Odoo-Rechnung bereits (gleiche Referenz: die Tillor-Rechnungsnummer), aktualisiert Tillor Kunde, Zeilen, Datumsangaben und Zahlungsreferenz. War die Rechnung in Odoo schon gebucht, setzt Tillor sie zuerst auf Entwurf zurück, passt die Daten an und bucht erneut, wenn Rechnungen automatisch buchen aktiviert ist oder die Rechnung bereits gebucht war.
- Danach werden PDF- und UBL-Anhänge ersetzt oder hinzugefügt, wenn diese Optionen aktiviert sind.
- Schlägt der Upload nach einer neu angelegten Entwurfsrechnung fehl, wird diese Odoo-Rechnung gelöscht, damit ein folgender Export es erneut versuchen kann.
Peppol UBL in Odoo
Mit Peppol UBL anhängen (standardmäßig ein) lädt Tillor die Peppol-UBL als zusätzlichen Anhang an der Odoo-Rechnung hoch. Der Dateiname folgt der Tillor-Rechnungsnummer (z. B. INV_2026_0001.xml).
- Tillor erzeugt selbst keine UBL: Die Datei steht erst nach einer erfolgreichen Peppol-Zustellung bereit.
- Ist die UBL zum Zeitpunkt des Exports noch nicht fertig, überspringt Tillor den UBL-Anhang. Sobald die UBL eintrifft, wird sie nachträglich an die bestehende Odoo-Rechnung angehängt.
- Schlägt der UBL-Upload fehl, scheitert der gesamte Odoo-Export nicht (im Gegensatz zur PDF). Nur ein PDF-Fehler nach einer neuen Rechnung macht den Odoo-Entwurf rückgängig.
Rechnungen
- Beim Buchen oder erneuten Buchen einer Rechnung exportiert Tillor die Rechnung automatisch nach Odoo.
- Manuell: Rechnungsaktionen > Export an die Buchhaltung (dieselbe Schaltfläche wie bei Admisol).
- Nur Rechnungen mit dem Status Gebucht werden exportiert.
- Existiert bereits eine Odoo-Rechnung mit derselben Tillor-Rechnungsnummer, wird keine zweite Rechnung angelegt. Tillor aktualisiert Kunde, Zeilen und Datumsangaben dieser Rechnung (zum Beispiel nach dem Verschieben zu einem anderen Kunden oder nach dem erneuten Buchen) und ersetzt PDF-/UBL-Anhänge, wenn diese Optionen aktiviert sind.
- Ändert sich die Rechnungs-PDF nach einer Zahlung (oder ein anderer Betrag auf dem Dokument), ersetzt Tillor den bestehenden PDF-Anhang in Odoo, sobald die neue PDF fertig ist. Es entsteht keine zweite Odoo-Rechnung und in Odoo wird keine Zahlung gebucht.
Kunden
Kunden werden in Odoo mit der Tillor-Kundennummer als Referenz aktualisiert oder angelegt. Bestehende Partner mit derselben Nummer werden aktualisiert.
Zahlungsberichte
Das automatische und manuelle Senden von Zahlungsberichten nach Odoo ist noch nicht verfügbar. Der tägliche Zahlungsbericht-Prozess überspringt Odoo ohne Fehlermeldung.
Voraussetzungen in Odoo
- Verkaufsjournal mit dem eingestellten Code (standardmäßig
INV) - Sachkonten mit Codes, die mit Tillor-Zeilen oder dem Standard-Erlöskonto übereinstimmen
- Optional: Verkaufssteuersätze in Odoo mit denselben Prozentsätzen wie in Tillor