FedEx

W przypadku konfiguracji kuriera aby konfiguracja była kompletna należy w pierwszej kolejności zapoznać się z artykułem "Ustawienia kurierów"

Żeby móc skorzystać z usług kurierskich za pośrednictwem własnej umowy z kurierem należy w pierwszej kolejności posiadać podpisaną umowę z kurierem na świadczenie usług kurierskich.

W kolejnym kroku przechodzimy do sekcji USTAWIENIA > Konfiguracja dostaw > Profile dostaw. Edytujemy profil dostawy, w którym taki kurier miałby być dodany.

Klikamy edycję profilu dostawy i w samym profilu klikamy opcję Dodaj kuriera w tym profilu > Polska > FedEx

WAŻNE : Dodając kuriera dla wysyłki zagranicznej np. dla kraju Niemcy również wybieramy dodając kuriera kraj Polska, ponieważ z kraju Polska realizowane są wysyłki.

Aby skonfigurować wskazaną usługę kuriera należy przejść do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > FedEx

Konfiguracja kurierów na umowach własnych w ramach wbudowanych integracji opiera się w głównej mierze na wprowadzeniu właściwych danych API dostępowych kuriera.

Takie dane należy uzyskać bezpośrednio od takiego kuriera i wprowadzić w konfiguracji.

Ważne : Powyższa konfiguracja ma charakter ogólny. Tzn. wybierając kuriera FedEx, dany kurier może posiadać w ramach oferty różne usługi dostaw np FedEx Polska Paczka - standard czy np. FedEx Polska Paczka Odbiór w Punkcie. Chcąc więc skonfigurować zarówno dostawę do klienta, jak i dostawę do punktu stosowne konfiguracje należy dodać osobno dla danej usługi kuriera.

1. W ramach konfiguracji kuriera FedEx należy wprowadzić dane dostępowe kuriera w pole Klucz API(1) , Identyfikator nadawcy w systemie FedEx(2) i Numer kuriera (3).

2. Ustawienia dodatkowe :

Sekcja 1 - Są to ustawienia wynikające bezpośrednio z umowy z FedEx np. dla pola "Sposób płatności za usługę"

Numer konta dla pobrań - aby w danej sekcji można było dodać dany rachunek dla pobrań, który został dodany po stronie panelu klienta FedEx, należy przejść do sekcji USTAWIENIA > Płatności  a następnie w ramach profilu płatności sklepu uzupełnić sekcję bank dla pobrań. Dopiero po dodaniu takiego rachunku z listy kont w ramach kuriera możliwym będzie wybranie takiego rachunku.

Sekcja 2: - Wskazane pole odnosi się do pola, wykorzystywanego podczas generowania etykiety jako określenie zawartości zamówienia. Dane pole powinno zostać uzupełniane w ramach każdego z kurierów, jako że w zależności od kuriera dana sekcja może mieć charakter wymagany aby móc wygenerować etykietę. Informacje z takiego pola mogą skutkować zwróceniem w zależności od kuriera takich informacji na samej etykiecie kuriera.

Sekcja 3: Są to ustawienia dodatkowe dla kuriera. Zwykle dane ustawienia są usługami dodatkowo płatnymi tj np. "Wniesienie". Dlatego też w przypadku takich ustawień warto przed uruchomieniem danych opcji skonsultować ustawienia i opłaty bezpośrednio z opiekunem klienta w FedEx

Sekcja 4: Opcje włączenia ubezpieczenia dla kuriera. z podziałem na pobrania i przedpłaty.

Sekcja 5: Format wydruku etykiety dla kuriera i domyślne ustawienia wymiarów dla generowanych etykiet.

WAŻNE: W przypadku generowanych etykiet na podstawie umów własnych poniższe rozwiązania mają charakter poglądowy wynikający z ustawień panelowych. Natomiast w przypadku pojawienia się komunikatów niezawartych w artykule zachęcamy do kontakt bezpośrednio z danym kurierem posiłkując się plikami żądania wygenerowania etykiety i odpowiedzi kuriera na takie żądanie.

Stosowne pliki możliwe będą do pobrania w sekcji USTAWIENIA > Dziennik zdarzeń > Kurierzy

Obsługę interfejsu API RESTful dla usług Fedex International.

Od 31 sierpnia 2024 roku Fedex zaczął wprowadzać istotne zmiany w swojej integracji usług dostaw zagranicznych. Dotychczasowe SOAP API dla usług FedEx International jest w fazie wygaszenia, a wszystkie nowe funkcje i ulepszenia będą dostępne wyłącznie w nowych interfejsach API RESTful.

Wychodząc naprzeciw tym zmianom, aby zapewnić użytkownikom ciągłości korzystania z usług tego przewoźnika, wprowadziliśmy obsługę interfejsu API RESTful dla usług Fedex International.

Obecnie w panelach IdoSell obsługiwane są zarówno API usług internetowych FedEx oparte na wygaszanym API SOAP jak i na nowym API REST FedEx.

Jeśli już korzystasz z usług Fedex International, zalecamy migrację na nowe rozwiązanie oparte na API REST - oferuje ono poprawę wydajności, bezpieczeństwa oraz elastyczności rozwiązań oferowanych przez Fedex.

Czy musisz wykonać jakieś dodatkowe kroki w związku z tą zmianą?

