Moduł dostawy REPOST

Co robi integracja

Moduł Repost dodaje dostawę międzynarodową przez Repost Public API.

Gdzie	Co się dzieje
Checkout storefront	Klient widzi aktualne stawki przewoźników, takich jak NPU, DHL, UPS, i wybiera metodę dostawy Repost.
Panel administracyjny Solomono	Menedżer otwiera zamówienie i wysyła je do Repost za pomocą formularza Send to Repost.
Konto Repost	Utworzona przesyłka pojawia się w Repost; etykiety, statusy i dalsza logistyka są obsługiwane w Repost.

 

Zamówienie Solomono zapisuje:

• przewoźnika, cenę, walutę i szablon opakowania wybrane na checkout;

• po pomyślnej akcji Send to Repost — identyfikatory przesyłki Repost oraz numer tracking, jeśli API zwraca tracking od razu.

Ważne. Głównym sposobem utworzenia przesyłki z Solomono jest przycisk Send to Repost. Osobne akcje, takie jak Create / Order synchronization w Repost, należą do samego konta Repost; nie używaj ich do duplikowania przesyłki, która została już utworzona z Solomono.

Przed rozpoczęciem

• Dostęp administratora do sklepu Solomono.

• Konto Repost i API key z konta Repost.

• Adres nadawcy: kraj, miasto, kod pocztowy i ulica.

• Dane kontaktowe sklepu, takie jak telefon lub email właściciela. Są one używane w formularzu nadawcy.

• Waga produktów w kartach produktów. Bez wagi stawki mogą być obliczane według szablonu pudełka i mogą być mniej dokładne.

• W razie potrzeby domyślne miasto i oddział Nova Poshta w Repost: My addresses and branches.

Uwaga. API key jest poufny. Nie umieszczaj go w publicznych zrzutach ekranu, wiadomościach e-mail ani czatach.

 

1. Zarejestruj się lub zaloguj do Repost

1. Otwórz https://repost.global/.

2. Utwórz konto lub zaloguj się do istniejącego konta.

3. Po zalogowaniu otwórz Settings → API.

4. Skopiuj API key. Jeśli klucza jeszcze nie ma, utwórz go w tej sekcji.

5. Upewnij się, że klucz jest włączony i nie wygasł.

Rysunek 1. Konto Repost: ustawienia i sekcja API

2. Włącz moduł w Solo modules

6. Zaloguj się do panelu administracyjnego Solomono.

7. Otwórz Modules → Solo modules.

8. Znajdź Repost delivery service.

9. Upewnij się, że przełącznik w tym wierszu jest włączony.

10. Na tym etapie tylko aktywujesz moduł. Nie wpisuj tutaj API key.

Rysunek 2. Włączony Repost delivery service w Solo modules

3. Wprowadź API key i host w Integrations

11. W panelu administracyjnym otwórz Integrations, a następnie podsekcję Delivery service / Repost.

12. Włącz Repost, ustawiając Enable Repost na true.

13. Wklej API key z konta Repost.

14. W polu API host / Public Host wpisz: https://repost.global

15. W razie potrzeby włącz powiadomienie klienta e-mailem. Po pomyślnym utworzeniu przesyłki klient otrzyma wiadomość e-mail.

Rezultat. Moduł jest połączony z Repost Public API. Bez tego kroku stawki na checkout i formularz Send to Repost nie będą działać.

4. Włącz moduł dostawy Repost

16. W panelu administracyjnym otwórz Modules → Shipping.

17. Znajdź rePost international delivery.

18. Jeśli moduł nie jest zainstalowany, zainstaluj go. Jeśli jest już zainstalowany, otwórz edycję.

19. Włącz moduł, ustawiając Status = True.

20. Wypełnij adres nadawcy: kraj, miasto, kod pocztowy i ulica.

21. W razie potrzeby skonfiguruj strefę, international only, domyślny szablon pudełka, TTL cache stawek, sort order i custom name.

22. Telefon nadawcy nie jest konfigurowany w tym module dostawy. Jest pobierany z kontaktów sklepu, takich jak telefon lub email właściciela.

Rysunek 3. Moduł dostawy: rePost international delivery

5. Sprawdź produkty i adres klienta

23. W kartach produktów upewnij się, że waga produktu jest wypełniona.

24. Na checkout adres dostawy musi zawierać kraj.

25. Jeśli international only jest włączone, kraj dostawy musi różnić się od kraju nadawcy.

26. Klient przechodzi do checkout i wybiera dostępną metodę dostawy Repost, na przykład NPU.

Rysunek 4. Checkout: adres klienta i stawki Repost

Uwaga. W sklepie testowym stawki Repost mogą się nie pojawić, jeśli koszyk nie spełnia minimalnej kwoty, waga produktu lub szablon pudełka nie pasuje, adres nie odpowiada regułom international only lub strefy dostawy, albo API key jest nieprawidłowy lub wyłączony.

