Zum Hauptinhalt springen
Zoho Books

Zoho Books API in Odoo: Rechenzentrum, Organisation und Rechnungen mit ihrer Zoho-Nummer

Zoho Books ist auf mehrere Rechenzentren verteilt, und jeder Aufruf der API v3 gilt für genau eine Organisation. Deshalb speichert jedes Konto des FlexigoTech-Konnektors für Odoo das Zoho Data Center und die Organization ID, und alle Lesezugriffe laufen über FlexigoTech Cloud. Die von Zoho ausgestellten Rechnungen und Gutschriften kommen mit ihrer Zoho-Nummer in einem eigenen Journal in Odoo an, und der Konnektor registriert sie nie erneut in VERI*FACTU.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 12. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
4 Min.

Was die Zoho Books API verlangt: Rechenzentrum, Organisation und App

Der Konnektor liest die Zoho Books API v3. Laut der Hilfe zum Feld Zoho Data Center ist Zoho Books nach Regionen aufgeteilt, und Sie wählen das Rechenzentrum aus. Laut der Hilfe zu Organization ID ist Zoho Books mandantenfähig, und jeder API-Aufruf gilt für eine einzelne Organisation.

Sie benötigen außerdem Ihre Zoho-App, deren Client Secret FlexigoTech Cloud aufbewahrt. Die Konten finden Sie unter Zoho Books › Configuration › Accounts, und das Menü Zoho Books enthält außerdem Connect New Account. Jede Organisation wird pro Datenbank nur einmal verbunden.

Wie sich die Zoho Books API über FlexigoTech Cloud verbindet

Das Konto, das Sie anlegen, verbindet sich über FlexigoTech Cloud (Feld Zoho Books connection): Der Konnektor benötigt das Abonnement von FlexigoTech Cloud, Plan Konnektor. Das Konto enthält das Kontrollkästchen I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.

  1. Neues Konto Es sendet das Client Secret seiner Zoho-App einmalig an FlexigoTech Cloud, und FlexigoTech Cloud bewahrt es verschlüsselt auf.
  1. Autorisierung FlexigoTech Cloud wickelt die Autorisierung über Connect with Zoho ab.
  1. Im Alltag FlexigoTech Cloud erneuert den Zugriff und leitet jeden Lesezugriff auf Zoho Books weiter. Sobald FlexigoTech Cloud sie besitzt, behält Odoo keine Kopie des Secrets oder der Tokens.

Woher Rechnungen kommen: geplante Aktion und Webhook

Die geplante Aktion Zoho Books: sync invoices (resilience net) läuft alle 15 Minuten und ist nach der Installation aktiv. Sie fragt bei der API die versendeten Rechnungen nach ihrem letzten Änderungszeitpunkt ab. Der andere Weg ist ein öffentlicher Webhook: Das Webhook Secret ist ein zufälliges Geheimnis, das in dessen URL eingebettet ist.

  1. Ausstellung Zoho Books stellt die Rechnung oder Gutschrift aus; Odoo bucht sie nur.
  1. Eingang Das Dokument kommt über den Webhook an oder wird von der geplanten Aktion abgeholt.
  1. Verarbeitung Der Konnektor ruft es erneut bei Zoho ab und verarbeitet es mit einer einzigen Methode, idempotent, und sperrt dabei seine Zeile, damit sich die geplante Aktion und der Webhook nicht in die Quere kommen.
  1. Buchung Der Konnektor prüft, dass die Nummer, die Odoo der Buchung gibt, die von Zoho ist.

Wie sie in Odoo ankommen und warum sie nicht doppelt registriert werden

Eine Zoho-Rechnung kommt als Kundenrechnung an, eine Gutschrift als Kundengutschrift. Nummer und Referenz der Buchung stammen von Zoho. Nur die Buchungen, die die Synchronisierung bringt, werden im Journal Zoho Books gebucht.

Kundenrechnungen aus Zoho Books in der Odoo-Liste
Aus Zoho Books übernommene Rechnungen mit ihrer Zoho-Nummer, gebucht (Demodaten)
Kundenrechnung im Journal Zoho Books
Rechnung im Journal ‚Zoho Books‘ mit der Zoho-Nummer als Odoo-Nummer (Demodaten)

Jedes Dokument hat eine Zeile mit seiner Zoho Document ID, dem Schlüssel, der Duplikate verhindert, und seiner Zoho Invoice Number.

Solange für das Unternehmen VERI*FACTU von Odoo aktiv ist, warten diese Dokumente ungebucht, mit dem Grund im Protokoll. Das Feld Waiting for VERI*FACTU of Odoo to be off zählt sie.

Laut dem Hinweis der AEAT zum RDL 15/2025 müssen Unternehmen, die Körperschaftsteuer abgeben, ihr Rechnungssystem vor dem 1. Januar 2027 angepasst haben, alle anderen vor dem 1. Juli 2027. Am 5. Oktober 2026 kündigte Hacienda (das spanische Finanzministerium) den Plan an, diese Pflichten bis Oktober 2028 zu verschieben.

Meldungen, die der Zoho-Books-Konnektor anzeigen kann

Jedes Ergebnis (Erfolg, Blockade oder Fehler) wird als eine Zeile unter Zoho Books › Configuration › Sync Log gespeichert. Zu den möglichen Meldungen gehören diese:

  • The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice. Sie erscheint, wenn ein anderes Konto bereits dieselbe Organization ID hat.
  • Wenn das Konto noch keine Organization ID hat, erinnert eine Meldung daran, dass jeder Aufruf eine benötigt.
  • Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted. Sie erscheint, wenn die Nummer der Buchung nicht mit der von Zoho übereinstimmt.
  • Wenn die Währung des Dokuments in Odoo existiert, aber nicht aktiv ist, bittet die Meldung darum, sie zu aktivieren. Existiert sie nicht, weigert sich der Konnektor außerdem, das Dokument in der Unternehmenswährung zu buchen.

Fragen zur Zoho Books API in Odoo

Kann ich dieselbe Organisation in zwei Konten verbinden?

Nein. Eine Zoho-Books-Organisation wird pro Datenbank nur einmal verbunden; ist sie bereits in einem anderen Konto vorhanden, erhalten Sie die Meldung, dass die Organisation bereits verbunden ist.

Was passiert mit einer Position, deren Artikel nicht in Odoo existiert?

Positionen werden anhand ihres Zoho-Artikelverweises den Produkten zugeordnet. Positionen ohne passendes Produkt kommen als generische Dienstleistungsposition nach Steuersatz an, und keine Position geht verloren.

Braucht es das Abonnement von FlexigoTech Cloud?

Ja, der Konnektor benötigt das Abonnement von FlexigoTech Cloud, Plan Konnektor. Das Modul finden Sie auf Odoo Apps und die Details auf der Konnektor-Seite.

Weiterlesen

Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen

  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
  • Quellcode des Moduls: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): views/menus.xml
  • sede.agenciatributaria.gob.es/Sede/iva/sistemas-informaticos-facturacion-verifactu/nota-in
  • www.hacienda.gob.es/sgt/gabsehacienda/nota-informativa-verifactu.pdf