Przejdź do głównej treści
B2Brouter

B2Brouter API z Odoo: środowiska, klucze, wersja i webhooki

API B2Brouter działa z jednym kluczem na środowisko i z datowaną wersją przy każdym wywołaniu. Jeśli wystawiasz faktury w Odoo, konektor B2Brouter ma to już rozwiązane: wybierasz środowisko, wklejasz klucz, a Odoo wysyła faktury i odbiera powiadomienia. Oto czego wymaga API i gdzie to widać w Odoo.

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

Najważniejsze

Moduł
B2Brouter
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0
Czas czytania
3 min

Czego wymaga API B2Brouter

Do API B2Brouter potrzebne jest konto B2Brouter i jego klucz API. Klucz kopiuje się z zakładki Developers tego samego środowiska B2Brouter, w którym będziesz pracować. Klucz testowy nie działa w produkcji i odwrotnie.

Każde wywołanie zawiera też wersję API. Konektor ustawia ją na stałe we wszystkich żądaniach: „X-B2B-API-Version: 2026-06-26”. Jeśli zmienisz tę wartość w Odoo, musi to być data w formacie RRRR-MM-DD. Innego formatu Odoo nie zapisze.

Trzy środowiska i ich adresy

B2Brouter ma trzy środowiska. Produkcja i sandbox używają tego samego adresu, https://api.b2brouter.net. O tym, dokąd trafia wywołanie, decyduje prefiks klucza. Staging ma własny adres, https://api-staging.b2brouter.net.

Konektor sprawdza prefiks przy zapisie klucza i jeszcze raz przed każdym żądaniem:

  • W produkcji przyjmuje klucze zaczynające się od prod_ oraz starsze klucze bez prefiksu.
  • W sandboksie przyjmuje tylko klucze zaczynające się od test_.
  • W stagingu przyjmuje stag_ i test_.

Powód jest prosty. Klucz produkcyjny wklejony do sandboksu wysyłałby prawdziwe faktury i nikt by tego nie zauważył. Konektor zatrzymuje to wcześniej.

W sandboksie wysyłki są symulowane, płatności wyłączone, a podglądy PDF mają znak wodny „test invoice”. To miejsce, by sprawdzić konfigurację bez wysyłania czegokolwiek naprawdę.

Jak Odoo łączy się z API

Konektor ma kreator w B2Brouter › Połącz z B2Brouter. Jego kroki to Powitanie, Środowisko, Pobierz swój klucz API, Połącz i Wykonane.

  1. Zainstaluj konektor w Odoo 17, 18, 19 lub 20 i włącz subskrypcję FlexigoTech Cloud. Konektor potrzebuje jej do działania.
  2. Wybierz środowisko: produkcja, sandbox lub staging.
  3. Skopiuj klucz API z zakładki Developers tego samego środowiska i wklej go.
  4. Jako administrator wyraź zgodę. FlexigoTech Cloud przechowuje klucz zaszyfrowany i otrzymuje go dopiero po tej zgodzie.
  5. Przetestuj połączenie. Jeśli brakuje klucza, Odoo poinformuje o tym przed wywołaniem B2Brouter.
Połączenie B2Brouter w Odoo przez FlexigoTech Cloud
Połączenie przez FlexigoTech Cloud: środowisko, konto, zgoda i klucz przechowywany w chmurze (dane demonstracyjne).

Podpisane webhooki i zadania zaplanowane

B2Brouter informuje o zmianach przez webhooki. Konektor odbiera je pod własnym adresem dla każdej rejestracji, z tokenem, którego nie da się odgadnąć. Sprawdza też podpis HMAC-SHA256 każdego powiadomienia sekretem tej rejestracji. To, co przychodzi, widać w B2Brouter › Dokumenty › Zdarzenia webhook.

Webhooki nie zastępują okresowych sprawdzeń. Konektor wykonuje takie zadania:

  • Wysyłanie kolejki dokumentów, co 5 minut.
  • Przetwarzanie zdarzeń webhook, co 5 minut.
  • Sprawdzanie statusu faktur, co 15 minut.
  • Odświeżanie list kodów, co tydzień.

Listy kodów pochodzą z samego API: schematy, typy dokumentów, kraje, waluty, statusy faktur, języki i rodzaje transportu.

Gdy coś pójdzie nie tak: ID żądania

Każda odpowiedź B2Brouter zawiera identyfikator żądania. Konektor zapisuje ostatni w polu ID ostatniego żądania połączenia. Jeśli zgłaszasz sprawę do wsparcia B2Brouter, podaj tę wartość. Wtedy znajdą twoje wywołanie bez odtwarzania błędu.

Kreator połączenia B2Brouter w Odoo
Kreator połączenia na końcu: konto powiązane z numerem NIP, wykorzystanie planu i kolejne kroki (dane demonstracyjne).

Czego potrzebujesz i czego nie ma w cenie

Potrzebujesz własnego konta B2Brouter i jego klucza API. Opłaty B2Brouter nie są wliczone. Konektor jest w Odoo Apps dla Odoo 17, 18, 19 i 20 i działa z subskrypcją FlexigoTech Cloud. Szczegóły integracji są na stronie konektora.

Czy mogę przetestować API B2Brouter bez wysyłania prawdziwych faktur?

Tak. Wybierz środowisko sandbox i klucz zaczynający się od test_. Wysyłki są symulowane, a pliki PDF mają znak wodny faktury testowej.

Gdzie jest specyfikacja API?

Konektor pracuje z wersją 2026-06-26. Jej specyfikacja OpenAPI jest opublikowana na app.b2brouter.net.

Czy Odoo przechowuje mój klucz B2Brouter?

Przechowuje go FlexigoTech Cloud, zaszyfrowany, i dopiero po zgodzie administratora dla tego połączenia.

Czy muszę coś programować, żeby używać API?

Nie. Konektor wykonuje wywołania razem z podpisem i wersją. Ty wybierasz środowisko i wklejasz klucz.

Czytaj dalej

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

Źródła

  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): README.md
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
  • Kod modułu: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml