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
- Przejdź na developer.fedex.com i kliknij "Zarejestruj się" (lub zaloguj, jeśli masz już konto FedEx.com).
- Utwórz lub dołącz do Organizacji Twojej firmy w portalu.
- Kliknij "Moje projekty" → "Utwórz projekt".
- Wybierz "Ship API" (i opcjonalnie "Track API") z katalogu API.
- Wprowadź numer konta FedEx po wyświetleniu monitu — łączy to rozliczenia z projektem.
- 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:
- Prześlij do FedEx arkusz informacji o produkcie i arkusz weryfikacji.
- Dostarcz przykładowe etykiety wygenerowane podczas testowania do analizy kodów kreskowych.
- Grupa analizy kodów kreskowych FedEx weryfikuje etykiety w ciągu 3 dni roboczych.
- Po zatwierdzeniu projekt przechodzi do statusu Produkcja.
- 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
- Otwórz zamówienie, które chcesz wysłać.
- Kliknij "Utwórz przesyłkę" i wybierz FedEx jako przewoźnika.
- Zweryfikuj imię i nazwisko odbiorcy, adres, miasto, kod pocztowy i kraj.
- Wprowadź wagę paczki w kg.
- Opcjonalnie wprowadź wymiary (długość, szerokość, wysokość w cm).
- Wybierz typ usługi FedEx (patrz poniżej).
- Wybierz typ odbioru: "Nadaj w punkcie FedEx" lub "Odbiór planowy".
- W przypadku przesyłek poza UE wypełnij szczegóły deklaracji celnej.
- Kliknij "Utwórz przesyłkę", aby przesłać żądanie.
- 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.