Konfiguracja kurierów dla serwisu Allegro (Wysyłam z Allegro)

Jeżeli chcemy generować w panelu IdoSell etykiety dla zamówień, w których ustawiony jest kurier dostępny w ramach "Wysyłam z Allegro" nie ma konieczności podawania w konfiguracji kuriera danych logowania. Warto jednak przejść do ustawień danego kuriera, aby zweryfikować domyślne ustawienia kuriera.

Przechodząc do menu: USTAWIENIA > Konfiguracja kurierów > Polska > Wysyłam z Allegro > Dana usługa Na karcie edycji danego kuriera nie ma opcji wprowadzenia danych logowania, ponieważ w tym przypadku nie są one wymagane.  

Aby prawidłowo generować etykiety wystarczy, że wybierzemy domyślne konto Allegro. Jeżeli w ramach jednego panelu obsługujemy zamówienia z różnych kont to etykiety również będą generowane poprawnie dla tego konta, do którego dane zamówienie jest przypisane pomimo, że domyślne konto może być inne.

Jeżeli chcemy, aby etykiety drukowane były na drukarce termicznej warto zmienić format listy etykiety na EPL lub ZPL. Są to dedykowane formaty dla drukarek termicznych. Za pomocą pola "Rozmiar etykiety" możemy również zmienić wymiary wygenerowanego pliku, tak aby etykieta zwracana była na kartce A4 lub A6.

Do prawidłowego generowania etykiet dla wszystkich kurierów w ramach Wysyłam z Allegro wymagane jest uzupełnienie pola Szczegółowe określenie zawartości. Warto zatem na karcie edycji kuriera skorzystać z dostępnych zmiennych i umieścić w tym polu zmienną odpowiedzialną np. za numer zamówienia. Sprawi to, że podczas generowania etykiety system sam umieści numer zamówienia w powyższym polu, a więc nie będzie koniecznym za każdym razem uzupełniać takiego pola ręcznie.  

Aby móc korzystać z usług Wysyłam z Allegro należy dodać konkretną usługę kuriera w ramach profilu dostawy Allegro, aby taka forma dostawy pojawiła się podczas tzw. mapowania usług kurierskich.

Mapowanie usług kurierskich jest to powiązanie formy dostawy z serwisu zewnętrznego np. Allegro z usługą kuriera wprowadzoną w panelu sklepu.

Przechodząc do sekcji USTAWIENIA > Konfiguracja dostawców > Przypisanie usług kurierskich w IdoSell do usług kurierskich serwisów zewnętrznych > Allegro

można zauważyć, że zwracana zostanie tabelka z usługami kurierskimi Allegro.

Grafika wskazuje iż Allegro zwraca do panelu dostępne po swojej stronie formy dostawy "1" (kolumna Usługa kurierska w serwisie zewnętrznym) gdzie w kolumnie oznaczonej "2" (Usługa kurierska w IdoSell) nie są przypisane żadne formy dostawy.

W ramach konfiguracji dążymy do osiągnięcia efektu, w którym takie mapowanie usług pomiędzy serwisem Allegro, a panelem sklepu będzie poprawne tj. aby forma dostawy wybrana przez klienta po stronie Allegro przypisała właściwą usługę w IdoSell. W tym celu w pierwszym kroku należy taką formę dostawy wprowadzić w ramach profilu dostawy dla Allegro.

W tym celu należy kolejno:

Przejść do sekcji USTAWIENIA > Konfiguracja dostawców > Profile dostaw. W ramach profilu dostawy klikamy w opcję "Dodaj kuriera w tym profilu" i wybieramy kraj "Polska".

1. Na liście dostępnych usług kurierskich wyszukujemy kuriera jakiego chcemy dodać w stosunku do włączonego kuriera po stronie serwisu Allegro.

