Integracja Furgonetka: od aplikacji OAuth do podjazdu kuriera

Furgonetka jako broker w NavyFlame

Furgonetka.pl to broker kurierski: z jednego konta nadajesz przez wielu przewoźników, na umowach Furgonetki albo na własnych. Czym broker różni się od umowy bezpośredniej, wyjaśnia poradnik broker kurierski dla e-commerce, a porównanie z innym popularnym brokerem znajdziesz w tekście Apaczka czy Furgonetka.

Integracja Furgonetka łączy NavyFlame z Twoim kontem przez API Furgonetki. Z zamówienia powstaje przesyłka u przewoźnika, którego wybierasz z listy usług konta. Mogą to być DPD, InPost, DHL, GLS, UPS, FedEx, ORLEN Paczka i Poczta Polska, jeśli masz ich usługi włączone. Adresów nie przepisujesz do drugiego panelu.

Integracja jest w wersji Beta. Wszystko, co opisujemy niżej, jest zbudowane, ale pełnej próby na żywym koncie Furgonetki jeszcze nie zamknęliśmy. Zacznij od środowiska testowego i jednej przesyłki.

Połączenie: własna aplikacja OAuth w Furgonetce

Furgonetka autoryzuje integracje przez OAuth2. Według dokumentacji OAuth Furgonetki zakładasz aplikację, która dostaje Client ID, Client Secret i adres powrotu, a dostęp zatwierdzasz na stronie logowania Furgonetki. Token dostępowy jest ważny 30 dni, a token odświeżania jest jednorazowy: po jego użyciu Furgonetka wydaje nową parę tokenów. Sprawdzono 11 września 2026 r.

Konfiguracja w NavyFlame wygląda tak:

1. W panelu Integracje kliknij Konfiguruj przy Furgonetce i wybierz środowisko: Produkcja albo Testowe (sandbox). Testowe łączy się z osobnym kontem na sandbox.furgonetka.pl, więc aplikację zakładasz wtedy właśnie tam.
2. W panelu Furgonetki otwórz stronę Aplikacje OAuth i dodaj aplikację. Jako adres powrotu wpisz adres, który formularz NavyFlame pokazuje pod polem Client ID. Musi zgadzać się co do znaku.
3. Wklej Client ID i Client Secret aplikacji. Client Secret traktuj jak hasło.
4. Kliknij „Połącz z Furgonetką”, zaloguj się i zatwierdź dostęp. NavyFlame zapisuje tokeny i sam je odnawia, a każdą nową parę zapisuje od razu.
5. Użyj przycisku Testuj połączenie. NavyFlame pobierze listę przewoźników z Twojego konta.

Jeśli autoryzacja kiedyś wygaśnie, ponownie kliknij „Połącz z Furgonetką”. Zapisanego Client Secret nie musisz wpisywać drugi raz.

Usługi, punkty odbioru i etykiety

Furgonetka nie ma jednej usługi domyślnej, dlatego usługę wybierasz w regule wysyłki albo przy ręcznej przesyłce, z listy przewoźników Twojego konta. Usługi na Twojej własnej umowie są oznaczone.

• Sprawdzenie przed nadaniem. Zanim przesyłka powstanie, NavyFlame wysyła jej dane do walidacji w Furgonetce. Błędny kod pocztowy albo brakujący punkt odbioru wychodzi od razu, z komunikatem przewoźnika.
• Punkty odbioru. Wyszukiwarka pokazuje punkty przewoźnika stojącego za wybraną usługą, a nie wszystkie sieci naraz. Możesz też wpisać kod punktu.
• Etykiety. Etykietę zamawiamy w PDF w formacie A6. Drukujesz ją pojedynczo, zbiorczo albo automatycznie przez PrintNode.
• Śledzenie. Statusy Furgonetki zamieniamy na etapy przesyłki w panelu, a numer przesyłki wraca do zamówienia na Allegro i innych obsługiwanych marketplace'ach razem z przewoźnikiem, który faktycznie wiezie paczkę.

Pobranie i adres nadawcy

Przy wysyłce za pobraniem kwotę bierzemy z zamówienia, a numer rachunku do pobrań i jego właściciela podajesz w integracji. Furgonetka nie przyjmuje przesyłki, której zadeklarowana wartość jest niższa niż pobranie, dlatego NavyFlame podnosi wartość do kwoty pobrania. O kosztach i ryzyku pobrań piszemy w poradniku o przesyłkach za pobraniem.

Adres nadawcy bierzemy z przesyłki. Domyślny adres nadawcy z integracji jest używany wtedy, gdy przesyłka nie ma własnego, i to w całości, a nie po kawałku.

Podjazd kuriera i anulowanie

Podjazd zamawiasz na wybrany dzień dla zamówionych przesyłek z etykietą. NavyFlame pobiera z Furgonetki okna odbioru na ten dzień i zamawia podjazd w zaproponowanym oknie. Paczki, dla których Furgonetka nie ma okna tego dnia, na przykład nadawane w punkcie albo u przewoźnika bez podjazdów, są pomijane, a ich liczbę zobaczysz w komunikacie. Jeśli na wybrany dzień nie ma żadnego okna, dostaniesz listę dni, które Furgonetka proponuje.

Przesyłkę z koszyka Furgonetki usuwamy, a zamówioną anulujemy przez API. Gdy Furgonetka zapowiada opłatę za anulowanie, NavyFlame nie zrobi tego za Ciebie. Taką przesyłkę anulujesz w panelu Furgonetki, gdzie widzisz wysokość opłaty.

Czego integracja nie robi

• Nie porównuje cen przewoźników przed nadaniem. Usługę wybierasz sam, w regule albo przy przesyłce.
• Nie rozlicza przesyłek. Za nadania płacisz Furgonetce albo przewoźnikowi na swojej umowie. NavyFlame nie pobiera prowizji od paczki.
• Nie zastępuje ustawień konta Furgonetki. Przewoźników, umowy i rachunki włączasz w panelu Furgonetki.

Pierwsza przesyłka: lista kontrolna

Po udanej próbie w sandboxie połącz konto produkcyjne i włącz regułę dla wybranych zamówień. Cały proces wysyłki w NavyFlame opisuje strona funkcji wysyłek.

Najczęściej zadawane pytania