De adresvalidatie-API is een slimme oplossing voor onjuiste contactgegevens en maakt een snellere, nauwkeurigere aflevering van pakketten mogelijk. Deze API zorgt voor de juiste opmaak van ingevoerde adresgegevens van de ontvanger, die sterk overeenkomen met een geldig adres en retourneert een bestaand adres dat waarschijnlijk het juiste is.

De API verstrekt ook annotaties over tekortkomingen of aangebrachte wijzigingen in het ingevoerde adres om tot het echte adres te komen. U kunt deze API gebruiken om adresgegevens van de ontvanger te valideren en op te lossen voordat u een pakket verzendt.

Opmerking: Gebruik deze API niet om de leverbaarheid van een adres te bepalen. FedEx biedt niet voor elk geldig adres een afleverservice. FedEx levert niet aan postbussen (behalve via FedEx Ground® Economy (voorheen bekend als FedEx SmartPost®)).

Met deze API kunnen de adresgegevens van de ontvanger worden gevalideerd en gecorrigeerd voordat u een pakket verzendt. Een juist adres op het verzendetiket helpt bij het voorkomen van vertragingen bij de aflevering en meerkosten voor adrescorrectie (als gevolg van verkeerd opgemaakte adressen).

Opmerking:

• De resultaten van omgezette adressen kunnen per land/gebied verschillend zijn.
• Het ingevoerde adres in het verzoek wordt vergeleken met de referentiegegevens in de FedEx-database, waarna het overeenkomende adres wordt geretourneerd.

Functionaliteiten van de adresvalidatie-API

• Levert overeenkomstige adressen op straatniveau.
• Biedt maandelijkse updates van de adresdatabase.
• Maakt onderscheid tussen zakelijke en woonadressen als er een exact overeenkomend adres wordt gevonden.
• Verifieert momenteel geen suite- of appartementnummers.

Mogelijkheden van de adresvalidatie-API

• Vult onvolledige adressen van ontvangers aan. In sommige gevallen kan de adresvalidatie-API ontbrekende gegevens toevoegen, afhankelijk van de verificatie van de verstrekte gegevens op basis van de referentiegegevens. De adresvalidatie-API kan op dit moment geen ontbrekende secundaire gegevens (bijvoorbeeld appartement of suite) toevoegen.
• Biedt maandelijkse updates van de adresdatabase.
• Corrigeert onjuiste adressen van ontvangers. Bijvoorbeeld: de correctie van een onjuiste postcode, zodat deze overeenkomt met de rest van de invoer.
• Bepaalt of het adres een zakelijk of woonadres is voor nauwkeurigere Courtesy Rate Quotes. Dit is alleen van toepassing op adressen in de VS en Canada.
• Bevestigt de geldigheid en volledigheid van adressen in veel landen in de volgende regio's: VS, Canada, Latijns-Amerika, Europa, het Midden-Oosten en Azië-Pacific. U kunt nu binnenlandse en internationale adresgegevens valideren voordat u een pakket verzendt, waardoor onnodige vertragingen bij de aflevering en extra servicekosten worden voorkomen.
• Biedt overeenkomsten op straatniveau.
• Er kunnen per API-aanvraag maximaal 100 adressen worden gecontroleerd.

Landen/gebieden die door de adresvalidatie-API worden ondersteund

U kunt de adresvalidatie-API van FedEx in de volgende landen gebruiken om adressen van ontvangers te valideren en te corrigeren voor efficiënte afleveringen.

Opmerking: De informatie die door het adresvalidatieverzoek wordt geretourneerd, is alleen bedoeld voor voorgesteld gebruik.

Juridische disclaimer: de hierin verstrekte gegevens zijn bedrijfseigen en vertrouwelijke informatie van FedEx, die op uw verzoek als service wordt verstrekt. Geen van deze gegevens mogen, in welke vorm dan ook, worden verspreid of openbaar gemaakt aan derden zonder schriftelijke toestemming van FedEx. De gegevens weerspiegelen de huidige FedEx-classificatie op adresniveau voor bedrijven/particulieren in de FedEx-database met afleveradressen en zijn onderhevig aan wijzigingen. Bij het verstrekken van deze informatie biedt FedEx geen garantie voor de huidige of toekomstige nauwkeurigheid. Daarnaast garandeert FedEx niet dat pakketten die naar deze adressen worden verzonden, worden gefactureerd volgens de hierin vermelde classificatie voor zakelijke of woonadressen. Het verstrekken van deze informatie wordt niet geacht de voorwaarden van de betrekkingen tussen de partijen te wijzigen. Zie de servicegids van FedEx en eventuele toepasselijke prijsafspraken voor accounts voor de voorwaarden en bepalingen met betrekking tot de verzending en kosten van FedEx.

Adresvalidatie

