How can we help you?

Jak zintegrować Mapę od Furgonetki przez API?

Ten artykuł jest przeznaczony dla sklepów, które nie korzystają z wtyczek Furgonetka.pl (WooCommerce, PrestaShop, Shoper, Magento, Sellastik) i chcą samodzielnie zintegrować mapę punktów odbioru bezpośrednio w kodzie swojej strony.

Zobacz, jak zintegrować mapę punktów odbioru przez API | Akademia Furgonetki:

Integracja ręczna składa się z czterech kroków:

1. wygenerowania klucza API
2. załadowania skryptu mapy
3. wywołania widgetu z odpowiednimi parametrami
4. obsługi wybranego punktu przez klienta

• apiKey -  klucz API wygenerowany w Kroku 1 (wymagany).
• courierServices - lista przewoźników, których punkty mają być wyświetlane na mapie. Dostępne wartości: allegro, dhl, dpd, fedex, furgonetkapunkt, gls, inpost, meest, orlen, poczta, ups.
• callback -  funkcja wywoływana po wybraniu punktu przez użytkownika. Jako argument otrzymuje obiekt z danymi wybranego punktu (wymagany).

callback: (params) => {
const kod = params.point.code; // np. 'AGA01N'
const nazwa = params.point.name; // np. 'InPost Paczkomat AGA01N'
const typ = params.point.type; // np. 'inpost'
// zapisz w formularzu zamowienia lub stanie aplikacji
document.getElementById('punkt-odbioru').value = kod;
}

• point.code - kod wybranego punktu (format zależny od przewoźnika, szczegóły w dokumentacji API).
• point.name - pełna nazwa punktu.
• point.type - identyfikator przewoźnika (np. inpost, dpd, orlen).
• point.country_code - kod kraju punktu (np. PL).
• point.furgonetka_point - informacja czy punkt należy do sieci Furgonetka.
• point.cod - informacja czy punkt obsługuje płatność za pobraniem.
   

Wybrany punkt: -

• domena w przeglądarce dokładnie zgadza się z domeną podaną przy generowaniu klucza
• klucz API jest poprawnie przekazany jako parametr apiKey (bez spacji i dodatkowych znaków)
• skrypt mapy jest załadowany zanim wywołasz new window.Furgonetka.Map()
• klient mapy ma status Aktywny na liście klientów w panelu