Die Adressprüfungs-API ist eine intelligente Lösung, mit der sich ungenaue Kontaktinformationen korrigieren und Pakete schnell und präzise zustellen lassen. Diese API formatiert die eingegebenen Empfängerdaten so, dass sie einer gültigen Adresse entsprechen, und gibt eine tatsächliche Adresse aus, bei der es sich wahrscheinlich um die richtige handelt.

Die API liefert auch Informationen zu Abweichungen in der eingegebenen Adresse oder zu Änderungen, die erforderlich waren, um zu dieser tatsächlichen Adresse zu gelangen. Mit dieser API können Sie die Empfängeradresse überprüfen und mögliche Probleme beheben, bevor Sie ein Paket versenden.

Hinweis: Mit dieser API können Sie nicht die Zustellbarkeit an eine Adresse ermitteln. FedEx bietet nicht für alle gültigen Adressen einen Zustellservice an. FedEx liefert nicht an Postfächer (außer über FedEx Ground® Economy, früher FedEx SmartPost®).

Mit dieser API können vor dem Paketversand die Informationen der Empfängeradresse überprüft und korrigiert werden. Genaue Adressen auf dem Versandetikett helfen, Zustellungsverzögerungen und Zuschläge für eine Adresskorrektur (aufgrund von Adressen in falschen Formaten) zu vermeiden.

Hinweis:

• Die Ergebnisse der Adressprüfung sind je nach Land/Gebiet unterschiedlich.
• Die in der Anfrage eingegebene Adresse wird mit den Referenzdaten in der FedEx Datenbank abgeglichen. Anschließend wird die übereinstimmende Adresse ausgegeben.

Funktionen der Adressprüfungs-API

• Übereinstimmende Postanschriften werden bereitgestellt.
• Die Adressdatenbank wird monatlich aktualisiert.
• Bei exakten Übereinstimmungen wird zwischen Geschäfts- und Privatadressen unterschieden.
• Zimmer- oder Wohnungsnummern werden derzeit nicht überprüft.

Merkmale der Adressprüfungs-API

• Unvollständige Empfängeradressen werden vervollständigt. In einigen Fällen kann die Adressprüfungs-API fehlende Informationen ergänzen. Dafür werden die bereitgestellten Informationen mit Referenzdaten abgeglichen. Die Adressprüfungs-API kann derzeit keine fehlenden zusätzlichen Informationen (z. B. Wohnung oder Zimmer) hinzufügen.
• Die Adressdatenbank wird monatlich aktualisiert.
• Ungültige Empfängeradressen werden korrigiert. Zum Beispiel wird eine falsch angegebene Postleitzahl korrigiert, damit sie mit dem Rest der Eingabe übereinstimmt.
• Es wird ermittelt, ob es sich bei der eingegebenen Adresse um eine Geschäfts- oder Privatadresse handelt, um die Genauigkeit von Preisanfragen zu verbessern (gilt nur für Adressen in den USA und Kanada).
• Die Gültigkeit und Vollständigkeit von Adressen wird in vielen Ländern der folgenden Regionen bestätigt: USA, Kanada, Lateinamerika, Europa, Naher Osten und Asien-Pazifik-Raum. Sie können vor dem Paketversand ab sofort Adressen im In- und Ausland überprüfen, um Zustellungsverzögerungen und Zuschläge zu vermeiden.
• Übereinstimmende Postanschriften werden bereitgestellt.
• Mit einer API-Abfrage können bis zu 100 Adressen geprüft werden.

Länder/Gebiete mit Unterstützung der Adressprüfungs-API

Für die folgenden Länder können Sie die FedEx Adressprüfungs-API nutzen, um für eine effiziente Zustellung die Empfängeradressen zu überprüfen und zu korrigieren.

Hinweis: Die über die Anfrage „Adresse validieren“ zurückgegebenen Informationen dienen lediglich als Empfehlung.

