↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    FedEx API w Elbuz: list przewozowy z zamówienia, etykieta, kurier i statusy

    5 min czytaniaZaktualizowano

    Elbuz łączy się z FedEx API na Twoim kluczu. List przewozowy i etykietę FedEx wystawiasz z karty zamówienia, stamtąd też zamawiasz kuriera, a statusy paczek program sam pobiera co 10 minut.

    Kiedy to się przyda:

    • Wysyłasz z Polski lub innego kraju UE — adres i kraj odbiorcy pochodzą z zamówienia, FedEx Ship Manager do listu przewozowego nie jest potrzebny.
    • Etykieta jest potrzebna od razu — PDF otwiera się z karty zamówienia lub z „Przesyłek”.
    • Paczki są odbierane z Twojego adresu — zlecenie odbioru przez kuriera FedEx składasz z listu przewozowego.
    • Klient pyta, gdzie jest paczka — status FedEx widać w zamówieniu i w rejestrze paczek.

    Od czego zacząć: utwórz projekt API na developer.fedex.com → wpisz klucze w Elbuz.

    Co potrafi FedEx w Elbuz

    • Podłączenie — API Key, Secret Key, numer konta FedEx i środowisko testowe FedEx.
    • List przewozowy z zamówienia — odbiorca, adres, waga i wymiary wpisują się same.
    • Etykieta — PDF przez 12 godzin od utworzenia listu przewozowego.
    • Zamówienie kuriera — data i godziny odbioru, w odpowiedzi — kod potwierdzenia FedEx.
    • Statusy paczek — co 10 minut; według Twojej tabeli kodów zmieniają się statusy zamówień.

    Jak podłączyć FedEx API: klucze i numer konta

    Skąd wziąć API Key i Secret Key FedEx

    1. Zaloguj się na developer.fedex.com kontem FedEx i utwórz organizację w „My Projects”.
    2. „Add shipping accounts” → „+ Add Account”: numer konta FedEx i adres płatnika.
    3. „+ Create API Project”: zaznacz Ship API, Track API i Pickup API, nazwij projekt i wybierz kraje nadania.
    4. Skopiuj klucze: testowe — na karcie „Test Key”, produkcyjne — na „Production key”.

    Secret Key FedEx pokazuje tylko raz. Jeśli go zgubisz, wygeneruj nowy i wpisz go w Elbuz.

    Strona certyfikacji FedEx wymaga dla Ship API weryfikacji etykiet, m.in. w Europie. Etykiety testowe i Label Cover Sheet wysyła się na label@fedex.com, weryfikacja trwa około 3 dni roboczych.

    Co wpisać w Elbuz

    Gdzie: Usługi zewnętrzne i integracje → Dostawa → „FedEx”.

    PoleCo wpisać
    „Aktywność”Włączone — inaczej list przewozowy FedEx się nie otworzy
    „Użytkownik”API Key projektu
    „Hasło”Secret Key projektu
    „Numer konta FedEx”9 cyfr konta, z którego FedEx pobiera opłaty za listy przewozowe i kuriera
    „Domyślna usługa”Usługa dla wszystkich listów przewozowych (którą wybrać)
    „Środowisko testowe (sandbox)”Włącz dla kluczy testowych, wyłącz dla produkcyjnych
    Blok „Nadawca”Firma, osoba kontaktowa, kraj kodem ISO (puste — PL), kod pocztowy, miasto, ulica, numer domu, telefon, e-mail. To adres nadawcy na liście przewozowym i adres odbioru
    „Firma”Twoja firma, jeśli każda ma własne konto FedEx; rekord firmy ma pierwszeństwo przed ogólnym
    Formularz podłączenia FedEx: dane dostępu API, numer konta FedEx, domyślna usługa, przełącznik sandboksu i blok nadawcy
    1Użytkownik i hasło
    2Numer konta FedEx
    3Domyślna usługa
    4Środowisko testowe (sandbox)
    5Blok nadawcy
    1. „Użytkownik” i „Hasło” — API Key i Secret Key projektu z developer.fedex.com.
    2. „Numer konta FedEx” — konto, na które powstają listy przewozowe.
    3. „Domyślna usługa” — usługa FedEx używana, gdy zamówienie nie wskazuje innej.
    4. „Środowisko testowe (sandbox)” — po włączeniu zapytania idą do środowiska testowego FedEx.
    5. „Nadawca” — firma i adres, z którego wysyłane są paczki.

    Formularz zapisuje się sam, gdy tylko zmienisz pole. „Hasło” po zapisaniu pokazuje kropki, a puste pole nie kasuje klucza.

    Przy zapisie Elbuz nie sprawdza kluczy. Błąd klucza ujawni pierwszy list przewozowy: „FedEx OAuth: ‹tekst FedEx›”.

    Którą usługę wybrać

    UsługaKiedy
    FedEx PriorityDomyślna; krajowa usługa FedEx w Polsce
    FedEx Priority ExpressKrajowa usługa FedEx w Polsce
    FedEx International PriorityWysyłki za granicę: doręczenie do końca dnia, zwykle w 1–3 dni robocze
    FedEx Economy SelectWedług dokumentacji FedEx — tylko w Wielkiej Brytanii; z Polski jej nie wybieraj

    Usługa jest jedna dla wszystkich listów przewozowych, w formularzu listu nie da się jej zmienić. Jeśli wysyłasz i po Polsce, i za granicę, przełącz usługę przed wystawieniem listu.

    Środowisko testowe FedEx

    Włącz „Środowisko testowe (sandbox)”, wpisz klucze z karty „Test Key” i numer konta testowego, który FedEx wydaje do klucza testowego. Listy przewozowe pójdą do sandboksu FedEx, prawdziwej wysyłki nie będzie. Przed pracą wyłącz przełącznik i wpisz produkcyjne klucze i numer konta.

    Jak wystawić list przewozowy FedEx z zamówienia

    Ogólna procedura dla wszystkich przewoźników — w artykule jak wystawić list przewozowy z zamówienia.

    Gdzie: karta zamówienia ze sposobem dostawy „FedEx” → sekcja „Dostawa” → „Utwórz list przewozowy”.

    Co formularz wypełni sam i co sprawdzić

    PoleSkądCo sprawdzić
    Nazwisko, Imię, Telefon, E-MailZamówienieTelefon jest obowiązkowy
    Kod pocztowy, Miejscowość, Ulica, Nr domu, Nr mieszkaniaAdres dostawy z zamówienia: cały adres — w „Ulica”, „Nr domu” i „Nr mieszkania” są pusteUlica, numer domu i mieszkania razem — do 35 znaków, dłuższy tekst Elbuz utnie
    Kraj (kod ISO: DE, FR, IT, ES…)Kraj dostawy z zamówieniaNierozpoznany — kraj nadawcy
    Waga całkowita, kgWaga produktów z zamówieniaBrak wagi także w produktach — pójdzie 1 kg; zaokrąglenie do 0,1 kg
    Długość, Szerokość, Wysokość, cmPustePrzekazywane tylko wtedy, gdy wypełnisz wszystkie trzy
    Dostawa zwrotna (odbiorca)„Pieniądze”, jeśli zamówienie nie jest opłacone, a płatność jest przy odbiorzeUstaw „Niepotrzebna”: pobranie FedEx nie jest podłączone
    Formularz listu przewozowego, wspólny dla FedEx i UPS: odbiorca, adres z kodem kraju, waga i wymiary
    1Kraj odbiorcy (kod ISO)
    2„Waga całkowita, kg”
    3„Długość” / „Szerokość” / „Wysokość”
    4„Dostawa zwrotna (odbiorca)”: „Niepotrzebna”
    5Przycisk „Utwórz list przewozowy”
    1. Kraj odbiorcy — dwuliterowy kod ISO, tu DE.
    2. Waga całkowita paczki w kilogramach.
    3. Wymiary paczki: długość, szerokość i wysokość w centymetrach.
    4. Dostawa zwrotna (pobranie) jest niepotrzebna — wybrano „Niepotrzebna”.
    5. „Utwórz list przewozowy” wysyła zgłoszenie do przewoźnika i tworzy list przewozowy.

    Numer zamówienia trafia do listu przewozowego jako referencja klienta, do 30 znaków. Płaci nadawca — z Twojego konta FedEx, opakowanie własne, data nadania — dziś. Pole „Opis przesyłki” nie jest przekazywane do FedEx.

    Zmienione wartości formularz zapamiętuje w zamówieniu: gdy otworzysz go ponownie, będą na miejscu.

    Co się dzieje po „Utwórz list przewozowy”

    1. Elbuz sprawdza dane jeszcze przed wysłaniem do FedEx. Brak numeru konta lub adresu nadawcy — komunikat z przyczyną, np. „Error: FedEx account number is required (API settings)”; list przewozowy nie powstaje.
    2. FedEx tworzy przesyłkę. Numer śledzenia trafia do „Numer listu przewozowego”, pojawia się „Utworzono list przewozowy nr ‹numer›”.
    3. Jeśli FedEx odmówił, w oknie będzie jego komunikat z kodem w nawiasie, a zamówienie zostanie bez numeru.

    Aby w zamówieniu pojawiał się link do śledzenia, w sposobie dostawy „FedEx” wypełnij „Link do śledzenia przesyłki”, np. https://www.fedex.com/fedextrack/?trknbr= (sposoby dostawy).

    List przewozowy powstaje od razu i jest rozliczany według cennika FedEx. Anulować ani zmienić go z Elbuz nie można — tylko w FedEx i tylko dopóki paczka nie trafiła do kuriera. Po anulowaniu wyczyść „Numer listu przewozowego” w zamówieniu, aby wystawić nowy.

    Jak wydrukować etykietę FedEx

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → ikona drukowania; albo „Przesyłki” → wiersz → „Drukuj list przewozowy”.

    Etykieta otwiera się w nowej karcie: PDF na pół arkusza formatu Letter. FedEx przechowuje link do etykiety 12 godzin. Później w karcie pojawi się „print error: FedEx: the label link has expired (12 hours) — reprint it in FedEx Ship Manager”, więc drukuj etykietę zaraz po utworzeniu listu.

    Listu przewozowego, którego numer wpisano w zamówieniu ręcznie, Elbuz nie drukuje: link do etykiety mają tylko listy utworzone z Elbuz.

    Jak zamówić kuriera FedEx

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → blok „Zamówienie kuriera”.

    • „Data odbioru” — domyślnie najbliższy dzień roboczy.
    • „Odbiór od” i „do” — puste: 10:00–17:00.
    • „Liczba paczek, szt.” i „Waga całkowita, kg” — ile odebrać.

    „Zamów kuriera” → „Kurier zamówiony #‹kod›”. Kod potwierdzenia FedEx zapisuje się w zamówieniu, adres odbioru to blok „Nadawca” w podłączeniu. Na dziś FedEx przyjmuje zlecenie, dopóki nie minęła godzina graniczna dla Twojego kodu pocztowego.

    Jak Elbuz śledzi paczki FedEx

    Co 10 minut Elbuz pyta FedEx o paczki — do 100 listów przewozowych na przebieg. Śledzi zamówienia z ostatnich 60 dni i zamówienia w zaznaczonych statusach, dopóki paczka nie dostanie stanu „Doręczona”. Kod i tekst statusu FedEx widać w zamówieniu i w „Przesyłkach”.

    W „Przesyłkach” dla FedEx działają „Drukuj list przewozowy”, „SMS do odbiorcy” i „Śledź na stronie przewoźnika” — strona fedex.com z numerem paczki.

    Jak zmieniać statusy zamówień według kodów FedEx

    Kody FedEx Elbuz sam wpisuje w „Statusy dostawy”. Kod spoza tabeli daje w „Przesyłkach” stan „Nieznany”, a status zamówienia według niego się nie zmienia.

    1. W podłączeniu FedEx, w bloku „Statusy zamówień, dla których sprawdzać status przesyłki w firmie kurierskiej”, zaznacz statusy, w których zamówienie czeka na doręczenie, np. „Wysłano”.
    2. W bloku „Ustawienia powiadomień” otwórz „Statusy dostawy” (w razie potrzeby także „Statusy zamówienia” i „Statusy płatności”).
    3. Kody FedEx z tabeli poniżej są już wpisane w kolumnie „Kod (nazwa) na stronie (API)”; własne dopisuj po przecinku.
    Kody FedEx dla okna „Statusy dostawy”
    Twój status dostawyKody FedExStan w „Przesyłkach”
    Oczekiwanie od nadawcyOC — FedEx otrzymał dane przesyłkiUtworzona
    W drodzePU — odebrana, IT — w drodze, AR, AF, DP — sortowanieW drodze
    W urzędzie celnymCC, CP, CD — odprawa celnaW drodze
    Wydany kurierowiOD — w doręczeniuW drodze
    DostarczonoDLDoręczona, odpytywanie się kończy
    OdrzucenieRS — zwrot do nadawcyOdmowa

    Bez kodu DL przy „Dostarczono” w „Statusy dostawy” paczka nie dostanie stanu „Doręczona”. Elbuz będzie o nią pytać także po doręczeniu, zajmując miejsce w limicie 100 listów przewozowych na przebieg.

    Kody wyjątków DE, SE i DD zostaw poza tabelą: taka paczka będzie mieć stan „Nieznany” i ją zauważysz. Kody pochodzą z listy zdarzeń FedEx. Jak działają trzy tabele statusów — w artykule o automatycznej zmianie statusu zamówienia.

    Scenariusze

    Pierwsze podłączenie bez ryzyka

    Utwórz projekt na developer.fedex.com, wpisz testowe klucze i testowe konto, włącz „Środowisko testowe (sandbox)”. Wystaw list przewozowy do własnego zamówienia i wydrukuj etykietę. Jeśli wszystko działa, przełącz się na klucze produkcyjne.

    Codzienna wysyłka do Niemiec

    „Domyślna usługa” — FedEx International Priority. Z każdego zamówienia — „Utwórz list przewozowy”, od razu druk etykiety, na koniec — jedno „Zamówienie kuriera” z liczbą paczek i łączną wagą.

    Zamówienia zamykają się same

    Zaznacz w podłączeniu status „Wysłano”. Kod DL wpisz przy „Dostarczono” zarówno w „Statusy dostawy”, jak i w „Statusy zamówienia”. Paczka doręczona — zamówienie przechodzi w „Dostarczono”, a Elbuz przestaje o nią pytać.

    Co zrobić, gdy coś pójdzie nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” Nie wpisano Secret Key albo wyłączono „Aktywność” Wypełnij „Hasło” i włącz „Aktywność” (co wpisać)
    „FedEx OAuth: …” FedEx nie przyjął kluczy: klucze testowe przy wyłączonym sandboksie lub odwrotnie albo stary Secret Key Porównaj parę kluczy i przełącznik „Środowisko testowe (sandbox)” (środowisko testowe)
    „FedEx account number is required (API settings)” Puste pole „Numer konta FedEx” Wpisz 9 cyfr konta
    „sender address and phone are required (API settings)” W bloku „Nadawca” brakuje nazwy, ulicy, miasta, kodu pocztowego lub telefonu Uzupełnij „Nadawca” w podłączeniu
    „name and phone are required for recipient” albo „address is required for recipient” W zamówieniu brakuje imienia, telefonu, ulicy, miasta lub kodu pocztowego odbiorcy Dopisz je w formularzu listu przewozowego
    „cash on delivery is not supported for FedEx yet — choose «without COD»” W „Dostawa zwrotna (odbiorca)” ustawiono „Pieniądze” Wybierz „Niepotrzebna”
    „FedEx: the label link has expired…” Od utworzenia listu przewozowego minęło ponad 12 godzin Wydrukuj etykietę w FedEx Ship Manager
    W „Przesyłkach” paczka FedEx ma stan „Nieznany” Kodu FedEx nie ma w oknie „Statusy dostawy” Dopisz kod (kody FedEx)

    Najczęstsze pytania

    Ile kosztuje integracja FedEx w Elbuz?

    Elbuz nie pobiera opłat za listy przewozowe, etykiety ani statusy FedEx. Za dostawę i kuriera płacisz FedEx według swojej umowy.

    Czy mogę wysyłać FedEx spoza Polski?

    Tak, z dowolnego kraju UE: wpisz kod kraju w polu „Kraj” bloku „Nadawca”. Elbuz nie przekazuje danych celnych, więc wysyłki są w obrębie UE.

    Czy mogę wysłać z Elbuz paczkę FedEx za pobraniem?

    Nie, pobranie FedEx nie jest podłączone: list przewozowy z „Pieniądze” zostaje odrzucony. Zostaw „Niepotrzebna” albo nadaj taką paczkę w FedEx.

    Jak anulować list przewozowy FedEx?

    Tylko w FedEx, dopóki paczka nie trafiła do kuriera. Potem wyczyść „Numer listu przewozowego” w zamówieniu (po utworzeniu).

    Czy mogę wybrać usługę FedEx dla pojedynczego listu przewozowego?

    Nie, usługa jest jedna dla wszystkich — „Domyślna usługa” w podłączeniu. Przełącz ją przed listem innego typu.

    Dlaczego status FedEx nie zmienia statusu zamówienia?

    Status zamówienia nie jest zaznaczony w podłączeniu albo kodu FedEx nie ma w tabeli. Zaznacz status i wpisz kody (kody FedEx).

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa → FedEx
    Inne wejścia
    Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
    Uprawnienia
    podłączenie — „API i tokeny dostępu”; list przewozowy i kurier — okno „Tworzenie listu przewozowego”
    Przygotuj
    konto FedEx (9 cyfr) i projekt na developer.fedex.com z Ship, Track i Pickup API
    1. Utwórz projekt API i kluczedeveloper.fedex.com
    2. Wpisz klucze, numer konta i nadawcęUsługi zewnętrzne i integracje → FedEx
    3. Wpisz kody statusów FedExTamże, „Ustawienia powiadomień”
    4. Wystaw list przewozowy i wydrukuj etykietęKarta zamówienia, sekcja „Dostawa”
    5. Zamów kurieraPodgląd listu przewozowego

    Powiązane tematy

    • Jeśli chcesz widzieć wszystkie paczki wszystkich przewoźników na jednej liście — Przesyłki.
    • Jeśli wysyłasz też przez UPS — UPS w Elbuz: formularz listu przewozowego jest ten sam.
    • Jeśli sklep jest w Niemczech i pracuje z DHL Paket — DHL Paket w Elbuz.
    • Jeśli chcesz porównać sposoby wystawienia listu przewozowego — list przewozowy z zamówienia.

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo