Konta kurierskie i klucze: InPost, DHL, GLS, UPS

Konto kurierskie w Zaksio to Twoje własne dane dostępowe do API kuriera, adres nadawcy i kilka ustawień. Klucze wpisujesz Ty: to Twoja umowa z kurierem, nie nasza. Bez aktywnego konta z kluczami nie utworzysz przesyłki.

Jak działają konta

• Możesz mieć kilka kont jednego kuriera, na przykład osobne dla dwóch umów albo dla sandboxa i produkcji.
• Jedno konto może być domyślne dla firmy, a konta można przypisać do magazynów: gdy reguła wskazuje kuriera bez konkretnego konta, użyjemy konta domyślnego magazynu, a w razie jego braku konta domyślnego firmy.
• Tryb konta to „Testowy (sandbox)” albo „Produkcyjny”. Tryb musi się zgadzać z tym, skąd pochodzą klucze: klucze testowe nie zadziałają na produkcji i odwrotnie. Zmiana trybu unieważnia wynik testu połączenia.
• Poświadczenia są szyfrowane i nigdy nie wracają do przeglądarki: widzisz tylko, które pola są ustawione. Zapis kluczy zastępuje cały zestaw, więc przy każdej zmianie wpisz od nowa wszystkie wymagane pola.
• Konta, które mają przesyłki lub reguły, nie da się usunąć, tylko wyłączyć (status „Wyłączone”).

Dodawanie konta krok po kroku

1. Wejdź w „Wysyłki”, zakładka „Konta kurierskie”, i kliknij „Dodaj konto”.
2. Wybierz kuriera, nadaj nazwę konta i wybierz tryb. Zacznij od „Testowy (sandbox)”.
3. Uzupełnij „Adres nadawcy”: trafia na etykiety i do protokołu odbioru. Przy kurierach z pobraniem możesz podać „Rachunek do pobrań (opcjonalnie)”, czyli IBAN, na który kurier przekaże pobrania; jeśli kurier bierze rachunek z umowy, zostaw puste.
4. Zaznacz „Magazyny”, z których wysyła to konto, i ewentualnie „Konto domyślne tego kuriera”. Zapisz konto.
5. Na karcie konta kliknij „Klucze”, wpisz dane z poniższych instrukcji i wybierz „Zapisz klucze”.
6. Kliknij „Sprawdź połączenie”. Wykonujemy bezpieczne zapytanie do kuriera i pokazujemy wynik bez ujawniania kluczy.

InPost (ShipX)

Potrzebujesz konta firmowego w Managerze Paczek InPost z uzupełnionymi danymi firmy. Do testów użyj osobnego konta w środowisku testowym InPost (sandbox-manager.paczkomaty.pl), produkcyjne działa pod manager.paczkomaty.pl. Sandbox i produkcja mają osobne konta i osobne tokeny.

1. W ustawieniach konta w Managerze Paczek znajdź sekcję API i wygeneruj token ShipX.
2. Na tej samej zakładce znajdziesz numeryczny identyfikator organizacji (Organization ID).
3. W Zaksio wpisz „Token API ShipX” i „Organization ID”. Trzecie pole, własny sekret webhooka, jest opcjonalne i zwykle zostaje puste.
4. Po zapisaniu konta kliknij „Webhook”, skopiuj adres i wklej go w panelu InPost, w ustawieniach API. Statusy przesyłek InPost przychodzą właśnie webhookiem. „Wygeneruj nowy adres” unieważnia stary adres.

DHL Parcel Polska (WebAPI2)

To „DHL” dla polskiego e-commerce: przesyłki krajowe, pobranie, punkty odbioru. Wymaga krajowej umowy z DHL Parcel Polska i dostępu do panelu DHL24 (dhl24.com.pl). Pola w Zaksio: „Login WebAPI v2”, „Hasło WebAPI v2” i „Numer SAP (numer klienta)”.

• Dane WebAPI generuje się w panelu DHL24. To osobna para login i hasło, a nie login do panelu.
• Numer SAP to siedmiocyfrowy numer klienta z umowy.
• Konto testowe (sandbox dhl24) dostajesz od DHL na zgłoszenie: dane testowe i testowy numer SAP uzyskasz u opiekuna handlowego.

DHL Express (MyDHL API)

DHL Express to usługa międzynarodowa z osobną umową Express. Dostęp do MyDHL API uzyskujesz od opiekuna DHL Express, który przekazuje login i hasło (osobne dla testu i produkcji). Pola w Zaksio: „Login MyDHL API”, „Hasło MyDHL API” i „Numer konta DHL Express (shipper)”, czyli dziewięciocyfrowy numer z umowy. Szczegóły uzyskania dostępu: dokumentacja kuriera lub opiekun handlowy.

GLS Poland (ADE-Plus WebAPI)

1. Użytkownik ADE-Plus musi mieć włączony dostęp do WebAPI. Uprawnienia API uzyskuje się wnioskiem do GLS Poland, zwykle przez opiekuna handlowego.
2. Do testów GLS udostępnia środowisko testowe ADE (ade-test): konto testowe dostajesz na zgłoszenie. Wybierz wtedy tryb „Testowy (sandbox)”.
3. W Zaksio wpisz „Login ADE-Plus (WebAPI)” i „Hasło ADE-Plus”. Opcjonalnie podaj osobny login i hasło do API śledzenia (Track&Trace); puste pola oznaczają użycie loginu i hasła ADE-Plus.

UPS (OAuth)

1. Zaloguj się w UPS Developer Portal (developer.ups.com) kontem UPS.com powiązanym z Twoim numerem klienta UPS.
2. W zakładce Apps utwórz aplikację i dodaj do niej produkty Shipping, Rating, Tracking, Locator i Pickup.
3. Skopiuj Client ID i Client Secret aplikacji. W Zaksio to pola „Client ID aplikacji UPS” i „Client Secret aplikacji UPS”.
4. Wpisz „Numer konta UPS (ShipperNumber)”: sześć znaków alfanumerycznych. Konto musi być powiązane z aplikacją.

Status i ograniczenia konektorów

• InPost, DHL Parcel Polska, GLS Poland, UPS i DHL Express: zaimplementowane według dokumentacji, przetestowane na atrapach, niezweryfikowane na żywo (beta).
• DHL Express: bez pobrania (COD), bez anulowania przesyłki przez API, bez ponownego pobrania etykiety i bez listy punktów odbioru. Przy przesyłkach poza UE wysyłamy tylko prosty opis zawartości i wartość, więc dane celne uzupełnij u kuriera.
• GLS Poland: bez etykiet zwrotnych i ubezpieczenia dodatkowego, a pobranie tylko dla przesyłki z jedną paczką.
• UPS: etykieta PDF jest pobierana przez usługę Label Recovery, więc po utworzeniu przesyłki może pojawić się z krótkim opóźnieniem.

Gdzie to znaleźć w aplikacji

Menu „Wysyłki” (grupa „Magazyn”), zakładka „Konta kurierskie”. Oglądanie wymaga uprawnienia shipping:read, dodawanie kont, wpisywanie kluczy i test połączenia uprawnienia shipping:write. Ekran jest widoczny, gdy w profilu firmy włączona jest cecha shipping (moduł shipping).