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.
- Zainstaluj konektor w Odoo 17, 18, 19 lub 20 i włącz subskrypcję FlexigoTech Cloud. Konektor potrzebuje jej do działania.
- Wybierz środowisko: produkcja, sandbox lub staging.
- Skopiuj klucz API z zakładki Developers tego samego środowiska i wklej go.
- Jako administrator wyraź zgodę. FlexigoTech Cloud przechowuje klucz zaszyfrowany i otrzymuje go dopiero po tej zgodzie.
- Przetestuj połączenie. Jeśli brakuje klucza, Odoo poinformuje o tym przed wywołaniem B2Brouter.

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.

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