Interfejsy API FedEx zapewniają lepsze bezpieczeństwo dzięki uwierzytelnianiu opartemu na tokenach oAuth zatem jeśli już korzystasz z integracji z Fedex International to należy ponownie uwierzytelnić swoje istniejące konto FedeEx w konfiguracji usług kuriera Fedex International w panelu administracyjnym. Sprowadza się do ponownego wpisania danych autentykacyjnych w konfiguracji kuriera.

Jeśli zatem korzystasz już z usług Fedex International lub dopiero zamierzasz je skonfigurować - sprawdź, jakie kroki wykonać by poprawnie wygenerować nowe dane uwierzytelniające.

Jeśli korzystasz już z usług Fedex International lub dopiero zamierzasz je skonfigurować - sprawdź, jakie kroki wykonać by poprawnie wygenerować nowe dane uwierzytelniające aby zmigrować usługi Fedex International na nowe REST API.

Zaloguj się za pomocą swojego identyfikatora użytkownika fedex.com (user ID) i hasła na stronie:

https://developer.fedex.com/api/pl-pl/home.html#

Jeśli jeszcze nie masz konta, wybierz opcję “ZAREJESTRUJ SIĘ” i utwórz swój identyfikator (user ID).

Po zalogowaniu, wybierz z menu opcję “Wprowadzenie”.

Aby w pełni skonfigurować usługę należy zrealizować 4 główne kroki:

1. Utworzyć organizację

2. Utworzyć projekt API

3. Wygenerować klucze API

4. Wygenerować i podpiąć pod projekt API identyfikator konta wysyłkowego

5. Dodać wygenerowane klucze API oraz identyfikator konta wysyłkowego do konfiguracji usług kuriera Fedex International w panelu administracyjnym sklepu

1. Przejdź do zakładki “Utwórz organizację” aby założyć organizację - postępuj wg instrukcji na stronie: https://developer.fedex.com/api/pl-pl/get-started.html

2. Po utworzeniu organizacji, przejdź do zakładki “Utwórz projekt API” - postępując wg instrukcji na stronie, kliknij opcję “+UTWÓRZ PROJEKT API” na popupie wybierz wskazaną opcję:

W kolejnym kroku:

Wybierz wskazany poniżej interfejs API dla projektu (“Interfejsy API dla wysyłki, stawek i innych opcji”)

Zaznacz tylko interfejs: ”Ship API”

Podaj dowolna nazwę projektu i wybierz kraj lub kraje.

Po utworzeniu projektu przejdź do zakładki z kluczami produkcyjnymi. Klucze testowe nie są potrzebne.

Podaj dowolna nazwę klucza produkcyjnego i dodaj swoje konto wysyłkowe.

3. Pobierz produkcyjny klucz:

• Zostanie wyświetlony klucz produkcyjny interfejsu API i produkcyjny klucz tajny. Koniecznie skopiuj je w bezpieczne miejsce.

• Ze względów bezpieczeństwa produkcyjny klucz tajny wyświetlamy tylko raz. Jeśli go zgubisz, możesz wygenerować nowy.

UWAGA: “Krok 4 – Dokończ proces certyfikacji” nie jest potrzebny dla wybranych interfejsów API.

4. Wygenerowane klucze produkcyjne, umieść w konfiguracji kuriera w panelu administracyjnym.

Jeśli korzystasz z dotychczasowego sposobu integracji, dla opcji “Tryb autoryzacji API” przełącz dotychczasową opcję: “Oparty na kluczu dostępu” na opcję “oAuth” i wypełnij wymagane dane:

• Account number (ACCOUNT) - konto wysyłkowe, które podpiąłeś podczas konfiguracji projektu API

• Klucz interfejsu (API API KEY)

• Klucz tajny (SECRET KEY)

Jeśli nie korzystasz jeszcze z integracji Fedex, konfiguracja będzie dostępna domyślnie już dla autoryzacji “oAuth” (czyli opcja wyboru “Tryb autoryzacji API” nie będzie już dostępna) - wystarczy zatem wypełnić wymagane dane:

• Account number (ACCOUNT) - konto, które podpiąłeś podczas konfiguracji projektu API

• Klucz interfejsu (API API KEY)

• Klucz tajny (SECRET KEY)

1. Dlaczego podczas generowania etykiety zwracany jest komunikat : "błąd "[1070] - Klient nie ma dozwolonej platnosci przelewem"?

Przyczyną danego komunikatu może być ustawienie w konfiguracji kuriera"Sposób płatności za usługę : gotówka" bądź zaczytywanie danych nadawcy w konfiguracji z innego miejsca niż "Dane z bazy firmy kurierskiej"

Należy przejść do sekcji USTAWIENIA > Konfiguracja kurierów > Polska > FedEx , a następnie zweryfikować czy została wybrana opcja pobierania danych nadawcy z bazy Fedex (1), a także czy ustawiona jest flaga "przelew" (2)

2. Dlaczego podczas generowania etykiety zwracany jest komunikat :"Error Fetching http headers" ?

Przyczyną może być błąd wewnętrzny FedEx, bądź niedostępność usługi FedEx. W danym przypadku należy pobrać pliki żądania i odpowiedzi dla generowanych etykiet i z takimi plikami zgłosić się do FedEx.

Stosowne pliki możliwe będą do pobrania w sekcji USTAWIENIA > Dziennik zdarzeń > Kurierzy