API:et Adressvalidering är en smart lösning för att åtgärda felaktiga kontaktuppgifter och möjliggöra snabbare och exakt leverans av paket. Detta API formaterar den angivna mottagarens adressuppgifter så att den så exakt som möjligt liknar en giltig adress och hämtar en faktisk adress som sannolikt är den avsedda.

API:et tillhandahåller också kommentarer om brister i den angivna adressen eller ändringar som behöver göras för att den angivna adressen ska överensstämma med den faktiska adressen. Du kan använda API:et för att validera och åtgärda mottagarens adressuppgifter innan du skickar ett paket.

Obs! Använd inte API:et för att avgöra om det går att leverera till en adress. FedEx levererar inte till alla giltiga adresser. FedEx levererar inte till postboxar (förutom via FedEx Ground® Economy (tidigare FedEx SmartPost®).

API:et kan användas för att validera och rätta mottagaradresser innan ett paket skickas. Korrekta adresser på leveransetiketten förebygger försenade leveranser och extra rättelseavgifter (på grund av felaktiga adresser).

OBS!

• Resultat för adressmatchning varierar beroende på land/område.
• Adressen som anges i begäran jämförs med referensuppgifterna i FedEx databas och den matchade adressen hämtas.

Funktioner i API:et Adressvalidering

• Matchar gatuadresser.
• Adressdatabasen uppdateras varje månad.
• Åtskiljer företagsadresser och bostadsadresser om en exakt matchning hittas.
• Kan för närvarande inte bekräfta svit- eller lägenhetsnummer.

Möjligheter i API:et Adressvalidering

• Fyller i ofullständiga mottagaradresser. I vissa fall kan API:et Adressvalidering lägga till saknad information beroende på hur de angivna uppgifterna kan verifieras mot referensuppgifterna. API:et Adressvalidering kan för tillfället inte lägga till saknad extrainformation (som lägenhet eller svit).
• Adressdatabasen uppdateras varje månad.
• Rättar ogiltiga mottagaradresser. Till exempel kan ett felaktigt postnummer rättas så att det överensstämmer med de övriga uppgifterna.
• Avgör om en adress är en företagsadress eller en bostadsadress för att bättre kunna fastställa anpassade priser. Gäller endast adresser i USA och Kanada.
• Bekräftar att adresser är giltiga och kompletta i många länder i följande regioner: USA, Kanada, Latinamerika, Europa, Mellanöstern och Asien och Stillahavsområdet. Nu kan du validera inrikes och utrikes adressuppgifter innan paket skickas, vilket förebygger onödiga förseningar och extra serviceavgifter.
• Matchar gatuadresser.
• Upp till 100 adresser kan kontrolleras med en API-begäran.

Länder/territorier som stöder API:et Adressvalidering

Du kan använda FedEx API för adressvalidering i följande länder för att validera och rätta mottagaradresser för effektivare leveranser.

Obs: Uppgifterna som hämtas av adressvalideringsbegäran är endast avsedd som en rekommendation.

Ansvarsfriskrivning: Uppgifterna som anges häri är FedEx upphovsrättsskyddade och konfidentiella information och tillhandahålls på din begäran. Ingen del av dessa uppgifter får distribueras eller lämnas ut i någon form till tredje part utan FedEx skriftliga tillåtelse. Den återspeglar FedEx befintliga databas över företagsadresser och bostadsadresser och kan komma att ändras. Som en del av att FedEx tillhandahåller dessa uppgifter ger FedEx inga garantier om dess befintliga eller framtida riktighet, och garanterar inte att paket som skickas till sådana adresser kommer att faktureras enligt företags-/bostadsklassificeringarna häri. Att tillhandahålla dessa uppgifter anses inte ändra villkoren för förhållandet mellan parterna. Se FedEx serviceinformation och alla tillämpliga kundprisavtal för villkoren och bestämmelserna för FedEx frakt och avgifter.

Validera adress

Använd den här slutpunkten för att validera och fastställa angivna adresser och hämta faktiska adresser. Adressuppgifterna tillhandahålls och valideras för att fastställa adresser. Adresser anses ha fastställts om den angivna adressen matchar de kända referensuppgifterna.

De nödvändiga uppgifterna associerade med denna begäran är:

• Adressrader
• Stad (valfritt)
• Delstat- eller provinskod (valfritt)
• Postnummer (valfritt)
• Landskod

Obs: Delstatskoden eller ortsnamnet räcker om kunden skickar till ett land som inte har ett postnummer.

API:et Adressvalidering hämtar en faktisk adress genom att utföra följande åtgärder med den angivna adressen:

• I det första steget försöker API normalisera den angivna adressen. Detta kan inkludera att ersätta vanliga vägidentifierare som gata med sina gängse förkortningar som G, samt ändra ordningen på adressens olika delar. Om en angiven adress inte kan normaliseras kommer de fastställda adresserna som hämtas att vara den angivna adressen. Andra värden än adressvärden ignoreras.
• I det andra steget försöker API:et standardisera den normaliserade adressen genom att hitta en möjlig eller faktisk adress som sannolikt är den som användaren avsåg. Om standardiseringen misslyckas kommer de fastställda adresserna som hämtas att vara den normaliserade formen av den angivna adressen. Se delarna som hämtas för att avgöra problemen med den angivna adressen.
• Vissa delar av den normaliserade adressen kan också hämtas. Om standardiseringen lyckas kommer de fastställda adresserna som hämtas att vara faktiska adresser. I sådana fall kommer de olika delarna av den standardiserade adressen och information om hur den härletts från den normaliserade adressen också att hämtas.

Returvärden från API:et Adressvalidering

Om den hämtade adressen innehåller följande värden för de nedanstående egenskaperna är adressen giltig:

• Adresstillståndet är standardiserat
• Attribut för fastställda adresser är True
• Delivery Point Valid (DPV) är True
• Interpolerad adress är False

Om dessa inte listas använder du de extra attributen för att fastställa de möjliga problemen med adressvärdet.

För mer information om adressattribut, se Adressattribut.

Om kundmeddelandet som hämtas är INTERPOLATED.STREET.ADDRESS är det möjligt att adressen inte är giltig. För mer information om kundmeddelandekoden, se elementbeskrivningen av kundmeddelandet.

Urbanisering (endast Puerto Rico): Denna beskrivning är vanligt förekommande i stadsområden i Puerto Rico och är en viktig del av adressformatet som beskriver var en given gata ligger. I Puerto Rico kan samma gatunamn och adressnummer förekomma inom samma postnummer. Dessa gator kan ha samma husnummer. I sådana fall används urbaniseringsnamnet för att korrekt identifiera var en given adress ligger.

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

Kommentarer

API:et adressvalidering hämtar kommentarer för varje adress som valideras och hämtas. Kommentarerna innehåller information om fel i de angivna adresserna och vilka ändringar som har gjorts för att uppnå de faktiska adresserna.

API:et adressvalidering använder referensuppgifter för att klassificera de angivna adresserna. Klassificeringen av faktiska adresser beräknas fristående från adressvalideringen och är baserad på feedback från personalen och kommersiella datakällor används endast för att bekräfta adresser.<br>
API:et adressvalidering har bara fyra möjliga adressklasser: okänd, företag, bostad och blandad. Alla adresser börjar med en ”okänd” klassificering och förblir så till adressvalideringsreglerna avgör att klasserna ska ändras. En adress klassificeras endast som blandad om den har flera hyresgäster och har både företagsenheter och bostadsenheter.

Obs: FedEx Express har en extra adressrad (adressrad 3) för mottagaradresser. Dessa extra adressuppgifter ger mer kompletta och exakta platsuppgifter vilket ökar chansen att rätt adress hittas.

Faktiska adresser klassificeras på följande sätt:

Företagsadresser

En företagsadress är adressen som utgör sätet för ditt företag. Det är adressen där ditt företag sägs bedriva sin verksamhet, även om så inte alltid är fallet.

En företagsadress är företagets officiella lokaler. Den kan vara allt från en bostadsadress till ett företagscampus av det slag som stora teknikföretag ofta använder, och allt där emellan.

Bostadsadress

Bostadsleveransavgifter tillämpas på försändelser inom USA till hem och privatbostäder, inklusive adresser där ett företag drivs från en hemadress. Använd FedEx Home Delivery för leverans till bostadsadresser via FedEx Ground inom en arbetsdag, baserat på avståndet till destinationen.

Exempel:

• Pastorat
• Kloster
• Prästgård
• Personer i flerbostadshus som:
  • Lägenhetsbyggnader
  • Bostadsrätter
  • Studentlägenheter

• Bostäder där produkter säljs och/eller distribueras

Här är några praktiska tips för att använda API:et Adressvalidering:

• Använd rätt mellanslag: se till att alla mellanslag är korrekt placerade och undvik onödiga mellanslag.
• Använd rätt stavning: undvik stavningsfel och typografiska fel. Se också till att använda siffran noll (0) och bokstaven O på rätt ställe.
• Undvik specialtecken: avstå från att använda specialtecken som inte krävs för adressen som punkter efter förkortningar (Ave istället för Ave.).
• Ange alla adressuppgifter: genom att ange alla delar av adressen får du mer exakta sökresultat.
  • Byggnads- eller husnummer – 1, 1A, 1½, Ett
  • Gatunamn – Main, George Washington, 42^nd
  • Gatans suffix – Road, Avenue, Rd, Ave
• Ange ort, delstat/provins och postnummer: om du anger alla tre uppgifterna får du mer exakta sökresultat.
• Ange gatan och adressen i rätt ordning: Gatuadressen använder som regel formatet där byggnads- eller husnumret följs av ett gatunamn, en gatutyp eller ett suffix och sedan ett lägenhetsnamn, lägenhetsnummer och/eller namnet eller numret på en privat postlåda.
• Använd rätt förkortningar: Den amerikanska posten och den kanadensiska posten använder standardiserade förkortningar för delstat/provins, gatusuffix och lägenhets- eller enhetsbeteckningar.
  • Om du använder icke-standardiserade förkortningar kan det påverka sökresultaten.
  • Om du är osäker på en förkortning bör du inte använda den.
• Urbanisering – Ett urbaniseringsnamn avser ett område, en sektor eller ett bostadsområde inom ett geografiskt område.

Till exempel:

• Byggnads- eller husnummer som 1, 1A, Ett
• Gatunamn som Main, George Washington, 42nd.
• Gatusuffix som Road, Avenue, Rd, Ave.
• Ange ort, delstat/provins och postnummer: om du anger alla tre uppgifterna får du mer exakta sökresultat. De fyra sista siffrorna i postnumret är inte nödvändigt för att kontrollera en adress.
• Använd rätt förkortningar: Den amerikanska posten, den kanadensiska posten och postverk i andra länder använder standardiserade förkortningar för delstat/provins, gatusuffix och lägenhets- eller enhetsbeteckningar. Om du använder icke-standardiserade förkortningar kan det påverka sökresultaten. Om du är osäker på en förkortning bör du inte använda den.
• Överväg att skicka svaret på adressvalideringen till användaren för att ge dem möjligheten att välja adressen som passar bäst för dem.

• Använd inte API:et för att avgöra om ett paket kan levereras till en adress. FedEx levererar inte till alla giltiga adresser. FedEx levererar inte till postboxar (förutom via FedEx Ground® Economy (tidigare FedEx SmartPost^®).
• Uppgifterna som hämtas för den fastställda adressen är endast avsedda som rekommendationer.
• Upp till 100 adresser kan kontrolleras med en API-begäran.
• De obligatoriska fälten kan variera mellan olika länder.

  För till exempel amerikanska adresser krävs minst en adressrad och antingen ett postnummer eller en ort och en delstatskod, men för adresser som använder det australienska formatet kan delstatskoden lämnas ute även utan postnummer.

• Resultat för adressmatchning kan variera beroende på land/område.

Obs: API:et Adressvalidering kan inte användas i alla länder. Se avsnitt Länder/territorier som stöder API:et Adressvalidering.