2. Po dodaniu kuriera (w tym przykładzie "Allegro Kurier DHL" będzie należało uzupełnić informacje odnośnie stawki VAT.

4. Ostatnim krokiem konfiguracji będzie przypisanie uprzednio dodanej usługi w sekcji USTAWIENIA > Konfiguracja dostawców > Przypisanie usług kurierskich w IdoSell do usług kurierskich serwisów zewnętrznych > Allegro czyli wybranie z rozwijanej listy w kolumnie "Usługa kurierska w IdoSell" właściwej usługi.

WAŻNE: Należy pamiętać, że Allegro posiada również formy dostawy dla serwisu Allegro.cz czy Allegro.sk, które to też portale posiadają osobne formy dostawy dla mapowania usług.

Chcąc wprowadzić konfigurację dla wprowadzenia form dostawy dla Allegro InPost należy pamiętać o konieczności powiązania konta InPost z Allegro.

W tym celu należy przejść pod adres https://manager.paczkomaty.pl

Pod danym adresem dostępne będą dwie opcje logowania:

1. "Zaloguj" - Jest to logowanie do własnego konta InPost.

2. "Zaloguj przez Allegro" - Jest to logowanie do konta na podstawie danych dostępowych do konta Allegro.

Konfigurując Allegro inPost dla serwisu Allegro niezbędne jest powiązanie takiego konta z kontem Allegro. Stąd też należy niejako zarejestrować konto inPost poprzez właśnie opcję "2" tj. "Zaloguj przez Allegro".

Po zarejestrowaniu konta należy po stronie menadżera paczek InPost wygenerować dane dostępowe do API kuriera. W tym celu zachęcamy do kontaktu z InPost jeśli pojawiłyby się trudności z lokalizacją danej funkcji po stronie panelu InPost.

W kolejnym kroku należy przejść w panelu sklepu do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > InPost.

Na liście dostępnych usług kurierskich należy wybrać formy dostawy dla InPost z przedrostkiem Allegro.

W ramach konfiguracji kuriera należy wprowadzić uprzednio wygenerowane dane dostępowe kuriera (1) jak i wybrać czy w ramach danej formy dostawy ma być dostępny algorytm dzielenia zamówienia na paczki (2).

Po wprowadzeniu danych dostępowych należy dodać dane formy dostawy w ramach konfiguracji dostaw, aby taka forma dostawy była możliwa do zmapowania zgodnie z tabelą mapowania usług kurierskich.

WAŻNE : Powyższa opcja generowania danych dostępowych dla Allegro InPost umożliwia skorzystania z takich danych dostępowych dla usług Allegro tj. Allegro Kurier24 InPost, Allegro miniKurier24 InPost, Allegro Paczkomaty 24/7 InPost. Takie dane dostępowe będą wspólne dla każdego z wymienionych kurierów.

W przypadku usługi Allegro Paczkomaty InPost wszystkie rozmiary możliwym jest skorzystanie z automatycznego przypisywania gabarytów.

W konfiguracji kuriera w sekcji USTAWIENIA > Konfiguracja kurierów > Polska > InPost > Allegro Inpost Paczkomaty wszystkie rozmiary mamy dwa dostępne mechanizmy.

1. Mechanizm A : Jest to mechanizm wykorzystywany z naszej na podstawie rozwiązania automatycznego generowania etykiet w oparciu o wymiary wprowadzone na karcie towaru.

2. Mechanizm B : Jest to mechanizm dzielenia zamówienia na paczki (również odpowiedzialny za przypisanie gabarytu do paczki). Działa on niezależnie od ustawienia mechanizmu A.

Opcja A oznaczona na zrzucie została wprowadzona specjalnie dla sprzedawców którzy nie mają zamówień wielopaczkowych (zawsze jest to jedna paczka) i nie chcą ponosić dodatkowych kosztów związanych z opłatami za przegabarytowanie przesyłek. Powoduje ona włączenie naszego algorytmu plecakowego i wyliczenia rozmiarów ale tylko i wyłącznie na etapie generowania etykiety. Czyli na karcie zamówienia będzie tylko jedna paczka i będzie ona miała gabaryt domyślny, ale w momencie gdy sprzedawca kliknie generowanie etykiety to my całkowicie zignorujemy domyślny gabaryt, sami go wyliczymy i ten wyliczony gabaryt przekażemy do API Inpost.

Opcja B oznaczona na na zrzucie została wprowadzona i działa tylko dla zamówień z Allegro. Chodzi o to aby nasz system przestał dzielić zamówienia z Allegro, a zamiast tego utworzył wiele paczek w ramach jednego zamówienia - a więc wtedy aktywuje się algorytm plecakowy który wylicza ile paczek i w jakim gabarycie jest potrzebne aby spakować dane zamówienie.

WAŻNE : Wyższy priorytet w konfiguracji ma zawsze ustawienie B, które nie jest zależne od mechanizmu A.

W cenniku dostaw po stronie panelu Allegro ustawiamy ile maksymalnie towarów zmieści się w jednej paczce.

Jeśli klient zamówi więcej sztuk towarów w ramach jednego zamówienia, to Allegro przydzieli proporcjonalną ilość etykiet do wygenerowania.

Standardowo w naszym systemie nie ma możliwości generowania więcej niż jednej etykiety, dlatego jedno takie zamówienie z Allegro wpadnie jako kilka oddzielnych w naszym panelu. Tak aby można było wygenerować odpowiednią ilość etykiet.

Mamy jednak możliwość włączenia opcji, dzięki której taki scenariusz nie zaistnieje, i w takiej sytuacji do panelu IdoSell wpadnie jedno zamówienie, w którym będzie możliwość wygenerowania kilku etykiet.

Tą opcją jest właśnie algorytm dzielenia towarów na paczki.

Aby ją włączyć należy przejść do:

USTAWIENIA > Konfiguracja kurierów > Polska > InPost > wybierz usługę.

I zaznaczyć opcję Czy włączyć algorytm dzielenia towarów na paczki, na tak.

Po włączeniu tej opcji, dla tego kuriera zamówienia zawsze będą wpadać w całości i będzie możliwość wygenerowania kilku etykiet.

1. Podczas generowania etykiety dla kuriera zwracany jest błąd "[404] No route matches [POST] /v1/organizations/shipments"

Komunikat informuje odnośnie braku wprowadzonych danych dostępowych dla kuriera. Należy w sekcji USTAWIENIA > Konfiguracja kurierów > Polska > > InPost > wybierz usługę InPostu > wybierz sklep wprowadzić dane dostępowe do API, czyli nr klienta InPost i klucz API, które powinny zostać uzyskane od InPost.

2. Podczas generowania etykiety dla kuriera zwracany jest błąd "invalid_allegro_for_end_of_week_collection"

Komunikat informuje, że Usługa "Paczka w weekend" nie jest dostępna dla przesyłek Allegro. Należy podczas generowania etykiety wyłączyć usługę "Paczka w weekend".

3. Podczas generowania etykiety dla kuriera zwracany jest błąd "info.parcels: too_many"

Komunikat informuje o zbyt dużej ilości paczek w zamówieniu. Należy sprawdzić w formularzu pozakupowym ile jest zdefiniowanych podpaczek i czy w danej usłudze można przygotowywać listy wielopaczkowe.

4. Podczas generowania etykiety dla kuriera zwracany jest błąd" insurance - should_be_greater_than_cod"

Kwota ubezpieczenia powinna być wyższa od kwoty pobrania.
Należy zwiększyć kwotę ubezpieczenia przesyłki podczas generowania etykiety dla kuriera.

1. Dlaczego nie widzę w kolumnie "Usługa kurierska w IdoSell" kuriera do zmapowania??

Brak widoczności na liście usługi wskazuje na brak dodanego takiego kuriera w ramach profili dostaw. Należy przejść do sekcji USTAWIENIA > Konfiguracja dostawców > Profile dostaw. W ramach profilu dostawy klikamy w opcję "Dodaj kuriera w tym profilu" i wybieramy kraj "Polska", a następnie należy dodać brakującą formę dostawy.

2. Podczas generowania etykiety dla kuriera zwracany jest "błąd Serwis zewnętrzny zwrócił następujące błędy: items.description: Opis przesyłki nie może być pusty"

Przechodząc do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > Wysyłam z Allegro > Dana usługga niezbędnym jest wprowadzenie w polu "Szczegółowe określenie zawartości" np zmiennej [iai:order_sn], która zwróci nr zamówienia.

3. Podczas generowania etykiety dla kuriera zwracany jest "błąd /serviceId: Wybrana metoda dostawy nie obsługuje tego zamówienia"

Wskazany komunikat błędu wskazuje na wprowadzone błędne mapowanie usługi kurierskiej. Należy zweryfikować czy usługa kurierska w zamówieniu pokrywa się z usługą w tabeli mapowania.

4. Podczas generowania etykiety dla kuriera zwracany jest błąd "Nie udało się pobrać etykiety dla przesyłki. Serwis zewnętrzny zwrócił następujące błędy: Problem z nadaniem przesyłki. Skontaktuj się z nami. Pomożemy jak najszybciej."

Komunikat błędu wskazuje na problem z wygenerowaniem etykiety dla kuriera po stronie Allegro. Należy w takim przypadku przejść do sekcji USTAWIENIA > Dziennik zdarzeń > Kurierzy i pobrać plik żądania i odpowiedzi dla generowanej etykiety i zgłosić sprawę bezpośrednio do Allegro.

5. Podczas generowania etykiety dla kuriera zwracany jest błąd "additionalServices: Wybrana metoda dostawy nie wymaga podania numeru iban, wpłatę za przesyłki pobraniowe prześlemy na Twoje środki"

Komunikat błędu wskazuje na wprowadzony w konfiguracji kuriera rachunek dla pobrań dla takiego kuriera. Należy przejść do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > Wysyłam z Allegro Wybieramy usługę, i dla pola "Numer konta dla pobrań" należy wybrać opcję "Brak numeru konta"

6. Podczas generowania etykiety dla kuriera zwracany jest błąd "client credentials: Wybrana metoda dostawy nie obsługuje tego zamówienia"

Komunikat odnosi się do usług za pobraniem (COD) dla kuriera Poczty Polskiej. Zgodnie z wymaganiami Allegro, aby móc korzystać z płatności przy odbiorze dla Poczty Polskiej w ramach Wysyłam z Allegro należy posiadać własną umowę podpiętą dla kuriera bezpośrednio po stronie panelu Allegro.

7. Podczas generowania etykiety dla kuriera zwracany jest błąd "items.dimensions: Podane wymiary przesyłki przekraczają maksymalną wagę gabarytową"

Komunikat wskazuje na błędne wymiary w konfiguracji kuriera. Należy przejść do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > Wysyłam z Allegro, a następnie wyszukać usługę, dla której zwracany jest komunikat błędu. W sekcji „Gabaryt własny” należy upewnić się, że podane wymiary są zgodne z wymiarami wymaganymi po stronie Allegro dla danego typu usługi.

WAŻNE : W ramach oznaczeń wymiarów w IdoSell gabaryt własny to kolejno wysokość x szerokość x długość, gdzie po stronie Allegro oznaczenie wymiarów może się różnić. Należy się upewnić, że wprowadzane wartości są zgodnie z wymaganiami Allegro.

8. Podczas generowania etykiety dla kuriera zwracany jest błąd " sender.postCode: Kod pocztowy nadawcy znajduje się poza obszarem One Kuriera"

Komunikat wskazuje, że kod pocztowy nadawcy znajduje się poza lokalizacją obsługi danego kuriera. Należy się upewnić pod adresem https://allegro.pl/kampania/one/kurier czy kod pocztowy nadawcy znajduje się w obrębie świadczonych usług kuriera.

9. Podczas generowania etykiety dla kuriera zwracany jest błąd "Nie udało się pobrać etykiety dla przesyłki. Serwis zewnętrzny zwrócił następujące błędy: label.sender.phone: Wymagany jest poprawny numer telefonu"

Komunikat wskazuje na błędny numer telefonu nadawcy. Należy przejść do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > Wysyłam z Allegro > Dana usługa i sprawdzamy skąd dane nadawcy są pobierane.

a) Dane kontaktowe - Są to dane pobierane z sekcji USTAWIENIA > Dane firmy > Dane kontaktowe 

b) Domyślne dane do dokumentów sprzedaży - Są to dane pobierane z sekcji USTAWIENIA > Dane firmy > Domyślne dane do dokumentów sprzedaży 

c) Dane magazynu, z którego odbywa się wysyłka - dane pobierane są bezpośrednio z adresu magazynu realizującego wysyłkę. Dane pobierane są z sekcji Magazyny (WMS) > Gospodarka magazynowa.

Wybierając magazyn realizujący zamówienie np. M1

10. Podczas generowania etykiety dla kuriera zwracany jest błąd "Serwis zewnętrzny zwrócił następujące błędy: receiver.street: Długość podanego tekstu przekracza 35 znaków"

Komunikat wskazuje na zbyt długi zapis adresu dostawy klienta. Należy skrócić w zamówieniu adres dostawy klienta.