FedEx automatyzacje - API i dokumenty eksportowe

Dokumenty eksportowe FedEx - jak działa ETD?

Dokumenty eksportowe to faktura handlowa i inne dokumenty, których wymaga odprawa celna przy wysyłkach poza Unię Europejską, np. do Wielkiej Brytanii, Szwajcarii, Norwegii czy USA. FedEx Electronic Trade Documents (ETD) to usługa, w której te dokumenty przesyłasz elektronicznie razem z danymi przesyłki, zamiast drukować je i wkładać do koperty na paczce. Usługa jest bezpłatna i działa w większości krajów obsługiwanych przez FedEx (stan na kwiecień 2026 - sprawdź listę krajów u przewoźnika).

W automatycznym procesie faktura handlowa powstaje z danych zamówienia i katalogu: opis towaru, ilość, wartość, waluta, kod taryfy celnej (HS), kraj pochodzenia i warunki dostawy. Integracja przesyła ją do FedEx razem z przesyłką. Możesz też wgrać własny wzór faktury lub dołączyć dodatkowe dokumenty, np. certyfikat pochodzenia, jeśli wymaga tego kraj odbiorcy.

Jakie dane produktu są potrzebne do automatycznych dokumentów eksportowych?

1. Opis towaru po angielsku - konkretny, np. „cotton T-shirt”, a nie „clothes”.

2. Kod taryfy celnej (HS) dla każdego produktu wysyłanego poza UE.

3. Kraj pochodzenia towaru, czyli kraj produkcji, a nie kraj sklepu.

4. Wartość jednostkowa i waluta zgodne z zamówieniem.

5. Waga netto produktu oraz waga i wymiary kartonu.

6. Numer EORI nadawcy zapisany w koncie FedEx i w integracji.

Jeśli katalog ma kilkaset lub kilka tysięcy produktów, uzupełnianie kodów HS i opisów po angielsku warto zrobić hurtowo, np. dla całych kategorii o podobnym składzie. Produkty z tej samej kategorii często mają ten sam kod taryfy i podobny opis. W Base i w większości platform sklepowych takie pola można dodać jako dodatkowe parametry produktu i wypełnić je importem z arkusza. Dzięki temu dane eksportowe są w jednym miejscu, a integracja FedEx pobiera je automatycznie przy każdej wysyłce poza UE.