Haftungsausschluss: Bei den hier bereitgestellten Daten handelt es sich um geschützte und vertrauliche Informationen von FedEx, die wir Ihnen auf Ihre Anfrage hin als Service zur Verfügung stellen. Kein Teil dieser Daten darf ohne die schriftliche Genehmigung von FedEx in irgendeiner Form an Dritte weitergegeben oder diesen gegenüber offengelegt werden. Es handelt sich um die aktuelle Klassifizierung von FedEx für Geschäfts- und Privatadressen in der FedEx Zustelladressdatenbank. Diese unterliegt Änderungen. Mit der Bereitstellung dieser Informationen übernimmt FedEx keine Garantie für deren gegenwärtige oder zukünftige Richtigkeit und garantiert nicht, dass Pakete, die an diese Adressen versendet werden, gemäß der hier angegebenen Klassifizierung für Geschäfts- und Privatadressen abgerechnet werden. Die Bereitstellung dieser Informationen ändert nichts an den Bedingungen der Beziehung zwischen den Parteien. Im FedEx Service Guide und in den geltenden Preisvereinbarungen finden Sie die allgemeinen Geschäftsbedingungen, die für die FedEx Versandkosten gelten.

Adresse validieren

Über diesen Endpunkt können Sie eingegebene Adressen überprüfen und korrigieren. Es werden tatsächlich existierende Adressen zurückgegeben. Zur Vervollständigung einer Adresse werden die Adressdaten bereitgestellt und überprüft. Eine Adresse gilt als vervollständigt, wenn die eingegebene Adresse mit den bekannten Referenzdaten übereinstimmt.

Die für diese Anfrage erforderlichen Eingabedaten sind:

• Adresszeilen
• Ort (optional)
• Code für Bundesstaat/Provinz (optional)
• Postleitzahl (optional)
• Ländercode

Hinweis: Der Code für den Bundesstaat oder der Ortsname reicht beim Versand in Länder aus, die keine Postleitzahlen verwenden.

Die Adressprüfungs-API gibt eine tatsächliche Adresse zurück, indem für die eingegebene Adresse folgende Verfahren durchgeführt werden:

• Zunächst versucht die API, die eingegebene Adresse zu normalisieren. Dabei werden gängige Bezeichnungen wie beispielsweise „Straße“ durch die entsprechende Standardabkürzung ersetzt (z. B. Str.). Darüber hinaus werden die Komponenten der Adresse neu geordnet. Wenn eine eingegebene Adresse nicht normalisiert werden kann, wird als Ergebnis die eingegebene Adresse zurückgegeben. Nicht zur Adresse gehörende Daten werden verworfen.
• Im Anschluss versucht die API, die normalisierte Adresse zu standardisieren, indem nach einer möglichen oder tatsächlichen Adresse gesucht wird, die der Benutzer wahrscheinlich eingeben wollte. Wenn diese Standardisierung fehlschlägt, wird die Adresse in der normalisierten Form der eingegebenen Adresse zurückgegeben. Prüfen Sie die zurückgegebenen Elemente, um Probleme mit der ausgegebenen Adresse zu ermitteln.
• Bestimmte Elemente dieser normalisierten Adresse werden ebenfalls zurückgegeben. Wenn die Standardisierung erfolgreich ist, entsprechen die zurückgegebenen Adressen den tatsächlichen Adressen. In diesem Fall werden auch verschiedene zusätzliche Elemente der standardisierten Adresse zurückgegeben sowie Informationen dazu, wie diese aus der normalisierten Adresse abgeleitet wurde.

Ergebnisse der Adressprüfungs-API

Wenn die zurückgegebene Adresse die folgenden Werte für die unten aufgeführten Merkmale aufweist, ist die Adresse gültig:

• Adressstatus ist „Standardisiert“
• Merkmale der ausgegebenen Adresse sind „Wahr“
• „Zustellort zulässig (DPV)“ ist „Wahr“
• „Interpolierte Adresse“ ist „Falsch“