6. Wyślij zamówienie do Repost z Solomono

27. Po złożeniu zamówienia otwórz Orders w panelu administracyjnym Solomono.

28. W kolumnie Delivery sprawdź, czy widoczne są rePost international delivery oraz wybrana usługa, na przykład NPU.

29. Otwórz kartę zamówienia.

30. Kliknij Send to Repost, a następnie sprawdź odbiorcę, nadawcę, pudełko, produkty, kody HS, deklarację i przewoźnika.

31. W razie potrzeby pobierz quotes i wybierz aktualną stawkę, a następnie utwórz przesyłkę.

32. Po sukcesie Solomono zapisuje identyfikatory przesyłki i tracking, jeśli API już zwróciło tracking.

33. Jeśli powiadomienie e-mail jest włączone, klient otrzyma wiadomość e-mail.

Ważne. Jeśli Repost pokazuje wskazówkę dotyczącą miasta i oddziału Nova Poshta, jest to ostrzeżenie ustawień konta i nie zawsze oznacza błąd tworzenia przesyłki. Sprawdź My addresses and branches w Repost oraz zweryfikuj, czy przesyłka istnieje w sekcji Shipments.

Rysunek 5. Zamówienie Solomono z dostawą rePost international delivery

7. Sprawdź przesyłkę w Repost

34. Na koncie Repost otwórz Shipments.

35. Znajdź nowo utworzoną przesyłkę. Jeśli została już utworzona przez Solomono, osobna synchronizacja zamówień nie jest wymagana.

36. Sprawdź odbiorcę, przewoźnika lub stawkę, wagę i wymiary.

37. Etykiety i dalsze działania, w tym przyciski takie jak Create, jeśli są potrzebne, są obsługiwane na koncie Repost. Solomono ich nie generuje.

38. Nie twórz drugiej przesyłki od zera w Repost dla tego samego zamówienia, jeśli została już utworzona przez Send to Repost. Spowoduje to powstanie duplikatów.

Rysunek 6. Repost: obsługa przesyłki na koncie; nie duplikuj tworzenia, jeśli przesyłka już istnieje

Rysunek 7. Repost: lista przesyłek

8. Tracking w Solomono

39. Jeśli API od razu zwraca tracking w odpowiedzi na utworzenie przesyłki, jest on zapisywany w zamówieniu Solomono.

40. Jeśli tracking pojawia się w Repost później, obecnie nie ma automatycznej późniejszej ponownej synchronizacji z Solomono.

41. W razie potrzeby skopiuj numer tracking z konta Repost ręcznie.

Typowe problemy

Problem	Co sprawdzić
Repost nie jest widoczny na checkout	Sprawdź Solo modules → Repost delivery service, Integrations → Enable Repost oraz Modules → Shipping → rePost international delivery.
Stawki nie są obliczane	Sprawdź API key i Public Host, wagę produktu lub szablon pudełka, kraj w adresie, international only oraz strefę dostawy.
Formularz Send to Repost ma puste dane	Zamówienie musi mieć adres, telefon, email i kraj; ship-from musi być wypełnione w module dostawy; telefon lub email sklepu musi być wypełniony w kontaktach sklepu.
Kolumna Rates jest pusta w Repost	Formularz Send to Repost musi mieć wybranego przewoźnika, takiego jak npu, który został wybrany na checkout.
Komunikat o oddziale Nova Poshta	Na koncie Repost sprawdź My addresses and branches, domyślne miasto i domyślny oddział.
Tworzenie przesyłki jest duplikowane	Nie otwieraj dwóch kart z Send to Repost jednocześnie. Przy ponownej wysyłce potwierdź resend w UI.
Tracking istnieje w Repost, ale nie ma go w Solomono	Tracking mógł pojawić się po utworzeniu przesyłki. Późniejsza automatyczna ponowna synchronizacja tracking obecnie nie jest dostępna.
Potrzebna jest diagnostyka	Dla specjalisty technicznego: ustaw REPOST_DEBUG=true w hidden configuration.

 

Lista kontrolna

• Konto Repost zostało utworzone.

• API key został utworzony i włączony w Repost → Settings → API.

• Repost delivery service jest włączony w Solomono Solo modules.

• W Integrations włączono Enable Repost, wprowadzono API key i ustawiono https://repost.global.

• Powiadomienie klienta e-mailem jest włączone, jeśli jest potrzebne.

• rePost international delivery jest włączony w Modules → Shipping.

• Adres nadawcy jest wypełniony: kraj, miasto, kod pocztowy i ulica.

• Waga produktu jest wypełniona.

• Stawki Repost są widoczne na checkout dla adresu międzynarodowego.

• Przesyłka została utworzona przez Send to Repost.

• Przesyłka istnieje na koncie Repost, w sekcji Shipments.

• W razie potrzeby skonfigurowano domyślne adresy Repost i oddziały Nova Poshta.