Set up Wolt Drive integration by running a three-phase flow: check availability with a promise or fee endpoint, create the delivery, then track it through webhooks and a generated tracking URL. Most restaurant and POS integrations should use venueful endpoints, since venues are preconfigured on Wolt's side. Your next move is simple: request staging credentials from your Wolt contact and validate the full flow before anyone issues you production keys.
***
TL;DR:
>
- Większość deweloperów błędnie wybiera niewłaściwe punkty końcowe dla swojego trybu, co zwiększa błędy i komplikuje proces integracji. - Tryb venueful zmniejsza obciążenie i ryzyko błędów dla restauracji o dużym wolumenie, korzystając z prekonfigurowanych danych o lokalach, podczas gdy tryb venueless pasuje do punktów odbioru o niskim wolumenie lub tymczasowych. - Obsługa webhooków musi być oparta na zdarzeniach z idempotentnym przetwarzaniem, aby uniknąć pominiętych aktualizacji statusu i awarii powiadomień dla klientów. - Rozpoczęcie bezpośrednio w produkcji pomija kluczową walidację stagingową, ryzykując problemy z limitami prędkości i niepewne odpowiedzi webhooków podczas działania na żywo. - Kompleksowa integracja obejmuje testowanie wszystkich scenariuszy dostawy, łagodne zarządzanie limitami prędkości oraz planowanie zarządzania poświadczeniami dla płynnego uruchomienia.
***
Table of Contents
- What Wolt Drive Does and Who Should Integrate It
- The Wolt Delivery API Integration Process, Step by Step
- Venueful vs Venueless: Which Endpoint Mode Fits Your Setup
- Onboarding, Authentication, and Environments: SSIO vs WIO
- Implementation Checklist and Pitfalls to Avoid
- How RESTOBOT Ties Wolt Drive Into Your Restaurant's Full Stack
- Sources
- FAQ
What Wolt Drive Does and Who Should Integrate It
Wolt Drive to sieć kurierów ostatniej mili, do której firmy mogą się podłączyć w celu realizacji dostaw ASAP lub zaplanowanych, bez zatrudniania lub zarządzania własnymi kierowcami. Restauracja, sklep spożywczy lub detalista wysyła prośbę o dostawę przez API Wolt Drive, a Wolt zajmuje się przydzielaniem kuriera, trasowaniem i powiadamianiem klientów.
Trzy grupy zazwyczaj budują tę integrację:
- Systemy POS, które chcą kierować zrealizowane zamówienia bezpośrednio do kuriera, bez angażowania pracowników w korzystanie z trzeciej aplikacji
- Kasy e-commerce, które potrzebują na żywo cen dostawy i ETA w punkcie sprzedaży
- Platformy middleware, które organizują dostawy w wielu sieciach kurierskich jednocześnie
Korzyścią dla sprzedawców jest szybkość i zmniejszone koszty: brak personelu do zarządzania dostawami, automatycznie generowany link do śledzenia dla każdego zamówienia oraz logistyka kurierska całkowicie poza Twoimi obowiązkami. Partnerzy integracyjni, tacy jak połączenia systemów POS i wyświetlaczy kuchennych, oferują również dwukierunkowe połączenia plug-and-play dla sprzedawców, którzy wolą całkowicie pominąć niestandardowy rozwój.
The Wolt Delivery API Integration Process, Step by Step
Proces integracji API dostawy Wolt dzieli się na trzy wyraźne fazy, a pominięcie zamówienia lub skrócenie którejkolwiek z nich to miejsce, w którym większość integracji się psuje.
- Sprawdź dostępność i cenę. Zadzwoń do
/shipment-promises, jeśli jesteś w trybie venueful, lub do/delivery-feedla zapytań venueless. Odpowiedź zwraca szacowany czas przybycia oraz cenę dostawy, które powinieneś pokazać klientowi przed potwierdzeniem zamówienia. - Utwórz dostawę. Gdy klient się zobowiąże, zadzwoń do
/deliveries(venueful) lub/delivery-order(venueless). Payload musi zawierać szczegóły odbioru i dostawy, wartość zamówienia oraz flagę czasową: dostawy ASAP są realizowane natychmiast, podczas gdy zaplanowane mają określony czas dostawy. - Śledź i zarządzaj zamówieniem na żywo. Wolt przesyła zmiany statusu przez webhooki, zamiast zmuszać cię do sprawdzania aktualizacji. Oczekuj przejść takich jak przypisanie kuriera, odebranie, kurier w drodze i dostarczone, wraz z adresem URL do śledzenia, który możesz przekazać klientowi bezpośrednio lub osadzić w SMS-ie.
Jeden szczegół zaskakuje prawie każdego programistę za pierwszym razem: Wolt Drive jest naprawdę oparty na zdarzeniach, a nie na żądaniach-odpowiedziach dotyczących statusu. Jeśli twoja architektura systemu zakłada, że będziesz sprawdzać punkt końcowy, aby dowiedzieć się "czy już dostarczono", zbudujesz coś złego. Webhooki są mechanizmem, kropka. Twój nasłuchiwacz musi być na to gotowy od pierwszego dnia.
Szybki fakt: cały proces opiera się na czterech podstawowych punktach końcowych współpracujących ze sobą, /shipment-promises, /delivery-fee, /deliveries i /delivery-order, a wybór niewłaściwej pary dla twojego trybu to najczęstszy wczesny błąd.
Venueful vs Venueless: Który tryb punktu końcowego pasuje do twojej konfiguracji
Tryb venueful zakłada, że twoje miejsce odbioru jest już zarejestrowane jako lokal w systemie Wolt, więc większość twoich zapytań ma mniej pól i mniej miejsca na błędy. Integracja venueful jest zalecana dla większości restauracji, ponieważ adres lokalu, godziny otwarcia i dane kontaktowe są już w systemie. Dzwonisz do /shipment-promises i /deliveries, a Wolt uzupełnia luki na podstawie swoich własnych danych.
Tryb venueless istnieje dla węższego przypadku: jednorazowy punkt odbioru, pop-up lub lokal o bardzo niskim wolumenie, który nie uzasadnia formalnej konfiguracji lokalu. Tutaj przekazujesz pełne szczegóły odbioru i dostawy w każdym pojedynczym zapytaniu przez /delivery-fee i /delivery-order, co oznacza więcej danych do zarządzania i większą powierzchnię na błędy.
- Venueful: mniej pól na zapytanie, wstępnie skonfigurowane dane lokalu, niższy wskaźnik błędów w skali
- Venueless: pełne szczegóły adresowe wymagane za każdym razem, lepiej dostosowane do dynamicznych lub rzadkich lokalizacji odbioru
- Integracja venueful zmniejsza rozmiar payloadu i powierzchnię błędów w systemach POS o wysokiej wydajności
Jeśli budujesz dla sieci, grupy franczyzowej lub jakiejkolwiek restauracji oczekującej regularnego wolumenu zamówień, venueful jest praktycznym domyślnym rozwiązaniem. Venueless ma sens dla food trucka realizującego trzy zamówienia w tygodniu z innego rogu za każdym razem.
Wskazówka profesjonalna: *Jeśli nie jesteś pewien, który tryb pasuje do twojego modelu biznesowego, porozmawiaj ze swoim przedstawicielem Wolt przed napisaniem jakiejkolwiek linii kodu. Zmiana trybów po uruchomieniu oznacza przebudowę struktury payloadu i ponowne testowanie całego procesu.*
Wprowadzenie, uwierzytelnianie i środowiska: SSIO vs WIO
Każda integracja Wolt Drive zaczyna się w środowisku staging, a nie produkcyjnym. To nie jest sugestia; tokeny handlowców produkcyjnych są wydawane dopiero po przejściu walidacji integracji w środowisku staging, więc zaplanuj czas na prawdziwe testy, zanim oczekujesz kluczy na żywo.
Samo wprowadzenie dzieli się na dwie ścieżki:
- SSIO (integracja samoobsługowa): aktywujesz i zarządzasz lokalami przez własny interfejs, co daje ci kontrolę nad czasem wdrożenia
- WIO (integracja prowadzona przez Wolt): Wolt wdraża lokale w twoim imieniu, co odpowiada handlowcom, którzy wolą nie budować narzędzi do aktywacji lokali
- Uwierzytelnianie zazwyczaj działa na tokenie handlowca lub podstawowej autoryzacji dla podstawowych żądań, chociaż niektóre punkty końcowe używają wzorców OAuth lub JWT
- Większość przepływów wydaje jeden token na handlowca, więc zaplanuj przechowywanie i rotację poświadczeń wokół jednego aktywnego klucza, a nie tokenów na lokal
Zamów poświadczenia stagingowe wcześnie. Różnica między "mój kod się kompiluje" a "mój kod przetrwał rzeczywiste opóźnienie kuriera" pojawia się dopiero wtedy, gdy testujesz w środowisku stagingowym Wolt z rzeczywistym identyfikatorem testowego lokalu.
Lista kontrolna wdrożenia i pułapki do unikania
Przejdź przez tę listę, zanim napiszesz swoje pierwsze żądanie produkcyjne:
- Potwierdź, że masz poświadczenia stagingowe i ważny identyfikator testowego lokalu.
- Zbuduj punkt końcowy nasłuchujący webhooki z logiką ponawiania i opóźnienia, a nie prosty odbiornik, który cicho zawodzi przy przerwanym połączeniu.
- Obsługuj odpowiedzi HTTP 429 dotyczące limitu szybkości w sposób elegancki, zamiast natychmiast ponownie uderzać w punkt końcowy.
- Napisz obsługę błędów dla źle sformatowanych adresów, brakujących pól i nieoczekiwanych kluczy odpowiedzi.
- Skonfiguruj dostarczanie URL do śledzenia i, jeśli to istotne, treść powiadomień SMS dla zamówień lokalowych.
- Testuj zarówno przepływy dostarczania ASAP, jak i zaplanowane, a nie tylko ścieżkę szczęśliwą.
- Symuluj opóźnienia kuriera i scenariusze dodatkowych opłat za małe zamówienia przed uruchomieniem, a nie po pierwszym telefonie od zdenerwowanego klienta.
Najczęstszą pułapką jest rozpoczęcie pracy nad integracją bezpośrednio w produkcji, całkowicie pomijając walidację stagingową, ponieważ "dokumentacja wygląda wystarczająco prosto." Blisko drugiego miejsca znajduje się krucha obsługa webhooków: nasłuchujący, który nie może przetrwać duplikowanego zdarzenia lub ponownego połączenia sieciowego, ostatecznie przegapi dostarczony status i pozostawi klienta wpatrującego się w nieaktualną stronę śledzenia. Osoby z branży deweloperskiej konsekwentnie wskazują na idempotentne obsługiwacze webhooków z logiką de-duplikacji jako rozwiązanie, ponieważ ponowne próby Wolt mogą w przeciwnym razie wywołać to samo zdarzenie dwa razy po twojej stronie.
Dla konfiguracji bezlokalowych, niespójne formatowanie adresów w różnych żądaniach to cichy zabójca. Punkt końcowy opłat za dostawę Wolt czasami "najlepiej zgaduje" niejednoznaczny adres, zamiast odrzucić go całkowicie, co oznacza, że niechlujny ciąg adresowy może cicho skierować kuriera do niewłaściwego budynku, zamiast zgłosić błąd, który byś zauważył.
Pro Tip: *Traktuj limity szybkości jako ograniczenie projektowe, a nie przypadek brzegowy. Jeśli twój system grupuje tworzenie zamówień w czasie lunchu, wprowadź teraz ograniczenie żądań, zamiast odkrywać odpowiedzi 429 w produkcji w najruchliwszy piątkowy wieczór.*
Jak RESTOBOT łączy Wolt Drive z pełnym stosem twojej restauracji
Surowa dokumentacja API mówi ci, jak wywołać punkt końcowy. Nie mówi ci, co się dzieje z tym żądaniem dostawy po tym, jak twoja strona internetowa przyjmuje zamówienie, ani jak aktualizacje statusu faktycznie docierają do twojego personelu kuchennego. To jest luka, którą platforma taka jak RESTOBOT ma na celu wypełnić.
RESTOBOT generuje stronę internetową restauracji i osadzoną kartę zamówień automatycznie po potwierdzeniu aplikacji, a zamówienia składane przez tę stronę lub bota zamówień Telegram synchronizują się bezpośrednio z panelem zarządzania. Stamtąd można utworzyć prośbę o dostawę i przekazać ją do sieci kurierów, takich jak Wolt Drive, bez konieczności ręcznego wprowadzania adresu przez pracownika do osobnej aplikacji. Aktualizacje statusu webhooka wracają do tego samego panelu, więc "kurier odebrał" i "dostarczono" pojawiają się tam, gdzie restauracja już obserwuje, w czasie rzeczywistym.
RESTOBOT nie pobiera żadnej prowizji od zamówień, niezależnie od tego, jak dostawa jest realizowana, czy to samodzielna dostawa, czy usługa kurierska obsługująca ostatnią milę. Dla restauracji rozważającej platformę w porównaniu do dedykowanego rozwiązania: bezpośrednia integracja daje pełną kontrolę nad każdym polem w ładunku, ale oznacza również posiadanie infrastruktury webhooka, walidacji stagingowej i mapowania POS samodzielnie. Trasa platformy wymienia część tej szczegółowej kontroli na szybsze wdrożenie i mniejsze obciążenie inżynieryjne, co ma największe znaczenie dla restauracji bez dedykowanego dewelopera w zespole.
*— ADMIN*
FAQ
Czy Wolt działa w Stanach Zjednoczonych?
Sieć dostawcza Wolt nie jest dostępna w Stanach Zjednoczonych. Działa na dużym obszarze rynków europejskich, nordyckich i wybranych międzynarodowych, więc firmy z siedzibą w USA, które szukają integracji z kurierami na żądanie, muszą ocenić dostawców aktywnych w swoim kraju.
Czy Wolt został przejęty przez DoorDash?
Wolt nadal działa pod marką Wolt na swoich istniejących rynkach, zamiast być włączonym do innej sieci usługowej.
Jak zintegrować API Google Drive?
Integracja API Google Drive jest osobnym produktem od Wolt Drive i obejmuje konfigurację projektu Google Cloud, dane uwierzytelniające OAuth oraz punkty końcowe specyficzne dla Drive do przechowywania i udostępniania plików. Nie ma technicznego pokrycia z logistyką dostaw restauracyjnych ani punktami końcowymi Wolt Drive omówionymi w tym przewodniku.
W jakich krajach dostępny jest Wolt?
Wolt działa w dziesiątkach krajów, skoncentrowanych głównie w Europie, a także w kilku rynkach na Bliskim Wschodzie i w Azji. Zasięg różni się w zależności od miasta, więc sprawdź dostępność bezpośrednio u swojego kontaktu w Wolt przed zbudowaniem integracji specyficznej dla lokalu.
Czy powinienem wybrać tryb Venueful czy Venueless dla mojej restauracji?
Tryb Venueful jest praktycznym domyślnym wyborem dla restauracji i integracji POS, ponieważ lokale są wstępnie skonfigurowane, co zmniejsza rozmiar ładunku i redukuje obszar błędów. Tryb Venueless ma sens tylko dla jednorazowych punktów odbioru lub bardzo niskowolumenowych lokalizacji, które nie uzasadniają formalnej konfiguracji lokalu.