Wenn diese Merkmale nicht aufgeführt sind, lassen sich mögliche Probleme mit den Adresswerten anhand der zusätzlichen Merkmale ermitteln.

Weitere Informationen zu Adressmerkmalen finden Sie unter Adressmerkmale.

Wenn der ausgegebene Kundennachrichten-Code INTERPOLATED.STREET.ADDRESS lautet, besteht die Möglichkeit, dass die Adresse nicht gültig ist. Weitere Informationen zum Kundennachrichten-Code finden Sie in der Elementbeschreibung der Kundennachricht.

Anmerkungen

Die Adressprüfungs-API gibt Anmerkungen zu jeder überprüften und zurückgegebenen Adresse aus. Die Anmerkungen liefern Ihnen Informationen über eventuelle Fehler und die Änderungen, die an der eingegebenen Adresse vorgenommen wurden, um zu dieser tatsächlichen Adresse zu gelangen.

Die Adressprüfungs-API verwendet Referenzdaten, um die Klassifizierung einer bestimmten Adresse zu bestimmen. Die Klassifizierung für eine funktionale Adresse wird unabhängig von der Adressprüfung berechnet und basiert auf Rückmeldungen von Mitarbeitern, wobei nur gewerbliche Datenquellen zur Bestätigung verwendet werden.

Die Adressprüfungs-API verfügt über vier mögliche Klassifizierungen für Adressen: unbekannt, geschäftlich, privat und gemischt. Alle Adressen verfügen anfangs über die Klassifizierung „Unbekannt“ und verbleiben in dieser Klassifizierung, bis Geschäftsregeln für die Adressprüfung eine Änderung der Klassifizierung festlegen. Ein Standort erhält nur dann die Klassifizierung „Gemischt“, wenn es sich um eine Adresse mit mehreren Mietparteien mit sowohl Geschäfts- als auch Wohneinheiten handelt.

Hinweis: Der FedEx Express Service stellt eine zusätzliche Adresszeile (Adresszeile 3) für Empfängeradressen bereit. Diese zusätzlichen Adressinformationen liefern vollständigere und genauere Angaben zum Standort, wodurch sich Ihre Chancen auf eine genaue Adresse erhöhen.

Tatsächliche Adressen werden wie folgt klassifiziert:

Geschäftsadresse

Eine Geschäftsadresse ist eine Adresse, die den Hauptgeschäftssitz bezeichnet. Hier ist Ihr Unternehmen hauptsächlich tätig. Dies muss jedoch nicht immer der Fall sein.

Eine Geschäftsadresse ist der offizielle Standort eines Unternehmens. Dieser Standort kann sich an einer Privatadresse oder auf einem weitläufigen Campus eines großen Technologieunternehmens befinden.

Privatadresse

Für Sendungen innerhalb der USA an eine Privatadresse (einschließlich Standorten, an denen ein Unternehmen von einer Privatadresse aus betrieben wird), wird ein Zuschlag für die Zustellung an Privatpersonen erhoben. Verwenden Sie für die Zustellung an Privatpersonen FedEx Home Delivery über FedEx Ground. Die Zustellung erfolgt je nach Entfernung zum Bestimmungsort innerhalb von 1 Werktag.

Beispiel:

• Pfarrhäuser
• Kloster
• Pastorenhäuser
• Bewohner von Mehrfamilienhäusern, darunter:
  • Apartmentgebäude
  • Wohnanlagen
  • Studentenwohnheime

• Wohngebäude mit Verkaufs- und/oder Lieferbereich

Hier finden Sie einige hilfreiche Tipps zur Nutzung der Adressprüfungs-API:

• Leerstellen beachten: Stellen Sie sicher, dass die Leerstellen stimmen und vermeiden Sie unnötige Leerstellen.
• Schreibweise beachten: Versuchen Sie, Rechtschreib- und Tippfehler zu vermeiden. Stellen Sie sicher, dass Sie die Ziffer Null (0) und den Großbuchstaben „O“ nicht vertauschen.
• Sonderzeichen vermeiden: Verwenden Sie möglichst keine Sonderzeichen, die für die Adresse nicht erforderlich sind (z. B. Punkte bei einer Abkürzung: „Str“ statt „Str.“).
• Zusätzliche Angaben zur Anschrift bereitstellen: Durch die Angabe zusätzlicher Adressinformationen können Sie die Genauigkeit der Adressergebnisse erhöhen.
  • Gebäude- oder Hausnummer – 1, 1A, 1½, Eins
  • Straßenname – Haupt, Theodor Heuss
  • Straßenzusatz – Straße, Allee, Str
• Ort, Bundesstaat/Provinz und Postleitzahl eingeben: Wenn Sie alle drei Informationen angeben, erhöht sich die Genauigkeit Ihrer Adressergebnisse.
• Anschrift in korrekter Reihenfolge eingeben: Die Elemente einer Anschrift folgen in der Regel einem bestimmten Format. Zum Beispiel steht am Anfang der Straßenname, gefolgt von der Straßenart bzw. einem Suffix, der Gebäude- oder Hausnummer, einer Wohnungsbezeichnung, einer Wohnungsnummer und/oder einer Bezeichnung und Nummer eines privaten Postfachs.
• Korrekte Abkürzung beachten: Der U.S. Postal Service und Canada Post verwenden Standardabkürzungen für Bundesstaaten/Provinzen, Straßensuffixe und Wohnungs- oder Gebäudebezeichnungen.
  • Eine nicht konforme Abkürzung führt ggf. zu weniger Suchergebnissen.
  • Verwenden Sie nur Abkürzungen, bei denen Sie wissen, dass diese üblich sind.

Beispiel:

• Gebäude- oder Hausnummer wie 1, 1A, Eins.
• Straßenname wie Haupt-, Theodor Heuss.
• Straßensuffix wie Straße, Allee, Str.
• Ort, Bundesstaat/Provinz und Postleitzahl eingeben: Wenn Sie alle Informationen angeben, erhöht dies die Genauigkeit Ihrer Adressergebnisse. Der Abschnitt „ZIP+4“ der Postleitzahl ist zur Prüfung einer Anschrift nicht erforderlich.
• Korrekte Abkürzung beachten: Der U.S. Postal Service und Postdienstleister in anderen Ländern verwenden Standardabkürzungen für Bundesstaaten/Provinzen, Straßensuffixe und Wohnungs- oder Gebäudebezeichnungen. Eine nicht konforme Abkürzung führt ggf. zu weniger Suchergebnissen. Verwenden Sie nur Abkürzungen, bei denen Sie wissen, dass diese üblich sind.
• Sie können auch die Ergebnisse der Adressprüfung an den Anwender weiterleiten und diesen darum bitten, die richtige Adresse auszuwählen.

• Verwenden Sie diese API nicht, um die Zustellbarkeit an eine Adresse zu ermitteln. FedEx Express bietet nicht für alle gültigen Adressen einen Zustellservice an. FedEx Express liefert nicht an Postfächer (außer über FedEx Ground® Economy, früher FedEx SmartPost^®).
• Die zur jeweiligen Adresse ausgegebenen Informationen dienen lediglich als Empfehlung.
• Mit einer Abfrage können bis zu 100 Adressen überprüft werden.
• Die Anzahl der Pflichtfelder ist je nach Land unterschiedlich.

  Beispielsweise sind für Adressen in den USA mindestens eine Adresszeile und eine Postleitzahl oder ein Ort und der Bundesstaaten-Code erforderlich, für australische Adressen kann der Bundesstaaten-Code hingegen weggelassen werden, auch wenn die Postleitzahl fehlt.

• Die Ergebnisse der Adressprüfung sind je nach Land/Gebiet unterschiedlich.

Hinweis: Die Adressprüfungs-API steht eventuell nicht in allen Ländern zur Verfügung. Weitere Informationen hierzu finden Sie im Abschnitt Länder/Gebiete mit Unterstützung der Adressprüfungs-API.