Gebruik dit eindpunt om ingevoerde adressen te valideren en op te lossen, en de echte adressen te retourneren. De adresgegevens worden verstrekt en gevalideerd om een adres op te lossen. Een adres wordt als opgelost weergegeven wanneer het ingevoerde adres overeenkomt met de bestaande referentiegegevens.

De vereiste invoergegevens die bij dit verzoek horen, zijn:

• Adresregels
• Plaats (optioneel)
• Staat of provinciecode (optioneel)
• Postcode (optioneel)
• Landcode

Opmerking: De code van de staat of de plaatsnaam is voldoende wanneer de klant naar een land verzendt waarin geen postcodes worden gehanteerd.

De adresvalidatie-API retourneert een correct adres door op het ingevoerde adres de volgende bewerkingen uit te voeren:

• Allereerst probeert de API het ingevoerde adres te normaliseren. Dit omvat bijvoorbeeld het vervangen van veelgebruikte wegaanduidingen zoals straat en parkway door hun standaard afkortingen zoals ST en PKWY, en het opnieuw ordenen van onderdelen van het adres. Als een ingevoerd adres niet kan worden genormaliseerd, worden de geretourneerde opgeloste adressen het ingevoerde adres. Niet-adreswaarden worden genegeerd.
• In de tweede stap probeert de API het genormaliseerde adres te standaardiseren door een mogelijk of feitelijk adres te vinden dat waarschijnlijk het door de gebruiker bedoelde adres is. Als die standaardisatie mislukt, zijn de geretourneerde adressen de genormaliseerde vorm van het ingevoerde adres. Raadpleeg de geretourneerde elementen om de problemen met het opgegeven adres te helpen bepalen.
• Bepaalde elementen van dat genormaliseerde adres zullen ook worden geretourneerd. Als de standaardisatie slaagt, zijn de geretourneerde opgeloste adressen gelijk aan het echte adres. In dit geval worden ook verschillende aanvullende elementen van het gestandaardiseerde adres geretourneerd, evenals informatie over hoe het is afgeleid van het genormaliseerde adres.

Retourwaarden van de adresvalidatie-API

Het adres is geldig als onderstaande kenmerken van het geretourneerde adres de volgende waarden bevatten:

• De adresstatus is gestandaardiseerd
• De kenmerken van het opgeloste adres zijn ingesteld op 'waar'
• Leveringspunt geldig (DPV) is ingesteld op 'waar'
• Het geïnterpoleerde adres is ingesteld op 'onwaar'

Als deze niet in de lijst staan, gebruik dan aanvullende kenmerken om de mogelijke problemen met de adreswaarden te bepalen.

Voor meer informatie over de adreskenmerken, zie Adreskenmerken.

Als het uitgaande geretourneerde klantbericht INTERPOLATED.STREET.ADDRESS is, is het adres mogelijk niet geldig. Voor meer informatie over de berichtcode van de klant raadpleegt u de elementbeschrijving van het klantbericht.

Annotaties

De adresvalidatie-API retourneert annotaties bij elk gevalideerd en geretourneerd adres. De annotaties geven u informatie over eventuele tekortkomingen en aangebrachte wijzigingen in het ingevoerde adres om tot het echte adres te komen.

De adresvalidatie-API gebruikt referentiegegevens om de classificatie van een bepaald adres te bepalen. De classificatie voor een functioneel adres wordt onafhankelijk van het adresvalidatieproces berekend en is gebaseerd op feedback van operationeel personeel, waarbij commerciële gegevensbronnen alleen ter bevestiging worden gebruikt.

De adresvalidatie-API heeft slechts vier mogelijke classificaties voor adressen: onbekend, zakelijk, woonwijk en gemengd. Alle adressen hebben eerst een 'onbekende' classificatie en dit blijft zo totdat de bedrijfsregels voor adresvalidatie bepalen dat hun classificaties moeten veranderen. Een locatie krijgt alleen een 'gemengde' classificatie als het een adres met meerdere bewoners is en zowel bedrijfs- als wooneenheden bevat.

Opmerking: De FedEx Express-service biedt een extra adresregel (adresregel 3) voor adressen van ontvangers. Deze aanvullende adresgegevens bieden volledigere en nauwkeurigere locatiegegevens, waardoor de kans op het verkrijgen van een nauwkeurig adres wordt vergroot.

De echte adressen zijn als volgt geclassificeerd:

Zakelijk adres

Een zakelijk adres is een adres dat wordt gebruikt om de hoofdvestiging van uw bedrijf aan te duiden. Het is de plaats van waaruit uw bedrijf wordt verondersteld actief te zijn, maar dat is niet altijd het geval.

Een zakelijk adres is de officiële locatie van het pand van een bedrijf. Het kan van alles zijn, van iemands huisadres tot een campus van meerdere miljoenen dollars, wat vaak de voorkeur heeft van grote technologiebedrijven, en alles daartussenin.