[#uwaga] Najczęstsza przyczyna zatrzymania paczki w odprawie to zbyt ogólny opis towaru albo brak kodu taryfy. Uzupełnienie tych pól w katalogu raz, na poziomie produktu, rozwiązuje problem dla wszystkich kolejnych wysyłek.

Poniżej zestaw automatyzacji, które dają w sklepie największy efekt. Nie musisz wdrażać wszystkich naraz - zacznij od etykiet i ETD, a potem dodawaj kolejne elementy:

[#chart:kur57b]

Zamówienie odbioru i powiadomienia klienta - automatyzacje FedEx po nadaniu

Etykieta to dopiero połowa procesu. Druga połowa to odbiór paczek z magazynu i informacja dla klienta. Jeśli wysyłasz codziennie, najprościej ustalić z FedEx stały odbiór o określonej godzinie. Przy nieregularnych wysyłkach odbiór można zamawiać automatycznie, przy tworzeniu przesyłek - przez API albo z poziomu integracji, jeśli ją obsługuje. Ustaw godzinę graniczną, do której zamówienia trafiają do wysyłki tego samego dnia, i komunikuj ją w sklepie.

Powiadomienia to drugi obszar. FedEx może wysyłać klientowi e-maile o nadaniu i doręczeniu, ale wiele sklepów woli własne wiadomości z logo i linkiem do śledzenia. W Base działa to przez akcje automatyczne: gdy numer przesyłki trafi do zamówienia, status zmienia się na „Wysłane”, a klient dostaje e-mail z linkiem. Przy zamówieniach z Allegro numer przesyłki trafia też do zamówienia na Allegro.

Reguły wyboru usługi FedEx

Automatyzacja nie kończy się na jednym przewoźniku. W Base możesz ustawić reguły, które wybiorą FedEx International Priority dla pilnych paczek poza UE, International Economy dla tańszych wysyłek zagranicznych, a krajowy FedEx Priority dla paczek do 68 kg w Polsce. Jeśli korzystasz z kilku przewoźników, reguły przypiszą kuriera według kraju, wagi i kanału. Szczegóły opisujemy we wpisie o

Wycena i walidacja adresu przez FedEx API - automatyzacje przed nadaniem

Wiele sklepów automatyzuje tylko to, co dzieje się po zakupie. Tymczasem część problemów można wyeliminować wcześniej, jeszcze w koszyku. Wycena przez API pozwala pokazać klientowi realny koszt i przewidywany czas dostawy dla jego kraju, zamiast jednej stałej stawki dla całego świata. To ważne zwłaszcza przy ciężkich i dużych paczkach, w których waga gabarytowa (u FedEx zwykle wymiary w cm podzielone przez 5000) potrafi wyraźnie podnieść koszt.

Walidacja adresu to druga automatyzacja przed nadaniem. System sprawdza, czy kod pocztowy pasuje do miasta i czy adres jest kompletny. Jeśli nie, prosi klienta o poprawkę jeszcze w formularzu zamówienia. Każdy poprawiony w ten sposób adres to jedna korekta mniej na fakturze przewoźnika i jedna paczka mniej, która wraca do magazynu. Przy wysyłkach zagranicznych, gdzie formaty adresów są różne w każdym kraju, ta funkcja ma szczególne znaczenie.

Klucze API FedEx - bezpieczeństwo i środowisko testowe

Klucze API to dane dostępowe do Twojego konta przewoźnika. Przechowuj je w systemie, a nie w arkuszach czy wiadomościach e-mail, i ogranicz dostęp do osób, które faktycznie konfigurują integrację. Gdy zmieniasz agencję, programistę lub system, wygeneruj nowe klucze i wyłącz stare. Każdą zmianę w integracji testuj najpierw w środowisku testowym FedEx albo na pojedynczym zamówieniu, zanim włączysz automatyczne tworzenie etykiet dla wszystkich zamówień.

Warto też ustalić, kto w firmie odpowiada za integrację po wdrożeniu. Przewoźnicy co jakiś czas zmieniają wersje API i wycofują starsze, a integracje w systemach takich jak Base są aktualizowane, co czasem wymaga ponownego podłączenia konta. W Base są np. dwie pozycje FedEx - „FedEx.com (new)” i „FedEx.pl” - i osoba odpowiedzialna powinna wiedzieć, z której korzysta firma i jakie dane do niej podano. Jeśli nikt tego nie pilnuje, pierwszym sygnałem problemu bywa dzień, w którym etykiety przestają się generować.

Najczęstsze błędy automatyzacji wysyłek FedEx

Automatyzacja przenosi błędy z pracy ręcznej na dane. Jeśli produkt nie ma wagi, a adres nie ma kodu pocztowego, system nie utworzy etykiety albo utworzy ją z błędem, który wyjdzie dopiero na fakturze FedEx. Dlatego po wdrożeniu warto przez pierwsze tygodnie przeglądać każdy błąd i poprawiać jego przyczynę u źródła. Najczęstsze sytuacje i poprawki zebraliśmy na diagramie:

[#chart:kur57c]

Dobrą praktyką jest też osobny status w systemie zamówień, np. „Błąd wysyłki”, do którego trafiają zamówienia, dla których etykieta się nie utworzyła. Pracownik widzi je od razu, zamiast odkrywać problem przy pakowaniu. Przy własnej integracji z API warto logować odpowiedzi FedEx, żeby programista mógł szybko sprawdzić, co poszło nie tak.

Jak wdrożyć automatyzacje FedEx krok po kroku?

• Załóż i skonfiguruj konto FedEx, ustaw adres nadania i format etykiety.

• Uzupełnij katalog: wagi, wymiary kartonów, opisy po angielsku, kody HS, kraj pochodzenia.

• Wybierz drogę integracji: Base, wtyczka sklepu albo własne API.

• Włącz ETD i przetestuj wysyłkę poza UE na jednym zamówieniu.

• Ustaw reguły wyboru usługi, odbiór i powiadomienia dla klienta.

• Przez pierwszy miesiąc porównuj faktury FedEx z danymi przesyłek.

Jeśli zaczynasz od zera, najpierw przejdź przez

Jak Vinson pomaga zautomatyzować wysyłki FedEx?

Vinson to agencja e-commerce z Bochni, działająca od 2021 r., certyfikowany partner Base, Allegro Ads Partner+ i autoryzowany partner Shoper. Współpracowało z nami ponad 500 firm, a klienci oceniają nas na 4,9/5 ze 171 opinii. Nie jesteśmy partnerem FedEx - wdrażamy przewoźników, którzy pasują do produktów klienta.

• dobieramy usługi FedEx i innych kurierów do produktów i kierunków wysyłek,

• podłączamy FedEx w Base, sklepie i dla zamówień z Allegro,

• porządkujemy dane katalogu potrzebne do etykiet i dokumentów eksportowych,

• ustawiamy reguły wyboru kuriera, akcje automatyczne i powiadomienia,

• kontrolujemy koszty dostaw po wdrożeniu.

Porozmawiajmy o Twoim procesie wysyłek na

Najczęściej zadawane pytania

Czy FedEx ma API dla sklepów internetowych?

Tak. FedEx udostępnia API przez portal deweloperski, w którym tworzy się projekt i generuje klucze dostępu. API pozwala m.in. tworzyć przesyłki i etykiety, pobierać wyceny, zamawiać odbiór i śledzić paczki. Dla większości sklepów prostsza jest jednak gotowa integracja w Base lub wtyczka sklepu.

Czym jest FedEx ETD?

FedEx Electronic Trade Documents (ETD) to bezpłatna usługa elektronicznego przesyłania dokumentów eksportowych, przede wszystkim faktury handlowej. Zamiast drukować dokumenty i dołączać je do paczki, przesyłasz je razem z danymi przesyłki, co przyspiesza odprawę celną i zmniejsza ryzyko zgubienia dokumentów.

Czy potrzebuję programisty, żeby zautomatyzować wysyłki FedEx?

Nie zawsze. Jeśli korzystasz z Base, podłączysz FedEx przez integrację „FedEx.com (new)” lub „FedEx.pl”, podając klucz API, numer konta i Meter Number. Programista jest potrzebny przy własnej integracji z API, np. z systemem ERP lub nietypowym procesem magazynowym.

Jakie dane są potrzebne do faktury handlowej przy wysyłce FedEx poza UE?

Faktura handlowa wymaga opisu towaru po angielsku, ilości, wartości i waluty, kodu taryfy celnej, kraju pochodzenia, danych nadawcy i odbiorcy oraz zwykle numeru EORI nadawcy. Najlepiej trzymać te dane w katalogu produktów, żeby integracja wypełniała fakturę automatycznie.

Czy wysyłki FedEx z Allegro można zautomatyzować?

Tak, ale nie przez „Wysyłam z Allegro”, bo FedEx nie jest w tym programie. Zamówienia z Allegro trafiają do Base, tam tworzy się etykieta FedEx na Twojej umowie, a numer śledzenia wraca do zamówienia na Allegro.

Czy automatyczne etykiety FedEx działają przy wysyłkach krajowych?

Tak. Automatyzacja obejmuje także krajowe usługi FedEx Priority i Priority Express dla paczek do 68 kg z doręczeniem następnego dnia. Przy wysyłkach krajowych nie potrzebujesz dokumentów eksportowych, więc wystarczą adres, waga, wymiary i przypisana usługa.

Automatyzacja wysyłek FedEx zwraca się szybko, jeśli wysyłasz regularnie za granicę. Pomożemy wybrać właściwą drogę integracji i przygotować dane - zacznij od