Przeglądaj przewodnik›

VedronERP · Wysyłka i kurierzy

Integracja z FedEx

FedEx zapewnia wysyłkę międzynarodową i ekspresową na całym świecie. Integracja używa FedEx Ship API v1 (REST) z uwierzytelnianiem OAuth2 do tworzenia przesyłek, generowania etykiet PDF i wytwarzania dokumentów celnych dla miejsc docelowych poza UE.

Krok 1 — Utwórz konto dewelopera FedEx

  1. Przejdź na developer.fedex.com i kliknij "Zarejestruj się" (lub zaloguj, jeśli masz już konto FedEx.com).
  2. Utwórz lub dołącz do Organizacji Twojej firmy w portalu.
  3. Kliknij "Moje projekty" → "Utwórz projekt".
  4. Wybierz "Ship API" (i opcjonalnie "Track API") z katalogu API.
  5. Wprowadź numer konta FedEx po wyświetleniu monitu — łączy to rozliczenia z projektem.
  6. Zakończ konfigurację projektu, aby otrzymać testowe (sandbox) dane dostępowe.

Krok 2 — Uzyskaj dane dostępowe API

Po utworzeniu projektu przejdź do strony Przegląd projektu i otwórz zakładkę "Dane dostępowe API". Znajdziesz tam:

  • [Klucz API] — zwany również Client ID. Identyfikuje Twoją aplikację.
  • [Tajny klucz] — zwany również Client Secret. WAŻNE: jest wyświetlany tylko raz. Skopiuj go i zapisz natychmiast — jeśli go utracisz, musisz go ponownie wygenerować.
  • [Numer konta] — 9-cyfrowy numer konta rozliczeniowego FedEx. Widoczny osobno w przeglądzie projektu.

Warning: Tajny klucz jest wyświetlany tylko raz przy pierwszym wygenerowaniu. Zapisz go w bezpiecznym miejscu natychmiast. Jeśli go utracisz, będziesz musiał go ponownie wygenerować i zaktualizować wszystkie systemy go używające.

Krok 3 — Środowisko testowe (Sandbox)

FedEx udostępnia środowisko sandbox do testowania. Sandbox używa oddzielnych danych testowych (również widocznych w projekcie) i bazowego URL apis-sandbox.fedex.com. Użyj sandbox do sprawdzenia, czy integracja generuje prawidłowe etykiety przed przejściem na produkcję.

Krok 4 — Certyfikacja produkcyjna

FedEx wymaga procesu walidacji przed drukowaniem produkcyjnych etykiet. Obejmuje to:

  1. Prześlij do FedEx arkusz informacji o produkcie i arkusz weryfikacji.
  2. Dostarcz przykładowe etykiety wygenerowane podczas testowania do analizy kodów kreskowych.
  3. Grupa analizy kodów kreskowych FedEx weryfikuje etykiety w ciągu 3 dni roboczych.
  4. Po zatwierdzeniu projekt przechodzi do statusu Produkcja.
  5. Pobierz produkcyjny Klucz API i Tajny klucz ze strony Przegląd projektu.

Krok 5 — Konfiguracja danych dostępowych w ERP

Przejdź do strony Dane dostępowe, wybierz FedEx i wprowadź następujące pola:

  • [Klucz API] — Twój produkcyjny Klucz API (Client ID) z Portalu Deweloperów FedEx.
  • [Tajny klucz] — Twój produkcyjny Tajny klucz (Client Secret).
  • [Numer konta] — 9-cyfrowy numer konta rozliczeniowego FedEx.
  • [Imię i nazwisko nadawcy] — nazwa wydrukowana na etykiecie jako nadawca.
  • [Firma nadawcy] — nazwa Twojej firmy.
  • [Ulica nadawcy] — adres nadania.
  • [Kod pocztowy nadawcy] — kod pocztowy nadania.
  • [Miasto nadawcy] — miasto nadania.
  • [Kraj nadawcy] — 2-literowy kod kraju (np. DE, NL, PL).
  • [Telefon nadawcy] — numer kontaktowy nadawcy.
  • [E-mail nadawcy] — adres e-mail kontaktowy nadawcy.

Tworzenie przesyłki FedEx

  1. Otwórz zamówienie, które chcesz wysłać.
  2. Kliknij "Utwórz przesyłkę" i wybierz FedEx jako przewoźnika.
  3. Zweryfikuj imię i nazwisko odbiorcy, adres, miasto, kod pocztowy i kraj.
  4. Wprowadź wagę paczki w kg.
  5. Opcjonalnie wprowadź wymiary (długość, szerokość, wysokość w cm).
  6. Wybierz typ usługi FedEx (patrz poniżej).
  7. Wybierz typ odbioru: "Nadaj w punkcie FedEx" lub "Odbiór planowy".
  8. W przypadku przesyłek poza UE wypełnij szczegóły deklaracji celnej.
  9. Kliknij "Utwórz przesyłkę", aby przesłać żądanie.
  10. Pobierz etykietę PDF (format 4x6 cali) i wydrukuj ją.

Dostępne typy usług FedEx

  • INTERNATIONAL_PRIORITY — Najszybsza usługa międzynarodowa, dostawa w określonym czasie
  • INTERNATIONAL_ECONOMY — Ekonomiczna usługa międzynarodowa, dostawa w określonym dniu
  • EUROPE_FIRST_INTERNATIONAL_PRIORITY — Dostawa priorytetowa do europejskich miejsc docelowych do 9:00 lub 10:00
  • FEDEX_EXPRESS_SAVER — Ekonomiczny ekspres w Europie/na świecie
  • PRIORITY_OVERNIGHT — Dostawa następnego dnia roboczego do 10:30 (USA i wybrane rynki)
  • FEDEX_GROUND — Dostawa naziemna (USA, Kanada)
  • FEDEX_2_DAY — Dostawa w 2 dni robocze (USA i wybrane rynki)

Dokumentacja celna (przesyłki poza UE)

W przypadku przesyłek do miejsc docelowych poza UE (np. Wielka Brytania, USA, Szwajcaria, Norwegia) wymagane są faktura handlowa i deklaracja celna. System ERP poprosi o następujące dodatkowe dane:

  • Opis towaru — co znajduje się w paczce (np. "elektronika", "akcesoria")
  • Kod HS/taryfowy — kod Zharmonizowanego Systemu dla towarów (sprawdź właściwy kod dla swojej kategorii produktów)
  • Kraj produkcji — gdzie wyprodukowano towary
  • Zadeklarowana wartość — wartość na jednostkę w walucie przesyłki
  • Liczba sztuk — ilość
  • Płatność ceł — zazwyczaj "NADAWCA" (Ty płacisz) lub "ODBIORCA" (klient płaci)

Tip: Dla eksporterów z UE możesz potrzebować numeru EORI do zgodności celnej przy eksporcie poza UE. Skontaktuj się z FedEx lub swoim agentem celnym, jeśli nie jesteś pewien.

Token OAuth i uwierzytelnianie

System ERP automatycznie obsługuje uwierzytelnianie OAuth2. Używa Klucza API i Tajnego klucza do żądania tokenu dostępu od FedEx (ważnego przez 1 godzinę) i odświeża go przed każdym żądaniem przesyłki. Nie jest wymagane ręczne zarządzanie tokenem.

Warning: Jeśli widzisz błędy uwierzytelniania (401 Unauthorized), Twoje dane dostępowe mogły zostać ponownie wygenerowane w Portalu Deweloperów FedEx. Zaktualizuj Klucz API i Tajny klucz na stronie Dane dostępowe w ERP.