Boxpi API
Globe Pickup Points integruje się z Boxpi, agregatorem logistyki międzynarodowej. Jedno połączenie z API daje Ci ponad 60 usług przewoźników na 16 rynkach europejskich, bez osobnej umowy z każdym przewoźnikiem krajowym. Dzięki tej integracji możesz:
- Eksportować zamówienia do Boxpi bezpośrednio z Shopify
- Drukować etykiety wysyłkowe w Shopify
- Wysyłać do automatów paczkowych, punktów partnerskich i placówek pocztowych lub na adres klienta
- Obsługiwać płatność za pobraniem (COD)
- Synchronizować statusy dostawy z powrotem do Shopify
Włączanie integracji z API Boxpi
Dział zatytułowany „Włączanie integracji z API Boxpi”- W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz Boxpi.
- Wprowadź swój Klucz API — aby go uzyskać, skontaktuj się z obsługą klienta Boxpi. Środowiska produkcyjne i testowe używają różnych kluczy API.
- Wybierz Środowisko — Produkcyjne dla przesyłek rzeczywistych, Programistyczne do testów na testowym API Boxpi. Klucz API musi należeć do wybranego środowiska.
- Skonfiguruj opcje realizacji i tagowania według potrzeb (Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia, Własny tag po eksporcie, Domyślna waga (kg)).
- Przypisz metody wysyłki Shopify do usług Boxpi, z których chcesz korzystać.
Eksportowanie i drukowanie etykiet
Dział zatytułowany „Eksportowanie i drukowanie etykiet”Możesz eksportować zamówienia do Boxpi i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie. Ogólny przepływ pracy opisujemy w artykule Tworzenie etykiet wysyłkowych.
Każde zamówienie jest rejestrowane jako jedna paczka Boxpi. Rejestracja u przewoźnika docelowego jest asynchroniczna — Globe czeka kilka sekund na przydzielenie kodu śledzenia. Jeśli jeszcze nie dotarł, eksport i tak kończy się powodzeniem, a tymczasowo używany jest identyfikator paczki Boxpi; sprawdzanie statusu dostawy zastąpi go prawdziwym numerem śledzenia przewoźnika docelowego, gdy tylko się pojawi.
Boxpi wymaga numeru telefonu odbiorcy przy każdej przesyłce. Zamówienia bez niego są odrzucane przed wysłaniem.
Usługi przewoźników
Dział zatytułowany „Usługi przewoźników”Boxpi jest agregatorem — przewoźnik docelowy jest wybierany dla każdego zamówienia przez usługę, do której przypiszesz metodę wysyłki. Identyfikatory usług mają schemat CARRIER-SERVICE-COUNTRY, na przykład GLS-COURIER-SK, PACKETA-POINT-CZ lub SPS-POSTOFFICE-SK. Środkowa część mówi, w jaki sposób paczka jest dostarczana:
| Usługa | Dostawa |
|---|---|
| COURIER | Na adres klienta |
| POINT | Do punktu partnerskiego lub automatu paczkowego |
| POSTOFFICE | Do placówki pocztowej |
Dostępne są 62 usługi w Austrii, Belgii, Bułgarii, Chorwacji, Czechach, Francji, Niemczech, Grecji, na Węgrzech, we Włoszech, w Luksemburgu, Holandii, Polsce, Rumunii, na Słowacji i w Słowenii — w tym GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT oraz poczta austriacka i słowacka.
Punkty odbioru a dostawa do domu
Dział zatytułowany „Punkty odbioru a dostawa do domu”- Usługi POINT / POSTOFFICE — miejsce docelowe jest adresowane wyłącznie przez punkt odbioru wybrany przez klienta podczas realizacji zamówienia; pola adresu ulicy są ignorowane. Jeśli w zamówieniu nie ma punktu odbioru, eksport zostanie odrzucony.
- Usługi COURIER — wymagane są ulica, miasto i kod pocztowy. Druga linia adresu jest wysyłana jako numer domu, gdy ma 10 znaków lub mniej, w przeciwnym razie jest dopisywana do ulicy. Województwo/region z zamówienia jest przekazywany jako obszar kraju, czego wymagają kurierzy rumuńscy i bułgarscy.
Boxpi weryfikuje punkt odbioru względem własnych list punktów. Identyfikatory punktów z bezpośredniej integracji przewoźnika nie pokrywają się w sposób pewny z identyfikatorami Boxpi, więc metody wysyłki eksportowane przez Boxpi muszą korzystać z punktów odbioru Boxpi w selektorze podczas realizacji zamówienia — zobacz Dodawanie przewoźników z punktami odbioru.
Płatność za pobraniem (COD)
Dział zatytułowany „Płatność za pobraniem (COD)”Boxpi obsługuje COD. Kwota jest pobierana z zamówienia i wysyłana w walucie zamówienia — CZK i HUF są zaokrąglane do pełnych jednostek, pozostałe waluty do dwóch miejsc po przecinku. Część liczbowa nazwy zamówienia jest używana jako symbol zmienny pobrania.
Boxpi weryfikuje walutę względem wybranej usługi. Jeśli COD w tej walucie nie jest dozwolone dla przypisanego przewoźnika, eksport zostanie odrzucony, a przy zamówieniu pojawi się własny komunikat błędu Boxpi.
Włącz opcję Automatycznie aktualizuj status dostawy w Shopify, a następnie Automatycznie oznaczaj zamówienia z dobierką jako zapłacone, aby zamówienia COD były oznaczane w Shopify jako opłacone po dostarczeniu paczki.
Status dostawy
Dział zatytułowany „Status dostawy”Boxpi należy do przewoźników, dla których synchronizacja statusów dostawy jest dostępna. Przy włączonej opcji Automatycznie aktualizuj status dostawy w Shopify Globe odpytuje Boxpi i utrzymuje status realizacji w Shopify w synchronizacji, dzięki czemu możesz filtrować zamówienia według statusu w panelu administracyjnym Shopify:
| Status w Shopify | Opis |
|---|---|
| Tracking added | Zarejestrowana w Boxpi lub u przewoźnika, jeszcze fizycznie nieprzekazana. |
| In transit | Przyjęta w magazynie Boxpi lub przez przewoźnika, w drodze. |
| Out for delivery | W trakcie dostawy do domu lub gotowa do odbioru w punkcie. |
| Failed delivery | Odrzucona przez przewoźnika, anulowana, zagubiona, wracająca lub zwrócona. |
| Delivered | Dostarczona lub dostarczona z pobraną płatnością za pobraniem. |
Opcjonalne ustawienie Realizuj zamówienie dopiero gdy przewoźnik odbierze paczkę odracza utworzenie realizacji w Shopify do momentu, gdy Boxpi potwierdzi, że paczka fizycznie dotarła do przewoźnika, zamiast tworzyć ją w chwili eksportu.
Drukowanie etykiet
Dział zatytułowany „Drukowanie etykiet”Etykiety Boxpi są generowane jako pliki PDF i można je drukować w następujących formatach:
| Format | Pozycji na arkuszu |
|---|---|
| A6 | 1 |
| A4 | 4 (2×2 na jednym arkuszu A4) |
Podczas drukowania A4 możesz wybrać pozycję startową (pozycje 1–4), aby ponownie użyć częściowo zużytych arkuszy etykiet.
Etykiety są tworzone asynchronicznie po stronie Boxpi, więc etykieta istnieje dopiero wtedy, gdy paczka zostanie zarejestrowana u przewoźnika. Jeśli drukujesz zaraz po eksporcie, Globe automatycznie ponawia próby przez kilka sekund.
Etykiety zwrotne nie są obsługiwane przez tę integrację — zwroty trzeba organizować w portalu Boxpi.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”| Problem | Rozwiązanie |
|---|---|
| Uwierzytelnianie Boxpi nie powiodło się | Sprawdź klucz API i upewnij się, że odpowiada wybranemu środowisku — klucze produkcyjne i testowe są różne. |
Invalid Boxpi carrier ID | Metoda wysyłki jest przypisana do wartości, która nie jest usługą Boxpi. Przypisz ją ponownie do usługi w formacie CARRIER-SERVICE-COUNTRY. |
Pickup point must be selected for pickup point delivery | Zamówienie korzysta z usługi POINT lub POSTOFFICE, ale nie ma punktu odbioru. Sprawdź, czy klient wybrał punkt podczas realizacji zamówienia. |
Recipient phone number is missing | Boxpi wymaga numeru telefonu przy każdej przesyłce. Dodaj go do zamówienia przed eksportem. |
Missing required address fields | Usługi kurierskie wymagają ulicy, miasta i kodu pocztowego. Uzupełnij adres wysyłki i wyeksportuj ponownie. |
| Paczka odrzucona przez przewoźnika | Przewoźnik docelowy odmówił przyjęcia przesyłki — Globe pokazuje jego własny komunikat błędu. Popraw dane i wyeksportuj zamówienie ponownie. |
| Etykieta nie jest gotowa na czas | Rejestracja u przewoźnika wciąż trwa. Odczekaj chwilę i wydrukuj ponownie. |
| Punkt odbioru nieakceptowany | Identyfikator punktu nie istnieje na liście Boxpi dla tego przewoźnika. Upewnij się, że podczas realizacji zamówienia dla tej metody wysyłki oferowane są punkty odbioru Boxpi. |