Fedex Logo

Introduktion

API'en til adressevalidering er en smart løsning til at rette unøjagtige kontaktoplysninger og muliggøre hurtigere og nøjagtig levering af pakker. Denne API formaterer på behørig vis de indtastede modtageradresseoplysninger, der minder meget om en gyldig adresse, og sender en rigtig adresse, der sandsynligvis er den tilsigtede, retur.

API'en giver også kommentarer om manglende oplysninger i den indtastede adresse eller ændringer, der blev foretaget i indtastningen for at nå frem til den virkelige adresse. Du kan bruge denne API til at validere og rette modtagerens adresseoplysninger, inden du sender en pakke.

Bemærk: Brug ikke denne API til at bestemme, om der kan leveres til en adresse. FedEx tilbyder ikke leveringsservices til enhver gyldig adresse. FedEx leverer ikke til postbokse med undtagelse af FedEx Ground® Economy (tidligere FedEx SmartPost®).

Detaljer om API til adressevalidering

Denne API giver dig mulighed for at validere og rette modtagerens adresseoplysninger, inden du sender en pakke. Nøjagtige adresser på forsendelsesetiketten hjælper med at undgå leveringsforsinkelser og yderligere gebyrer for adressekorrektion (på grund af forkerte adresser).

Bemærk:

  • Adresseresultaterne varierer afhængigt af land/område.
  • Den indtastede adresse i anmodningen sammenlignes med referencedataene i FedEx-databasen, og den matchede adresse vises.

Funktioner for API til adressevalidering

  • Giver matchende adresser på gadeniveau.
  • Modtager månedlige opdateringer af adressedatabasen.
  • Skelner mellem erhvervs- og privatadresser, hvis der findes et nøjagtigt match.
  • Bekræfter i øjeblikket ikke suite- eller lejlighedsnumre.

Kapacitet for API til adressevalidering

  • Fuldfører ufuldstændige modtageradresser. I nogle tilfælde vil API'en til adressevalidering være i stand til at tilføje manglende oplysninger afhængigt af verifikationen af de leverede oplysninger i forhold til referencedata. API til adressevalidering kan i øjeblikket ikke tilføje manglende sekundære oplysninger (dvs. lejlighed eller suite).
  • Modtager månedlige opdateringer af adressedatabasen.
  • Retter ugyldige modtageradresser. For eksempel redigering af et forkert postnummer for at stemme overens med resten af indtastningen.
  • Bestemmer, om adressen er en erhvervs- og privatadresse for at øge nøjagtigheden af prisoverslag. Gælder kun for adresser i USA og Canada.
  • Kontrollerer gyldigheden og fuldstændigheden af adresser i mange lande i disse regioner: USA, Canada, Latinamerika, Europa, Mellemøsten og Stillehavsasien. Du kan nu validere indenlandske og internationale adresseoplysninger, inden du sender en pakke og forhindre unødvendige forsinkelser og yderligere servicegebyrer.
  • Giver matchende adresser på gadeniveau.
  • Du kan kontrollere op til 100 adresser i én API-anmodning.

Lande/områder, der understøtter API til adressevalidering

Du kan bruge FedEx API'en til adressevalidering i følgende lande til at validere og korrigere modtageradresser og sikre effektive leveringer.

Antillerne Danmark Panama
Argentina Den Dominikanske Republik Peru
Aruba Estland Portugal
Australien Finland Singapore
Østrig Frankrig Sydafrika
Bahamas Tyskland Spanien
Barbados Grækenland Sverige
Belgien Guatemala Schweiz
Bermuda Hongkong SAR, Kina Trinidad og Tobago
Brasilien Italien Storbritannien
Canada Jamaica USA
Caymanøerne Malaysia Uruguay
Chile Mexico Venezuela
Columbia Holland Jomfruøerne
Costa Rica New Zealand  
Tjekkiet Norge  

 

Bemærk: De oplysninger, der returneres ved anmodning om adressevalidering, er kun til anbefalet brug.

Juridisk ansvarsfraskrivelse: Oplysningerne i nærværende dokument er FedEx-beskyttede og fortrolige oplysninger, leveret på din anmodning. Ingen del af disse oplysninger må distribueres eller videregives i nogen form til tredjepart uden skriftlig tilladelse fra FedEx. Det afspejler den aktuelle FedEx-klassifikation af erhvervs-/privatadresser i FedEx-leveringsadressedatabasen og kan ændres. Ved levering af disse oplysninger garanterer FedEx ikke for deres nuværende eller fremtidige nøjagtighed og garanterer ikke, at pakker, der sendes til disse adresser, faktureres i henhold til den erhvervs-/privatklassifikation, der er angivet heri. Levering af disse oplysninger anses ikke for at ændre vilkårene for forholdet mellem parterne. Se FedExServicevejledning og enhver gældende aftale om prisfastsættelse for konti vedrørende de vilkår og betingelser, der gælder for FedEx-forsendelser og -gebyrer.

Sådan fungerer API til adressevalidering

Validering af adresse

Bruger dette slutpunkt til at validere og korrigere indtastede adresser og returnerer virkelige adresser. Adresseoplysningerne gives og valideres for at korrigere en adresse. En adresse angives som korrigeret, når den indtastede adresse matcher de kendte referencedata.

De påkrævede indtastningsoplysninger knyttet til denne anmodning er:

  • Gadelinjer
  • By (valgfrit)
  • Kode for delstat eller provins (valgfrit)
  • Postnummer (valgfrit)
  • Landekode

Bemærk: Statskode eller bynavn er tilstrækkelig, når kunden sender til et land, der ikke har et postnummer.

API'en til adressevalidering viser en reel adresse ved at udføre følgende handlinger for den indtastede adresse:

  • Som et første skridt forsøger API'en at normalisere den indtastede adresse. Dette kan omfatte udskiftning af almindelige adresseidentifikatorer såsom gade og boulevard med disses standardforkortelser samt omarrangering af komponenter i adressen. Hvis en indtastet adresse ikke kan normaliseres, er den korrigerede adresse, der returneres, den indtastede adresse. Værdier, der ikke er adresser, kasseres.
  • Som næste skridt forsøger API'en at standardisere den normaliserede adresse ved at finde en mulig eller faktisk adresse, der sandsynligvis er den af brugeren tilsigtede. Hvis standardiseringen mislykkes, vil de adresser, der returneres, være den normaliserede form af den indtastede adresse. Se de returnerede elementer for at hjælpe til at bestemme problemerne med den indtastede adresse.
  • Visse elementer i den normaliserede adresse vises også. Hvis standardisering lykkes, er de korrigerede adresser, der returneres, den rigtige adresse. I så fald vises også forskellige yderligere elementer af den standardiserede adresse og information om, hvordan det blev afledt af den normaliserede adresse.

Returværdier for API til adressevalidering

Hvis den returnerede adresse omfatter følgende værdier for nedenstående egenskaber, er adressen gyldig:

  • Adressetilstand er standardiseret
  • Egenskaber for korrigeret adresse er sande
  • Leveringspunkt gyldigt (DPV) er sandt
  • Interpoleret adresse er falsk

Hvis disse ikke er angivet, skal du bruge de ekstra egenskaber til at afgøre de mulige problemer med adresseværdierne.

Se Adresseegenskaber for nærmere oplysninger om adresseegenskaber.

Hvis kundemeddelelsen INTERPOLATED.STREET.ADDRESS vises, er adressen muligvis ikke er gyldig. Hvis du ønsker nærmere information om kundemeddelelseskode, henvises der til elementbeskrivelsen af kundemeddelelse.

Urbanisering (kun Puerto Rico): Dette nøgleord, der almindeligvis bruges i byområder i Puerto Rico, er en vigtig del af adresseformatet, da det beskriver placeringen af en given gade. I Puerto Rico kan gentagne gadenavne og intervaller for adressenummer findes inden for samme postnummer. Disse gader kan have de samme intervaller for husnummer. I få fald er navnet på urbaniseringen nødvendigt for at identificere placeringen af en bestemt adresse korrekt.

Eksempel: Sr Pedro Rivera Urb Hermosillo 123 Calle 1 Bayamon, PR 00961-1212.

Kommentarer

API'en til adressevalidering viser kommentarer sammen med hver adresse, der valideres og returneres. Kommentarerne giver dig oplysninger om eventuelle mangler og ændringer, der er foretaget i den indtastede adresse for at nå frem til den virkelige adresse.

Adresseklassificering

API'en til adressevalidering bruger referencedata til at bestemme klassifikationen af en given adresse. Klassifikation af en funktionel adresse beregnes uafhængigt af adressevalideringsprocessen og er baseret på feedback fra operationelt personale med kommercielle datakilder kun brugt til bekræftelse.

API'en til adressevalidering har kun fire mulige klassifikationer for adresser: ukendt, erhverv, privat og blandet. Alle adresser starter med en 'ukendt' klassifikation og forbliver sådan, indtil forretningsregler for adressevalidering bestemmer, at deres klassifikation skal ændres. En adresse får kun en 'blandet' klassifikation, hvis det er en multi-lejer-adresse, som indeholder både erhvervs- og privatenheder.

Bemærk: FedEx Express-tjenesten leverer en ekstra adresselinje (adresselinje 3) til modtageradresser. Disse yderligere adresseoplysninger giver mere fuldstændige og nøjagtige placeringsoplysninger, der forbedrer dine chancer for at finde en nøjagtig adresse.

Virkelige adresser klassificeres på følgende måde:

Erhvervsadresse

