Integracja Furgonetka: wielu kurierów, jedno API
Zamiast osobnej integracji z każdym przewoźnikiem jedna integracja z Furgonetką. Klient wybiera punkt na wspólnej mapie, a Twój system zamawia przesyłkę, etykietę i śledzenie u tego przewoźnika, którego wybrał.
Agregator czy osobne integracje z przewoźnikami
Furgonetka jest agregatorem. To wygodne, ale nie zawsze najlepsze.
Jedna integracja dla wielu przewoźników i wspólna mapa punktów odbioru.
Po stronie przewoźnika
Kontrola nad usługami
Osobne API przewoźnika daje pełną kontrolę nad jego usługami, agregator częściowo.
Na styku z Furgonetką
Umowy
Przy agregatorze umowa z Furgonetką, przy osobnych API z każdym przewoźnikiem osobno.
W Twoim sklepie
Dla kogo
Agregator dla sklepów, które dają klientowi wybór kuriera. Osobne API dla dużych wolumenów u jednego przewoźnika.
Główny przewoźnik bezpośrednio, reszta przez agregator
- Często łączymy oba podejścia: główny przewoźnik bezpośrednio, a pozostali przez agregator.
- Umowę na pozostałych przewoźników masz wtedy z Furgonetką, a z głównym osobno.
Konto, przesyłka, poprawka
Najpierw jednorazowe połączenie konta Furgonetki przez OAuth2, potem przesyłki z Twojego panelu, a gdy Furgonetka odrzuci przesyłkę, powód widać przy zamówieniu.
Konto bez hasła w sklepie
Właściciel konta loguje się w Furgonetce i wyraża zgodę, a Twój system wymienia kod autoryzacyjny na token JWT. Wcześniej rejestrujemy aplikację z Client ID, Client Secret i adresem powrotu, który prowadzi z powrotem do panelu sklepu. Panel pokazuje potem, które konto Furgonetki jest połączone, kto i kiedy je połączył, a przyciski obok pozwalają połączyć je ponownie albo rozłączyć. Client Secret i tokeny zostają w ustawieniach serwera, nigdy w repozytorium ani w przeglądarce, więc hasło do Furgonetki w ogóle nie trafia do sklepu.
Jeden token dla wszystkich procesów
Aplikacja może mieć do 20 otwartych sesji, a nowa ponad limit unieważnia najstarszą. Dlatego integracja odświeża jeden token, zamiast tworzyć nowe, a tworzenie przesyłek, pobieranie etykiet i sprawdzanie statusów korzystają z tego samego. Panel pokazuje, ile sesji jest otwartych, kiedy token odświeżono i do kiedy jest ważny, a przy każdym procesie, kiedy ostatnio z niego skorzystał. Obok jest klucz mapy punktów z dozwolonymi domenami, bo klucz działa tylko na wpisanych domenach i wersja testowa sklepu potrzebuje własnego wpisu.
Przesyłka u wybranego przewoźnika
Zamówienie niesie przewoźnika i kod punktu wybranego na mapie w koszyku. Przesyłka, etykieta do druku i numer do śledzenia wracają do zamówienia, bez logowania do Furgonetki. Każdy krok zapisuje się w historii zamówienia z godziną i z tym, kto go wykonał: integracja, pracownik albo klient, a statusy przesyłki dopisują się same. Etykietę obsługa drukuje przy pakowaniu prosto z zamówienia, a klient widzi przesyłkę w panelu sklepu.
Odrzucenie z powodem do poprawy
Kod punktu musi należeć do przewoźnika przesyłki, inaczej zamówienie przesyłki się nie uda. Tak dzieje się na przykład wtedy, gdy klient poprosi o inny punkt, a w zamówieniu zostaje przewoźnik z pierwszego wyboru. Powód odrzucenia widać w historii zamówienia, więc obsługa poprawia przewoźnika w panelu i ponawia przesyłkę, bez szukania błędu w logach. Poprawka też zapisuje się w historii, z tym, kto ją wprowadził i co zmienił.
Sieci punktów dostępne na mapie
Wybrane identyfikatory, którymi ogranicza się mapę do przewoźników z Twojej oferty.
W koszyku tego sklepu
- InPost Paczkomaty
inpost - DPD Pickup
dpd - ORLEN Paczka
orlen - Żabka
izidrop - Poczta Polska
poczta
courierServices: ['inpost', 'dpd', 'orlen', 'izidrop', 'poczta']Lista przewoźników i klucz mapy ograniczają mapę do Twojej domeny i przewoźników, których naprawdę oferujesz. Klucz działa tylko na wpisanych domenach, więc wersja testowa sklepu potrzebuje własnego wpisu.
Poza ofertą tego sklepu
- DHL Parcelshop
dhl - UPS Access Point
ups - Allegro One Punkt
allegro - GLS
gls - Furgonetka Punkt
furgonetkaPunkt
Mapa i koszyk pokazują tylko przewoźników, z którymi masz cenę i umowę w Furgonetce. Listę ustawiamy tak, żeby zgadzała się z metodami dostawy w koszyku.
Dostępność punktów zależy od Twojego konta.
Gotowa integracja Furgonetki czy własna
Furgonetka ma integracje z platformami sprzedażowymi i własny koszyk. Kod piszemy dla systemów, których tam nie ma.
Na czym działa sklep
Gotowa integracja istnieje dla platform sprzedażowych, które Furgonetka już obsługuje. Kod piszemy dla systemów, których tam nie ma.
Gdzie powstaje przesyłka
Przy gotowej integracji wysyłki obsługujesz w panelu Furgonetki, przy własnej z panelu, w którym już pracujesz.
Dokumenty i statusy
Własna integracja trzyma etykietę, numer przesyłki i statusy przy zamówieniu, razem z resztą jego historii.
Praca po naszej stronie
Gotową integrację konfigurujesz sam, a my pomożemy, jeśli trzeba. Własną piszemy z REST API Furgonetki i mapą punktów, a kod po odbiorze jest Twój.
Najczęstsze pytania o Furgonetkę
Odpowiedzi o umowach z kurierami, wyborze punktu, Allegro i wycenie.
Czytaj dalej
Inni przewoźnicy i porównanie podejść.
Ilu przewoźników chcesz dać klientom?
Napisz, gdzie sprzedajesz i jakich kurierów chcesz w koszyku. Odpowiemy w godzinę z pytaniami i wyceną.