Dostawca FedEx Integrator
Wymaganie wstępne
Aby zalogować się do portalu FedEx Developer Portal i utworzyć organizację trzeba mieć identyfikator użytkownika FedEx.
Dołącz do organizacji w Twojej firmie, aby współpracować z zespołem. Jeśli Twoja firma nie ma organizacji, możesz ją utworzyć.
Dołączanie do istniejącej organizacji
1. Poproś o zaproszenie
Poproś administratora organizacji o przesłanie Ci zaproszenia. Należy je zaakceptować w ciągu 24 godzin. Jeśli zaproszenie utraci ważność, poproś administratora o ponowne przesłanie zaproszenia.
2. Zaakceptuj zaproszenie
Zaloguj się, podając identyfikator użytkownika i hasło. Jeśli Twój identyfikator użytkownika jest powiązany z inną organizacją, utwórz nowy.
Tworzenie nowej organizacji
Tworząc organizację, stajesz się jej administratorem. Jako administrator możesz zapraszać użytkowników do dołączenia do organizacji, przypisywać projekty i role oraz zarządzać kontami rozliczeniowymi.
Aby dowiedzieć się więcej na temat ról użytkownika, zapoznaj się z Wytycznymi administrowania organizacją.
1. Wybierz opcję Utwórz organizację lub dołącz do niej na pasku nawigacji.
2. Wprowadź następujące szczegóły:
- W opcji Pracuję dla firmy, która wybierz Sprzedaje lub dostarcza oprogramowanie korzystające z technologii FedEx i chce zarejestrować się jako zweryfikowany dostawca FedEx Integrator
- Wprowadź nazwę firmy, adres strony internetowej firmy i nazwę organizacji, którą rozpozna Twój zespół, np. nazwę firmy, dział, oddział lub region.
- Wprowadź oficjalny adres e-mail, który obejmuje domenę Twojej firmy, kraj lub terytorium siedziby firmy oraz kraje i terytoria, w których sprzedajesz oprogramowanie lub prowadzisz jego dystrybucję.
3. Wybierz przycisk Dalej.
Podane informacje możesz zaktualizować lub uzupełnić później, wybierając opcję Zarządzaj organizacją w menu.
Dodawanie konta rozliczeniowego
1. Wybierz kartę Konta rozliczeniowe. Jeśli nie masz konta rozliczeniowego FedEx, wybierz opcję Załóż konto rozliczeniowe , aby założyć nowe lub skontaktuj się z Biurem Obsługi Klienta FedEx.
Uwaga: Użyj swojego numeru konta; nie może to być numer konta FedEx klienta.
2. Wybierz opcję Dodaj konto rozliczeniowe.
3. Wprowadź numer konta FedEx, nazwę skrótową konta oraz adres rozliczeniowy w Stanach Zjednoczonych użyty podczas konfiguracji konta.
Uwaga: Adres rozliczeniowy musi być taki sam jak adres użyty podczas konfiguracji konta. To konto stanie się domyślnym kontem rozliczeniowym organizacji.
4. Wybierz opcję uwierzytelniania.
- Rozmowa telefoniczna jest dostępna wyłącznie dla integratorów w Stanach Zjednoczonych i Kanadzie.
5. Wprowadź otrzymany kod uwierzytelniający i wybierz opcję Prześlij.
6. Przeczytaj i zaakceptuj Umowę Integratora FedEx.
Zapraszanie użytkowników jako administrator
1. Przejdź do pozycji Zarządzaj organizacją i wybierz kartę Użytkownicy.
2. Wybierz opcję + Dodaj użytkowników.
3. Wprowadź następujące szczegóły:
- Kraj lub terytorium
- Preferowany język
4. Wybierz rolę użytkownika (Przeglądający, Współautor lub Administrator).
5. (Opcjonalnie) Przypisz użytkownika do projektu.
- Użytkownika możesz przypisać w dowolnej chwili na stronie Przegląd projektu.
6. Wprowadź adresy e-mail użytkowników i kliknij opcję Zaproś.
- Za jednym razem możesz zaprosić do 20 użytkowników, rozdzielając każdy adres e-mail przecinkiem. Zaproszenie jest ważne przez 24 godziny.
Tworzenie projektu
1. Z menu przejdź do strony Moje projekty i wybierz opcję + Utwórz projekt.
2. Wprowadź tekst w polu Nazwa projektu.
- Zalecany format nazwy to Nazwaprojektu_nazwaaplikacji. Gdy skończysz, wybierz przycisk Dalej.
3. Wybierz interfejsy API i produkty Advanced Integrated Visibility, które mają zostać uwzględnione w projekcie.
- Produkty Advanced Integrated Visibility są dostępne wyłącznie dla dostawców FedEx Integrator w Stanach Zjednoczonych.
- Jeśli wybierzesz produkty płatne, zostanie wyświetlony monit o przypisanie konta rozliczeniowego do projektu i zaakceptowanie wymaganych warunków.
Przypisywanie konta rozliczeniowego
Uwaga: Jest to wymagane tylko w przypadku wybrania produktu płatnego.
1. Przypisz konto rozliczeniowe z listy kont dodanych do organizacji. Konta rozliczeniowe muszą być zarejestrowane w Stanach Zjednoczonych.
2. Zaakceptuj umowę licencyjną FedEx Developer Portal oraz formularz zamówienia i wybierz opcję Utwórz.
Skonfiguruj funkcję Advanced Integrated Visibility w projekcie
Wymagane składniki
- Przejrzyj wycenę: subskrybenci są obciążani miesięczną opłatą zależną od liczby numerów przesyłek. Zapoznaj się z formularzem zamówienia, aby dowiedzieć się więcej o wycenie.
- Konfigurowanie kont: element webhook widoczności przesyłki wymaga konta rozliczeniowego zarejestrowanego w Stanach Zjednoczonych oraz co najmniej jednego konta wysyłkowego. Te dwa rodzaje kont wzajemnie się wykluczają. Tylko administratorzy mogą dodawać konta rozliczeniowe i wysyłkowe na stronie Zarządzanie organizacją.
1. Utwórz docelowy adres URL w aplikacji lub na platformie, aby otrzymywać wywołania zwrotne. Adres URL:
- musi korzystać z protokołu HTTPS,
- nie może obejmować przestrzeni adresowej RFC1918, domeny fedex.com oraz jej subdomen, ani adresów IP takich jak localhost czy 127.0.0.1.
2. Wygeneruj token zabezpieczeń do uwierzytelniania. Token musi:
- zawierać 26–100 znaków, co najmniej jedną wielką literę, co najmniej jedną małą literę oraz co najmniej jedną liczbę
3. Z menu wybierz pozycję Moje projekty, a następnie wybierz kartę Advanced Integrated Visibility.
4. Wybierz opcję Utwórz projekt Advanced Integrated Visibility.
5. Wybierz typ użytkownika:
- Wysyłający FedEx: korzysta z usług wysyłkowych FedEx i musi zintegrować interfejsy API FedEx z własnymi aplikacjami
- Dostawca FedEx Compatible: jest certyfikowanym dostawcą FedEx Compatible
- Dostawca FedEx Integrator: sprzedaje lub dostarcza oprogramowanie korzystające z technologii FedEx i jest zweryfikowanym dostawcą FedEx Integrator
6. Wybierz rodzaj subskrypcji. Możesz subskrybować zdarzenia według numerów kont lub numerów przesyłek.
7. Potwierdź konto rozliczeniowe i wybierz odpowiednie funkcje, np. potwierdzenie doręczenia, przewidywany termin doręczenia, monitorowane zdarzeń lub filtrowanie według zdarzeń.
8. Wprowadź szczegóły projektu.
- Wprowadź unikalną i rozpoznawalną nazwę projektu.
- Wprowadź docelowy adres URL i utworzony przez siebie token zabezpieczeń.
- Wprowadź adres e-mail i preferowany język, w którym będą wysyłane powiadomienia o aktualizacjach i awariach usługi Advanced Integrated Visibility.
9. Zaakceptuj umowę licencyjną FedEx Developer Portal oraz Formularz zamówienia i wybierz opcję Utwórz.
Uwaga: W zależności od wybranego rodzaju subskrypcji mogą być wymagane dodatkowe kroki. Aby uzyskać szczegółowe informacje, zapoznaj się z dokumentacją elementów webhook.
Wykonaj te kroki, aby zweryfikować integrację interfejsu API i potwierdzić, że aplikacja może wysyłać i odbierać dane testowe.
1. Z menu wybierz opcję Moje projekty, a następnie wybierz pozycję Nazwa projektu.
2. Na karcie Klucze API w obszarze Klucz testowy znajdź poświadczenia testowe.
3. Zaloguj się i pobierz kolekcję JSON API za pomocą przycisku Pobierz schematy JSON znajdującego się na górze strony dokumentacji. Przejrzyj przykładowe żądania dla punków końcowych używanych przez integrację.
4. Poproś o token dostępu OAuth, aby go używać przy każdej transakcji API. Token jest ważny przez godzinę, więc możesz skonfigurować aplikację, aby ją odświeżyć przed wygaśnięciem. Aby uzyskać szczegółowe informacje, patrz Dokumentacja dotycząca API Authorization.
5. Z menu wybierz Katalog interfejsów API, wybierz interfejs API, z którym chcesz pracować, a następnie wybierz pozycję Dokumentacja.
6. Z menu wybierz punkt końcowy.
7. Wyślij przykładowe żądania przy użyciu poświadczeń testowych oraz testowego adresu URL FedEx, a następnie potwierdź, że odpowiedzi są zgodne z przykładami w dokumentacji. Aby uzyskać szczegółowe informacje, zapoznaj się z Poradnikiem wirtualizacji piaskownicy.
8. Wykonaj testy przy użyciu Advanced Integrated Visibility, aby wygenerować przykładowe dane oraz potwierdzić, że procesy aplikacji prawidłowo monitorują informacje.
Uwaga: Testowanie nie uwierzytelnia adresu URL wywołania zwrotnego. Aby uzyskać szczegółowe informacje, patrz Dokumentacja Advanced Integrated Visibility.
Kroki weryfikacji różnią się w różnych regionach
Następujące kroki dotyczą tylko klientów w Stanach Zjednoczonych i Kanadzie. Jeśli mieszkasz w innym kraju, odwiedź stronę Weryfikacja interfejsu API , aby uzyskać pomoc.
Aby przenieść interfejsy API do środowiska produkcyjnego, należy je zweryfikować. Poziom weryfikacji zależy od interfejsu API. Przed rozpoczęciem przejrzyj wymagania dotyczące weryfikacji interfejsu API .
1. Z menu wybierz opcję Moje projekty, a następnie wybierz pozycję Nazwa projektu.
2. Na karcie Klucze API w obszarze Klucz testowy znajdź poświadczenia testowe.
3. Wskaż przypadki testowe dla regionów lub terytoriów, gdzie planujesz wdrożyć rozwiązanie. Aby uzyskać szczegółowe informacje, zapoznaj się z dokumentacją bazową przypadków testowych integratora.
4. Zakończ transakcje rejestracji, korzystając z podanych numerów kont testowych przed uruchomieniem przypadków testowych.
5. Wykonaj wszystkie wymagane przypadki testowe.
6. Wypełnij arkusz informacji o produkcie (PIW), podając dane kontaktowe i wybrane usługi FedEx.
7. Wypełnij formularz weryfikacji integratora.
Prześlij materiały
Prześlij wszystkie wymagane materiały na adres validationmtp@fedex.com.
1. Przygotuj następujące materiały:
- Wypełniony arkusz PIW (PDF)
- Wypełniony formularz weryfikacji (PDF)
- Transakcje rejestracji klienta końcowego z uwierzytelnianiem wieloskładnikowym (JSON)
- Zeskanowane etykiety wysyłkowe dla stosownych odnośnych przypadków testowych (PDF lub PNG)
- Transakcje wysyłkowe dla trzech formatów etykiet (PDF, PNG oraz ZPL (JSON)) dla stosownych interfejsów Shipping i Rating API
- Zrzuty ekranu (PDF) przedstawiające:
- Rozwiązanie skierowane do klientów prezentujące usługi FedEx i obsługę specjalną
- Oświadczenie o wyłączeniu odpowiedzialności
- Umowa licencyjna użytkownika końcowego (EULA)
- Przepływ rejestracji klienta końcowego
2. Skompresuj wszystkie pliki w jeden w formacie ZIP aby uniknąć ograniczeń dostawcy poczty elektronicznej.
3. Wyślij plik ZIP pocztą e-mail zespołowi weryfikującemu.
Najlepsze praktyki w celu uniknięcia opóźnień
Postępuj zgodnie z poniższymi wytycznymi, aby skrócić czas weryfikacji:
- Drukuj i skanuj etykiety w rozdzielczości co najmniej 600 DPI. Nie przesyłaj plików wygenerowanych bezpośrednio z interfejsów API.
- W przypadku drukarek termicznych wybierz typ obrazu zgodny z modelem drukarki, na przykład ZPLII w przypadku drukarek Zebra.
- W przypadku przesyłek FedEx International Express® dołącz dodatkowy (pomocniczy) lotniczy list przewozowy (AWB).
- Dołącz etykietę dla każdej paczki w przesyłkach wieloelementowych (MPS).
Ocena etykiet
Zespół weryfikujący sprawdzi przesłane materiały.
- W przypadku ich odrzucenia odnieś się do informacji zwrotnych i prześlij materiały ponownie.
- W przypadku zatwierdzenia otrzymasz e-mail z potwierdzeniem. Po zaakceptowaniu nastąpi autoryzacja poświadczeń produkcyjnych na potrzeby transakcji z wykorzystaniem etykiet wysyłkowych.
1. Z menu wybierz opcję Moje projekty, a następnie wybierz pozycję Nazwa projektu.
2. W sekcji Interfejsy API skopiuj klucz produkcyjny interfejsu API i klucz tajny, a następnie zapisz je w bezpiecznym miejscu.
Uwaga: Zapisz klucz tajny w bezpiecznym miejscu, ponieważ zostanie on wyświetlony tylko raz. Jeśli go zgubisz, możesz wygenerować nowy.
