# Integracja Odoo

> Dwukierunkowa synchronizacja firm, kontaktów i szans sprzedaży CRM z Odoo z Twoimi relacjami i wycenami — w Odoo Online, Odoo.sh lub na własnym serwerze.

**Category:** CRM

## Czym jest Odoo?

Odoo to pakiet aplikacji biznesowych — CRM, sprzedaż, fakturowanie, magazyn i więcej — dostępny jako Odoo Online, na Odoo.sh lub we własnej instalacji. Firmy i ich kontakty są w Odoo partnerami (res.partner), a aplikacja CRM śledzi leady i szanse sprzedaży.

## Co jest synchronizowane między Odoo a Transportial

- **Firmy ↔ relacje biznesowe** (W obie strony): Firmy w Odoo i relacje biznesowe w Transportial są synchronizowane w obu kierunkach. Zanim cokolwiek zostanie utworzone, Transportial szuka istniejącego dopasowania po numerze VAT, następnie po numerze izby handlowej, potem po domenie strony internetowej lub e-maila, a na końcu po nazwie — dzięki temu po żadnej stronie nie powstają duplikaty.
- **Kontakty ↔ osoby kontaktowe** (W obie strony): Kontakty firmy w Odoo są utrzymywane w zgodzie z osobami kontaktowymi odpowiadającej jej relacji biznesowej.
- **Szanse sprzedaży ↔ wyceny** (W obie strony): Każda wycena to szansa sprzedaży w CRM przy firmie, a jej etap podąża za statusem wyceny według mapowania etapów, które możesz zmienić. Wygrana i przegrana korzystają z własnych akcji Odoo „wygrana” i „przegrana”. Opcjonalnie oznaczenie szansy sprzedaży w Odoo jako wygranej lub przegranej akceptuje lub odrzuca wycenę; domyślnie ta opcja jest wyłączona.
- **Zlecenia transportowe i faktury → notatki w chatterze** (Do Odoo): Zlecenia transportowe i wysłane faktury są publikowane jako notatki w chatterze firmy w Odoo.

## Jak połączyć Odoo

1. Sprawdź swój plan Odoo: Odoo pozwala na dostęp przez zewnętrzne API tylko w planie Custom.
2. W Odoo utwórz klucz API w Preferences → Account Security. Klucze Odoo są ważne maksymalnie trzy miesiące, więc zanotuj, kiedy trzeba go odnowić.
3. Dodaj integrację Odoo w Transportial, podając adres URL Odoo i klucz API. Dla wersji Odoo starszych niż 19 lub serwera z kilkoma bazami danych podaj też nazwę bazy danych i swój login.
4. Sprawdź ustawienia domyślne: kierunek synchronizacji dla każdego obiektu, zasadę rozwiązywania konfliktów (wygrywa najnowsza zmiana), mapowanie etapów szans sprzedaży, mapowanie pól, to, czy nieznane firmy z Odoo stają się relacjami (włączone), oraz które typy relacji są synchronizowane.

## Częstotliwość synchronizacji i limity

- Z Odoo 19 i nowszymi wersjami Transportial łączy się przez JSON-2 API, ze starszymi przez JSON-RPC.
- Transportial wysyła własne zmiany do Odoo i co 15 minut sprawdza zmiany w Odoo.
- Kierunek synchronizacji ustawia się dla każdego obiektu; gdy rekord zmienił się po obu stronach, domyślnie wygrywa najnowsza zmiana.
- Zmiany zapisane przez Transportial w Odoo nigdy nie są importowane ponownie, więc aktualizacje nie krążą tam i z powrotem.
- Kwoty szans sprzedaży są wyrażone w walucie Twojej firmy w Odoo.

## Typowy przypadek użycia

Firma transportowa prowadzi sprzedaż w Odoo, a planowanie w Transportial. Firmy i kontakty dodane w jednym systemie pojawiają się w drugim, dopasowane po numerze VAT, więc nic nie jest wprowadzane dwa razy. Wyceny z Transportial pojawiają się jako szanse sprzedaży w lejku Odoo, a każde zlecenie i wysłana faktura trafiają do chattera firmy, gdzie widzi je cały zespół sprzedaży.


## Najczęściej zadawane pytania

### Czy to działa z Odoo we własnej instalacji?

Tak. Obsługiwane są Odoo Online, Odoo.sh i serwery we własnej instalacji. Odoo 19 i nowsze używają JSON-2 API; dla starszych wersji lub serwera z kilkoma bazami danych podaj też nazwę bazy danych i login.

### Jakiego planu Odoo potrzebuję?

Odoo pozwala na dostęp przez zewnętrzne API tylko w planie Custom, więc tego planu wymaga integracja.

### Co się dzieje, gdy klucz API Odoo wygaśnie?

Klucze API Odoo są ważne maksymalnie trzy miesiące. Potem Transportial nie może już połączyć się z Odoo, więc utwórz nowy klucz w Preferences → Account Security i wpisz go w integracji.

### Czy wygrana szansa sprzedaży w Odoo może zaakceptować wycenę?

Tak, jeśli to włączysz. Domyślnie szansa sprzedaży tylko podąża za wyceną. Gdy opcja jest włączona, oznaczenie szansy sprzedaży w Odoo jako wygranej lub przegranej akceptuje lub odrzuca wycenę w Transportial.


---
Canonical page: https://transportial.com/pl/integration/odoo