Woonadres

Leverkosten voor woonadressen zijn van toepassing op zendingen binnen de VS naar een huis of privéwoning, met inbegrip van locaties waar vanuit een huis een bedrijf wordt gerund. Gebruik FedEx Home Delivery voor levering op woonadressen via FedEx Ground binnen 1 werkdag, op basis van de afstand tot de bestemming.

Voorbeeld:

• Predikantswoning
• Klooster
• Pastorie
• Bewoners van meergezinswoningen, zoals
  • Flatgebouwen
  • Appartementen
  • Studentenwoningen

• Een woning van waar producten worden verkocht en/of gedistribueerd

Hieronder volgen enkele nuttige tips voor het gebruik van de adresvalidatie-API:

• Gebruik de juiste spatiëring: zorg ervoor dat spaties correct worden geplaatst en vermijd onnodige spaties.
• Gebruik de juiste spelling: vermijd spel- en typfouten. Zorg er ook voor dat u het cijfer nul (0) en de letter O op de juiste wijze gebruikt.
• Gebruik geen speciale tekens: gebruik geen speciale tekens die niet zijn vereist voor het adres, zoals punten na afkortingen ('Ave' in plaats van 'Ave.').
• Verstrek aanvullende adres- en straatgegevens: door aanvullende adresinformatie te verstrekken, kunt u de nauwkeurigheid van de adresresultaten vergroten.
  • Gebouw- of huisnummer: 1, 1A, 1½, één
  • Straatnaam: Main, George Washington, 42^nd
  • Straattoevoeging: Road, Avenue, Rd, Ave
• Voer de stad, staat/provincie en postcode in: wanneer u deze drie gegevens verstrekt, worden de resultaten van uw adressen nauwkeuriger.
• Vul de straatnaam en het adres in de juiste volgorde in: de onderdelen van een adres hebben meestal een bepaalde volgorde die begint met het gebouw- of huisnummer gevolgd door een algemeen geografisch onderdeel, zoals een straatnaam, straattype of achtervoegsel, gevolgd door een specifiek geografisch onderdeel, zoals een appartementaanduiding, appartementnummer en/of aanduiding of nummer van de privébrievenbus.
• Gebruik de juiste afkortingen: de U.S. Postal Service en Canada Post hanteren standaardafkortingen voor de staat/provincie, achtervoegsels van straatnamen en aanduidingen van appartementen en eenheden.
  • Een niet-standaard afkorting kan slechte zoekresultaten opleveren.
  • Wanneer u niet zeker bent van een afkorting, gebruik deze dan niet.

Bijvoorbeeld:

• Een gebouw- of huisnummer, zoals: 1, 1A, één.
• Een straatnaam, zoals: Main, George Washington, 42nd.
• Achtervoegsel van de straatnaam, zoals Road, Avenue, Rd, Ave.
• Voer de plaatsnaam, staat/provincie en postcode in: door alle adresgegevens te verstrekken, verhoogt u de nauwkeurigheid van uw zoekresultaten. Het gedeelte ZIP+4 van een postcode is niet nodig om een adres te controleren.
• Gebruik de juiste afkortingen: de United States Postal Service en postautoriteiten in andere landen hanteren standaardafkortingen voor de staat/provincie, het achtervoegsel van straatnamen en aanduidingen van appartementen/eenheden. Een niet-standaard afkorting kan leiden tot slechte zoekresultaten. Wanneer u niet zeker bent van een afkorting, gebruik deze dan niet.
• Overweeg om de responsfeedback van de adresvalidatie terug te sturen naar de gebruiker, zodat hij of zij het meest nauwkeurige adres kan selecteren.

• Gebruik deze API niet om de leverbaarheid voor pakketten van een adres te bepalen. FedEx biedt niet voor elk geldig adres een afleverservice. FedEx levert niet aan postbussen (behalve via FedEx Ground® Economy (voorheen bekend als FedEx SmartPost^®)).
• De informatie die door het adresvalidatieverzoek wordt geretourneerd, is alleen bedoeld voor voorgesteld gebruik.
• Er kunnen per verzoek maximaal 100 adressen worden gecontroleerd.
• Het minimale aantal vereiste velden verschilt per land.

  Voor adressen in de VS zijn bijvoorbeeld minstens één adresregel en ofwel een postcode of een plaatsnaam en een staatcode vereist. Voor AUS-adressen (de adresopmaak in Australië) kunnen zelfs de postcode en de staatcode worden weggelaten.

• Het resultaat van het omgezette adres kan per land/gebied verschillend zijn.

Opmerking: De adresvalidatie-API is mogelijk niet van toepassing op alle landen. Meer informatie hierover vindt u in de paragraaf Landen/gebieden waarin de adresvalidatie-API wordt ondersteund..