En erhvervsadresse er en adresse, der bruges til at udpege dit primære forretningssted. Det er der, hvor din virksomhed angiveligt opererer fra, men det er måske ikke altid tilfældet.

En erhvervsadresse er den officielle placering af en virksomheds lokaler. Det kan være alt fra en privat hjemmeadresse til et millionforetagende, som dem de store teknologivirksomheder foretrækker, eller alt der imellem.

Bopælsadresse

Der opkræves et bopælstillæg for forsendelser til et hjem eller privatbolig i USA, herunder adresser, hvor der drives erhverv fra hjemmet. Brug FedEx Home Delivery for levering til privatboliger via FedEx Ground inden for 1 arbejdsdag baseret på afstand til destinationen.

Eksempel:

  • Præstebolig
  • Kloster
  • Præstegård
  • Beboere i boliger med flere enheder, såsom:
    • Lejlighedskompleks
    • Ejerlejligheder
    • Kollegier
  • En bopæl, hvorfra der sælges og/eller distribueres produkter

Tips til brug af API'en til adressevalidering

Herunder vises nogle nyttige tips til brug af API'en til adressevalidering:

  • Brug korrekte mellemrum: Sørg for, at mellemrum er placeret korrekt, og undgå unødvendige mellemrum.
  • Brug korrekt stavning: Undgå stavefejl og typografiske fejl. Sørg også for, at du benytter den korrekte brug af tallet nul (0) og bogstavet O.
  • Undgå specialtegn: Undgå at bruge specialtegn, der ikke nødvendige for adressen, såsom punktum efter forkortelser.
  • Angiv yderligere adresse- og gadeoplysninger: Ved at give yderligere adresseoplysninger, kan du øge nøjagtigheden af adresseresultaterne.
    • Bygnings- eller husnummer - 1, 1A, 1½, Et
    • Gadenavn - Hovedgaden 42
    • Gadetype - Vej, gade, boulevard, osv.
  • Indtast by, delstat/provins og postnummer: Ved at giver alle tre oplysninger, øges nøjagtigheden af dine adresseresultater.
  • Indtast gade og adresse i korrekt rækkefølge: Gadeadressen skrives normalt i et format, der starter med et gadenavn efterfulgt af bygning eller husnummer, et før-retningsbestemt element, gadetype eller endelse, et efter-retningsbestemt element, lejlighedsbetegnelse, lejlighedsnummer og/eller privat postkassebetegnelse og -nummer.
  • Brug korrekte forkortelser: US Postal Service og Canada Post bruger standardforkortelser for delstat/provins, gadetype og lejlighed eller enhedsbetegnelse.
    • En ikke-standard forkortelse kan medføre dårlige søgeresultater.
    • Hvis du er i tvivl om en forkortelse, skal du ikke bruge den.
  • Urbanisering - Et urbaniseringsnavn betegner et område, en sektor eller et boligområde inden for et geografisk område.

For eksempel:

  • Bygning eller husnummer såsom 1, 1A, Et.
  • Gadenavne såsom Hovedgaden 42.
  • Gadetype såsom vej, gade, boulevard osv.
  • Indtast by, delstat/provins og postnummer: Ved at angive alle adresseoplysninger, øges nøjagtigheden af dine adresseresultater. ZIP+4-delen af postnummeret er ikke nødvendig for at kontrollere en adresse.
  • Brug korrekte forkortelser: United States Postal Service og postmyndigheder i andre lande definerer standardforkortelser for delstat/provins, gadeendelse og lejlighed/enhedsbetegnelse. En ikke-standard forkortelse kan medføre dårlige søgeresultater. Hvis du er i tvivl om en forkortelse, skal du ikke bruge den.
  • Overvej at sende feedback om adressevalidering til brugeren for at give dem mulighed for at vælge den for dem mest korrekte adresse.

Forretningsregler

  • Brug ikke denne API til at bestemme, om der kan leveres pakker til en adresse. FedEx tilbyder ikke leveringsservices til enhver gyldig adresse. FedEx leverer ikke til postbokse (med undtagelse af FedEx Ground® Economy (tidligere FedEx SmartPost®).
  • De oplysninger, der returneres ved adressekorrigering, er kun til anbefalet brug.
  • Du kan kontrollere op til 100 adresser i én anmodning.
  • Det mindste antal nødvendige felter varierer fra land til land.

    For adresser i USA kræves der f.eks. mindst en adresselinje og enten et postnummer eller en by og en statskode, men for AUS-adresser (adresseformat for Australien) kan statskoden udelades selv uden et postnummer.

  • Adresseresultaterne kan variere afhængigt af land/område.

Bemærk: API'en til adressevalidering er muligvis ikke relevant i alle lande. Se afsnittet Lande/områder, der understøtter API til adressevalidering.

JSON API Collection

CLOSE

Response

Copy