Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak klient wybiera Paczkomat w Shopify
Wybór punktu zależy od planu, bo Shopify pozwala zmieniać checkout w różnym stopniu. Na Shopify Plus Paczkomaty mogą pojawić się jako punkty odbioru bezpośrednio na etapie dostawy: robi to funkcja Shopify generująca punkty odbioru (pickup point delivery option generator) albo rozszerzenie checkoutu z mapą InPost Geowidget. Na planach Basic, Grow i Advanced własnych elementów na etapie dostawy dodać nie można, więc mapa Geowidget stoi w koszyku przed przejściem do płatności, a jako zabezpieczenie także na stronie z podziękowaniem i statusem zamówienia. Punkty odbioru na etapie dostawy dodaje się przez Shopify Functions i rozszerzenia checkoutu, które aplikacje szyte na miarę mogą używać tylko w Shopify Plus. Stawki liczone na żywo przez przewoźnika (Carrier-Calculated Shipping) wymagają wyższego planu lub dokupienia tej opcji, stałe stawki działają na każdym planie.
Kod wybranego Paczkomatu zapisuje się w atrybutach lub metapolu zamówienia. Integracja sprawdza go w API InPost, zanim utworzy przesyłkę, więc nieaktywny lub literówkowy punkt nie przechodzi dalej.
Przesyłka i etykieta przez ShipX API
Nowe zamówienie (orders/create) albo wybrany moment w magazynie uruchamia utworzenie przesyłki w ShipX API: odbiorca, telefon, e-mail, gabaryt (A, B lub C) i kod Paczkomatu. Etykietę pobieram jako PDF w formacie A4 lub A6 albo jako ZPL na drukarkę termiczną. Przy kurierze InPost integracja może też zamówić odbiór paczek z magazynu. ShipX API obsługuje też pobranie i ubezpieczenie. Integracja używa dwóch tokenów, do ShipX API i do mapy Geowidget, które generujesz w Managerze Paczek. Testy idą na sandbox ShipX, gdzie etykiety są próbne. Jeśli wysyłasz z własnego magazynu lub WMS, przesyłkę można zakładać stamtąd zamiast z Shopify.
Co wraca do Shopify
Po utworzeniu przesyłki integracja zakłada realizację zamówienia (fulfillment) w Shopify z numerem przesyłki i linkiem do śledzenia InPost. Shopify wysyła klientowi standardowy e-mail o wysyłce, a obsługa widzi numer w panelu. Zmiany statusu przesyłki przychodzą z InPost przez webhooki, więc dostarczenie do Paczkomatu i odbiór można oznaczać w zamówieniu. Te same statusy mogę przekazywać do CRM, ERP lub systemu zwrotów.
Błędy i przypadki brzegowe
Każde zlecenie przechodzi przez kolejkę z ponowieniami. Gdy ShipX odrzuci przesyłkę (zły telefon, zbyt duży gabaryt, brak punktu), zamówienie dostaje tag z powodem, a Ty e-mail. Osobno ustawiamy zamówienia z kilkoma paczkami, częściowe realizacje, pobranie i zwroty przez InPost.