Integracja Odoo z Xcellerate OPS: faktury automatycznie w Odoo

Połącz Odoo z Xcellerate OPS, a każda faktura wysłana z OPS automatycznie pojawi się w Odoo jako faktura klienta. Działa to zarówno z Odoo na odoo.com, jak i z własną instalacją. Ten poradnik jest dla administratorów IT MSP i firm usługowych, które prowadzą księgowość w Odoo.

TL;DR

• Potrzebujesz adresu URL Odoo, nazwy bazy danych, loginu i klucza API oraz roli administratora w OPS.
• Gdy faktura przechodzi ze szkicu do wysłanych, OPS tworzy ją w Odoo jako fakturę klienta.
• Po pierwszej synchronizacji sprawdź VAT w Odoo: OPS nie wysyła kodów VAT.

Zanim zaczniesz

• Jesteś administratorem (admin) przestrzeni roboczej OPS.
• Twoje Odoo jest dostępne przez HTTPS z internetu i ma aplikację do fakturowania lub księgowości. Do importu ofert potrzebujesz też aplikacji sprzedaży.
• Znasz nazwę bazy danych i login (e-mail lub nazwa użytkownika) użytkownika Odoo dla integracji.
• Ten użytkownik może tworzyć faktury i partnerów oraz odczytywać zamówienia sprzedaży.
• Zewnętrzne e-fakturowanie nie jest włączone w OPS. Dopóki jest aktywne, integracja z Odoo nie ma zastosowania.

Połączenie Odoo w 6 krokach

Krok 1: utwórz klucz API w Odoo

W Odoo utwórz klucz API dla użytkownika integracji. Zwykle robi się to w preferencjach użytkownika, w sekcji bezpieczeństwa konta. Dokładne menu może się różnić w zależności od wersji Odoo.

Krok 2: otwórz tablicę integracji w OPS

Przejdź do Settings (Ustawienia) → Integrations (Integracje). Jeśli w kolumnie Billing (Fakturowanie) nie ma jeszcze karty Odoo, dodaj Odoo z katalogu.

Tablica integracji z pustymi kategoriami (Mailbox, Authentication, Payments, Billing) i katalogiem dostępnych integracji po prawej.

Krok 3: wpisz dane

Na karcie Odoo wypełnij URL (na przykład https://mycompany.odoo.com), Database, Login i API key. Te nazwy pól są po angielsku w każdym języku interfejsu. Kliknij Save (Zapisz).

Krok 4: przetestuj połączenie

Kliknij Test connection (Testuj połączenie). Po sukcesie potwierdzenie pokaże identyfikator (uid) Twojego użytkownika Odoo.

Krok 5: ustaw Odoo jako cel wysyłki

Kliknij Use for invoice push (Używaj do wysyłki faktur). Karta otrzyma plakietkę Push target (Cel wysyłki).

Krok 6 (opcjonalnie): zaimportuj istniejące dokumenty

W sekcji Manual import from Odoo (Import ręczny z Odoo) wybierz From date (Data początkowa). Kliknij Import companies & invoices (Importuj firmy i faktury) i/lub Import quotes (Importuj oferty).

Co dzieje się po połączeniu

• Automatyczna wysyłka. Gdy faktura przechodzi ze szkicu do wysłanych, OPS tworzy w Odoo fakturę klienta z klientem, datą, terminem płatności, numerem faktury z OPS jako referencją i pozycjami (opis, ilość, cena jednostkowa netto).
• Klienci. OPS szuka partnera po dokładnej nazwie. Jeśli go nie ma, OPS tworzy go jako firmę, z numerem VAT i e-mailem.
• Status na fakturze. Każda faktura pokazuje, czy synchronizacja się udała, i ma przycisk ponowienia.
• Import ręczny. Faktury klienta trafiają do OPS ze statusem płatności. Oferty pochodzą z zamówień sprzedaży w Odoo; potwierdzone zamówienia są oznaczane jako zaakceptowane.
• Oferty z OPS nigdy nie są wysyłane do Odoo.

Dobrze wiedzieć

• Sprawdź VAT po pierwszej synchronizacji. OPS wysyła pozycje bez kodów VAT. Najpierw utwórz jedną fakturę testową i sprawdź VAT w Odoo, zanim zaczniesz fakturować na pełnych obrotach.
• Nowi partnerzy są zawsze tworzeni jako firmy, nawet jeśli to osoba prywatna. W razie potrzeby popraw to w Odoo.
• Import jest zbiorczy: każdy dokument staje się jedną pozycją z kwotą netto, przy założeniu stawki VAT 21%.
• Faktury z OPS otrzymuje tylko jeden system księgowy. Zaimportowane faktury nie są odsyłane do Odoo.
• Aby przestać wysyłać do Odoo, kliknij Stop invoice push (Zatrzymaj wysyłkę faktur).
• Po zapisaniu klucz API nie jest już wyświetlany. URL, baza danych i login pozostają widoczne.

Rozwiązywanie problemów

OPS korzysta ze standardowego adresu JSON-RPC Odoo (Twój URL, a po nim /jsonrpc). Komunikaty są podane tak, jak wyglądają w angielskim interfejsie.

• Odoo authentication failed — check database, login and API key. podczas testu: sprawdź nazwę bazy danych, login i klucz API.
• Odoo authentication failed. lub Odoo RPC error podczas wysyłki lub importu: Odoo odrzuca żądanie. Sprawdź, czy klucz jest nadal ważny i czy użytkownik ma potrzebne uprawnienia.
• Configure this provider first. lub Configure and connect this provider first.: najpierw zapisz dane i przetestuj połączenie.
• Import failed: <error>: przeczytaj błąd, usuń przyczynę w Odoo i uruchom import ponownie.

Dowiedz się więcej o integracjach UE w OPS oraz o sprzedaży i fakturowaniu. Nie masz jeszcze przestrzeni roboczej? Zacznij za darmo, a potem połącz Odoo.