Interfejs API weryfikacji kodu pocztowego FedEx umożliwia klientom FedEx weryfikowanie kodów pocztowych i uzyskiwanie zobowiązań do wykonania usługi. Obsługuje wyszukiwanie oraz weryfikację w oparciu o miejscowości, kody pocztowe, kraje oraz pary pochodzenie/przeznaczenie. W odpowiedzi zwraca zweryfikowany kod pocztowy i szczegóły lokalizacji.

Interfejs API weryfikacji kodu pocztowego weryfikuje kody pocztowe dla krajów i miejscowości oraz zwraca oczyszczony kod pocztowy jako odpowiedź. Prawidłowo sformatowane kody pocztowe są niezbędne do przetworzenia przesyłki lub utworzenia etykiet wysyłkowych.

Ten interfejs API wykorzystuje wprowadzone dane wejściowe, takie jak data wysyłki, kod pocztowy, kod kraju i inne informacje, a następnie sprawdza, czy nie ma niezgodności między wartościami stanu i miejscowości. Miejscowość i stan są ustawiane w przypadku wykrycia niezgodności, jeśli kraj to Stany Zjednoczone lub Kanada. Przykłady: FDXE – FedEx Express^®, FDXG – FedEx Ground^® i FXSP – FedEx Ground^® Economy (wcześniej pod nazwą FedEx SmartPost^®). Interfejs API weryfikuje wprowadzone dane wejściowe, a następnie dostarcza szczegóły lokalizacji i oczyszczony kod pocztowy.

FedEx świadczy usługi zarówno do krajów, w których stosuje się kody pocztowe, jak i do krajów bez kodów pocztowych.

Kraje, w których stosuje się kody pocztowe

Przesyłki do tych krajów powinny zawierać kody pocztowe na lotniczych listach przewozowych i innych dokumentach na potrzeby zmniejszenia opóźnień i zmaksymalizowania wydajności. Klientów FedEx Express należy zachęcać do podawania w adresach prawidłowych kodów pocztowych dla odbiorców znajdujących się w poniższych krajach.

Aby uzyskać więcej informacji na temat krajów, w których stosuje się kody pocztowe, patrz Kraje, w których stosuje się kody pocztowe.

Kraje, w których nie stosuje się kodów pocztowych

Jak sama nazwa wskazuje, istnieją kraje obsługiwane przez FedEx, w których nie stosuje się kodów pocztowych. W przypadku takich krajów nie jest konieczne podawanie kodów pocztowych dla przesyłek. Kod stanu lub nazwa miejscowości są wystarczające, jeśli klient wysyła towar do kraju, w których nie stosuje się kodów pocztowych. Jeśli wystąpi błąd weryfikacji dla kraju, który nie używa kodów pocztowych, spróbuj wymusić użycie adresu, wpisując „00000” jako zastępczy kod pocztowy. Użycie tego fałszywego kodu pocztowego nie powinno powodować problemów, ponieważ kod nie istnieje.

Poniżej przedstawiono korzyści wynikające z korzystania z interfejsu API weryfikacji kodu pocztowego FedEx

• Skrócenie opóźnień przesyłek i zwiększenie wydajności.
• Zwiększenie liczby terminowych i dostarczonych doręczeń.
• Usprawnienie usług FedEx w obszarach miejskich, co zapewnia elastyczność w zakresie ostatecznej godziny odbioru i harmonogramów odbioru.

Interfejs API weryfikacji kodu pocztowego FedEx używa następującego punktu końcowego do weryfikowania kodów pocztowych dla miejscowości, krajów i par pochodzenie/przeznaczenie. W poniższej sekcji opisano najważniejsze dane wejściowe i odpowiedzi punktu końcowego:

Weryfikacja kodu pocztowego

To zapytanie służy do zwracania szczegółów kodu pocztowego, oczyszczonego kodu pocztowego i opisu lokalizacji na podstawie wprowadzonych danych wejściowych. Kluczowe dane wejściowe powiązane z tym zapytaniem to:

• carrierCode
• countryCode
• stateOrProvinceCode
• postalCode
• shipDate

Zakończony powodzeniem wynik tego zapytania to wartości locationdetails i cleanedpostalcode dla podanych danych wejściowych. Zapytanie nie powiedzie się, jeśli kod pocztowy jest nieprawidłowy, na przykład gdy kombinacja kodu kraju, stanu/prowincji i kodu pocztowego jest niepoprawna.

Wyjaśnienie typowych nieporozumień

• Nie jest możliwe wzajemne powiązanie dopasowania terytorium z dopasowaniem kodu pocztowego, ponieważ są to odrębne wyniki procesu dopasowywania.
• Nie wszystkie lokalizacje geograficzne na świecie mają kody pocztowe.

Aby uzyskać więcej informacji na temat listy specyficznej dla regionu, patrz Lista usług specyficznych dla regionu.

• Kombinacja numeru, nazwy ulicy itp. Wymagana jest co najmniej jedna linia dla prawidłowego adresu fizycznego; puste linie adresu są niedozwolone.
• Wymagany jest dwuliterowy kod stanu lub prowincji, jeśli krajem odbiorcy są Stany Zjednoczone lub Kanada, bądź jeśli ma zastosowanie EEI, a krajem jest Meksyk {MX}.
• Dane opisowe lokalizacji fizycznej mogą zostać użyte jako adres fizyczny (miejsce, które można odwiedzić) lub jako kontener dla „części adresu”, które powinny być obsługiwane jako jednostka (np. kombinacja miejscowości, stanu i kodu pocztowego w Stanach Zjednoczonych).
• Format i obecność pola kodu pocztowego będzie się różnić w zależności od kraju.