Przejdź do głównej treści
Zoho Books

Zoho Books API w Odoo: centrum danych, organizacja i faktury z numerem z Zoho

Zoho Books jest podzielone na centra danych, a każde wywołanie jego API v3 dotyczy jednej organizacji. Dlatego każde konto konektora FlexigoTech dla Odoo przechowuje Zoho Data Center i Organization ID, a odczyty przechodzą przez FlexigoTech Cloud. Faktury i noty kredytowe wystawione w Zoho trafiają do Odoo z numerem z Zoho, do osobnego dziennika, a konektor nigdy nie rejestruje ich ponownie w VERI*FACTU.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 12 listopada 2026

Najważniejsze

Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
4 min

Czego wymaga Zoho Books API: centrum danych, organizacja i aplikacja

Konektor odczytuje Zoho Books API v3. Według pomocy pola Zoho Data Center Zoho Books jest podzielone regionalnie i to Ty wybierasz centrum danych. Według pomocy pola Organization ID Zoho Books obsługuje wiele organizacji, a każde wywołanie API dotyczy jednej organizacji.

Potrzebujesz też swojej aplikacji Zoho, której client secret przechowuje FlexigoTech Cloud. Konta znajdziesz w Zoho Books › Configuration › Accounts, a menu Zoho Books zawiera także Connect New Account. Każdą organizację łączysz tylko raz na bazę danych.

Jak Zoho Books API łączy się przez FlexigoTech Cloud

Konto, które tworzysz, łączy się przez FlexigoTech Cloud (pole Zoho Books connection): konektor wymaga subskrypcji FlexigoTech Cloud, planu Konektor. Konto ma pole wyboru I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.

  1. Nowe konto Jednorazowo wysyła client secret swojej aplikacji Zoho do FlexigoTech Cloud, który przechowuje go w postaci zaszyfrowanej.
  1. Autoryzacja FlexigoTech Cloud realizuje autoryzację Connect with Zoho.
  1. Na co dzień FlexigoTech Cloud odnawia dostęp i przekazuje każdy odczyt z Zoho Books. Gdy FlexigoTech Cloud je przechowuje, Odoo nie trzyma kopii sekretu ani tokenów.

Którędy wchodzą faktury: zaplanowana akcja i webhook

Zaplanowana akcja Zoho Books: sync invoices (resilience net) uruchamia się co 15 minut i jest aktywna po instalacji. Pyta API o wysłane faktury według czasu ostatniej modyfikacji. Druga droga to publiczny webhook: Webhook Secret to losowy sekret osadzony w jego adresie URL.

  1. Wystawienie Zoho Books wystawia fakturę lub notę kredytową; Odoo jedynie ją księguje.
  1. Przyjęcie Dokument przychodzi przez webhook albo zostaje pobrany przez zaplanowaną akcję.
  1. Przetwarzanie Konektor pobiera go z Zoho ponownie i przetwarza jedną metodą, idempotentnie, blokując jego wiersz, aby zaplanowana akcja i webhook nie kolidowały.
  1. Księgowanie Konektor sprawdza, czy numer nadany zapisowi przez Odoo jest numerem z Zoho.

Jak trafiają do Odoo i dlaczego nie są rejestrowane dwa razy

Faktura z Zoho wchodzi jako faktura sprzedaży, a nota kredytowa jako nota kredytowa klienta. Numer i odnośnik zapisu pochodzą z Zoho. Do dziennika Zoho Books księgowane są tylko zapisy przyniesione przez synchronizację.

Faktury sprzedaży z Zoho Books na liście w Odoo
Faktury pobrane z Zoho Books z numerem z Zoho, zaksięgowane (dane demo)
Faktura sprzedaży w dzienniku Zoho Books
Faktura w dzienniku „Zoho Books” z numerem z Zoho jako numerem w Odoo (dane demo)

Każdy dokument ma jeden wiersz z Zoho Document ID, kluczem zapobiegającym duplikatom, oraz Zoho Invoice Number.

Gdy dla firmy aktywny jest VERI*FACTU z Odoo, te dokumenty czekają niezaksięgowane, a powód zapisany jest w logu. Pole Waiting for VERI*FACTU of Odoo to be off je zlicza.

Według noty AEAT dotyczącej RDL 15/2025 firmy rozliczające podatek dochodowy od osób prawnych muszą dostosować swój system fakturowania przed 1 stycznia 2027, a pozostałe przed 1 lipca 2027. 5 października 2026 Hacienda (hiszpańskie Ministerstwo Finansów) ogłosiła plan przesunięcia tych obowiązków do października 2028.

Komunikaty, które może pokazać konektor Zoho Books

Każdy wynik (sukces, blokada lub błąd) jest zapisywany jako jeden wiersz w Zoho Books › Configuration › Sync Log. Wśród możliwych komunikatów są:

  • The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice. Pojawia się, gdy inne konto ma już to samo Organization ID.
  • Jeśli konto nie ma jeszcze Organization ID, komunikat przypomina, że każde wywołanie go wymaga.
  • Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted. Pojawia się, gdy numer zapisu nie zgadza się z numerem z Zoho.
  • Jeśli waluta dokumentu istnieje w Odoo, ale nie jest aktywna, komunikat prosi o jej aktywację. Jeśli nie istnieje, konektor odmawia też zaksięgowania go w walucie firmy.

Pytania o Zoho Books API w Odoo

Czy mogę połączyć tę samą organizację na dwóch kontach?

Nie. Organizacja Zoho Books jest łączona raz na bazę danych; jeśli jest już na innym koncie, dostaniesz komunikat o organizacji już połączonej.

Co się stanie z pozycją, której artykułu nie ma w Odoo?

Pozycje są dopasowywane do produktów według odnośnika krzyżowego artykułu z Zoho. Pozycje bez pasującego produktu wchodzą jako ogólna pozycja usługowa według stawki podatku i żadna pozycja nie jest pomijana.

Czy potrzebna jest subskrypcja FlexigoTech Cloud?

Tak, konektor wymaga subskrypcji FlexigoTech Cloud, planu Konektor. Moduł znajdziesz w Odoo Apps, a szczegóły na stronie konektora.

Czytaj dalej

Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła

  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
  • Kod modułu: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
  • Kod modułu: 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