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
- Zaloguj się na developer.fedex.com kontem FedEx i utwórz organizację w „My Projects”.
- „Add shipping accounts” → „+ Add Account”: numer konta FedEx i adres płatnika.
- „+ Create API Project”: zaznacz Ship API, Track API i Pickup API, nazwij projekt i wybierz kraje nadania.
- 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”.
| Pole | Co 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 |
1
Użytkownik i hasło2
Numer konta FedEx3
Domyślna usługa4
Środowisko testowe (sandbox)5
Blok nadawcy- „Użytkownik” i „Hasło” — API Key i Secret Key projektu z developer.fedex.com.
- „Numer konta FedEx” — konto, na które powstają listy przewozowe.
- „Domyślna usługa” — usługa FedEx używana, gdy zamówienie nie wskazuje innej.
- „Środowisko testowe (sandbox)” — po włączeniu zapytania idą do środowiska testowego FedEx.
- „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ługa | Kiedy |
|---|---|
| FedEx Priority | Domyślna; krajowa usługa FedEx w Polsce |
| FedEx Priority Express | Krajowa usługa FedEx w Polsce |
| FedEx International Priority | Wysyłki za granicę: doręczenie do końca dnia, zwykle w 1–3 dni robocze |
| FedEx Economy Select | Wedł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ć
| Pole | Skąd | Co sprawdzić |
|---|---|---|
| Nazwisko, Imię, Telefon, E-Mail | Zamówienie | Telefon jest obowiązkowy |
| Kod pocztowy, Miejscowość, Ulica, Nr domu, Nr mieszkania | Adres dostawy z zamówienia: cały adres — w „Ulica”, „Nr domu” i „Nr mieszkania” są puste | Ulica, 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ówienia | Nierozpoznany — kraj nadawcy |
| Waga całkowita, kg | Waga produktów z zamówienia | Brak wagi także w produktach — pójdzie 1 kg; zaokrąglenie do 0,1 kg |
| Długość, Szerokość, Wysokość, cm | Puste | Przekazywane 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 odbiorze | Ustaw „Niepotrzebna”: pobranie FedEx nie jest podłączone |
1
Kraj odbiorcy (kod ISO)2
„Waga całkowita, kg”3
„Długość” / „Szerokość” / „Wysokość”4
„Dostawa zwrotna (odbiorca)”: „Niepotrzebna”5
Przycisk „Utwórz list przewozowy”- Kraj odbiorcy — dwuliterowy kod ISO, tu DE.
- Waga całkowita paczki w kilogramach.
- Wymiary paczki: długość, szerokość i wysokość w centymetrach.
- Dostawa zwrotna (pobranie) jest niepotrzebna — wybrano „Niepotrzebna”.
- „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”
- 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.
- FedEx tworzy przesyłkę. Numer śledzenia trafia do „Numer listu przewozowego”, pojawia się „Utworzono list przewozowy nr ‹numer›”.
- 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.
- 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”.
- W bloku „Ustawienia powiadomień” otwórz „Statusy dostawy” (w razie potrzeby także „Statusy zamówienia” i „Statusy płatności”).
- Kody FedEx z tabeli poniżej są już wpisane w kolumnie „Kod (nazwa) na stronie (API)”; własne dopisuj po przecinku.
| Twój status dostawy | Kody FedEx | Stan w „Przesyłkach” |
|---|---|---|
| Oczekiwanie od nadawcy | OC — FedEx otrzymał dane przesyłki | Utworzona |
| W drodze | PU — odebrana, IT — w drodze, AR, AF, DP — sortowanie | W drodze |
| W urzędzie celnym | CC, CP, CD — odprawa celna | W drodze |
| Wydany kurierowi | OD — w doręczeniu | W drodze |
| Dostarczono | DL | Doręczona, odpytywanie się kończy |
| Odrzucenie | RS — zwrot do nadawcy | Odmowa |
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
| Co widzisz | Dlaczego tak jest | Co 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
- Utwórz projekt API i kluczedeveloper.fedex.com
- Wpisz klucze, numer konta i nadawcęUsługi zewnętrzne i integracje → FedEx
- Wpisz kody statusów FedExTamże, „Ustawienia powiadomień”
- Wystaw list przewozowy i wydrukuj etykietęKarta zamówienia, sekcja „Dostawa”
- 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.
