Fedex Logo

บทนำ

API สำหรับการตรวจสอบที่อยู่เป็นโซลูชันที่แก้ไขปัญหารายละเอียดการติดต่อไม่ถูกต้องได้อย่างชาญฉลาด และยังช่วยให้จัดส่งพัสดุได้รวดเร็วกว่าเดิมและแม่นยำ API นี้กำหนดรูปแบบการป้อนข้อมูลที่อยู่ผู้รับที่เหมาะสมโดยมีความใกล้เคียงกับที่อยู่ที่ถูกต้อง ทั้งยังแสดงที่อยู่ตามตำแหน่งจริงที่ค่อนข้างตรงกับที่อยู่ที่ต้องการ

API นี้แสดงข้อมูลประกอบที่บ่งชี้ข้อบกพร่องของที่อยู่ที่ป้อนหรือการแก้ไขข้อมูลที่อยู่สำหรับจัดส่งตามตำแหน่งจริงนั้นๆ คุณยังสามารถใช้ API นี้ตรวจสอบความถูกต้องและแก้ไขข้อมูลที่อยู่ผู้รับก่อนจัดส่งพัสดุได้อีกด้วย

หมายเหตุ: ห้ามใช้ API นี้เพื่อพิจารณาความพร้อมในการจัดส่งของที่อยู่ FedEx ไม่มีบริการจัดส่งไปยังที่อยู่ที่ถูกต้องได้ครบทุกแห่ง FedEx ไม่มีบริการจัดส่งไปยังตู้ไปรษณีย์ ยกเว้นการจัดส่งผ่าน FedEx Ground® Economy (เดิมเรียกว่า FedEx SmartPost®)

รายละเอียด API สำหรับการตรวจสอบที่อยู่

API นี้สามารถช่วยตรวจสอบและแก้ไขข้อมูลที่อยู่ผู้รับก่อนการจัดส่งได้ ที่อยู่ที่ถูกต้องที่ฉลากการส่งจะช่วยกำจัดความล่าช้าในการส่งและค่าแก้ไขที่อยู่เพิ่มเติม (จากการใส่ที่อยู่ไม่ถูกต้อง)

หมายเหตุ:

  • ผลลัพธ์การแก้ปัญหาของที่อยู่จะแตกต่างกันไปในแต่ละประเทศ/เขตปกครอง
  • ที่อยู่ที่กรอกในคำขอจะนำไปเปรียบกับข้อมูลอ้างอิงที่ฐานข้อมูลของ FedEx และจะส่งคืนที่อยู่ที่ตรงกันกลับไป

หน้าที่การทำงานของ API สำหรับการตรวจสอบที่อยู่

  • ให้ข้อมูลที่ตรงกันสำหรับที่อยู่ในระดับถนน
  • ได้รับข้อมูลล่าสุดรายเดือนสำหรับฐานข้อมูลที่อยู่
  • แยกแยะความแตกต่างระหว่างที่อยู่ประเภทธุรกิจและประเภทบ้านพักอาศัยหากพบข้อมูลที่ตรงกัน
  • ในขณะนี้ยังไม่ตรวจสอบหมายเลขห้องชุดหรืออพาร์ตเมนต์

ความสามารถของ API สำหรับการตรวจสอบที่อยู่

  • กรอกที่อยู่ที่ไม่ครบถ้วนให้ครบถ้วน ในบางกรณี API การตรวจสอบที่อยู่จะสามารถเติมข้อมูลที่หายไปได้โดยขึ้นอยู่กับการตรวจสอบข้อมูลที่ให้ไว้กับข้อมูลอ้างอิง API การตรวจสอบที่อยู่ไม่สามารถเพิ่มข้อมูลระดับรอง (เช่น อพาร์ตเมนต์หรือห้องชุด) ได้ในขณะนี้
  • ได้รับข้อมูลล่าสุดรายเดือนสำหรับฐานข้อมูลที่อยู่
  • แก้ไขที่อยู่ผู้รับที่ไม่ถูกต้อง เช่น แก้ไขรหัสไปรษณีย์ที่ไม่ถูกต้องเพื่อให้ตรงกับข้อมูลอื่น ๆ ที่ให้ไว้
  • ตัดสินว่าที่อยู่เป็นที่อยู่ธุรกิจหรือที่อยู่อาศัยเพื่อเพิ่มความแม่นยำของข้อเสนออัตราพิเศษ ใช้ได้กับที่อยู่ในสหรัฐฯและแคนาดาเท่านั้น
  • ยืนยันความถูกต้องและความสมบูรณ์ของที่อยู่ในหลายประเทศในพื้นที่ต่อไปนี้: สหรัฐฯ แคนาดา ละตินอเมริกา ยุโรป ตะวันออกกลาง และเอเชียแปซิฟิก คุณสามารถตรวจสอบข้อมูลที่อยู่ทั้งในประเทศและนอกประเทศก่อนจะส่งพัสดุได้ หลีกเลี่ยงความล่าช้าในการส่งและค่าใช้จ่ายสำหรับบริการเพิ่มเติมอื่น ๆ
  • ให้การตรวจสอบในระดับถนน
  • สามารถตรวจสอบได้สูงสุด 100 ที่อยู่ต่อหนึ่งคำของ API

ประเทศ/ตำแหน่งที่รองรับ API การตรวจสอบที่อยู่

คุณสามารถใช้ API การตรวจสอบที่ของ FedEx ได้ในประเทศต่อไปนี้เพื่อตรวจสอบและแก้ไขที่อยู่ของผู้รับเพื่อการส่งที่มีประสิทธิภาพ

แอนทิลลีส เดนมาร์ก ปานามา
อาร์เจนตินา สาธารณรัฐโดมินิกัน เปรู
อารูบา เอสโตเนีย โปรตุเกส
ออสเตรเลีย ฟินแลนด์ สิงคโปร์
ออสเตรีย ฝรั่งเศส แอฟริกาใต้
บาฮามาส เยอรมนี สเปน
บาร์เบโดส กรีซ สวีเดน
เบลเยียม กัวเตมาลา สวิตเซอร์แลนด์
เบอร์มิวดา เขตบริหารพิเศษฮ่องกง, จีน ตรินิแดดและโตเบโก
บราซิล อิตาลี สหราชอาณาจักร
แคนาดา จาไมกา สหรัฐอเมริกา
หมู่เกาะเคย์แมน มาเลเซีย อุรุกวัย
ชิลี เม็กซิโก เวเนซุเอลา
โคลัมเบีย เนเธอร์แลนด์ Virgin Islands
คอสตาริกา นิวซีแลนด์  
สาธารณรัฐเช็ก นอร์เวย์  

 

หมายเหตุ: ข้อมูลที่ส่งกลับโดยคำขอการตรวจสอบที่อยู่เป็นข้อมูลที่ใช้สำหรับการแนะนำเท่านั้น

หมายเหตุด้านกฎหมาย: ข้อมูลที่ให้ไว้ที่นี่เป็นกรรมสิทธิ์ของ FedEx และเป็นข้อมูลที่เป็นความลับที่ให้ไว้โดยเป็นการอนุญาตจากคำขอของคุณ ไม่มีส่วนใดของข้อมูลนี้สามารถนำไปแจกจ่ายหรือเปิดเผยในรูปแบบใด ๆ กับบุคลลที่สามโดยไม่มีการอนุญาติเป็นลายลักษณ์อักษรของ FedEx สิ่งนี้จะสะท้อนการจัดประเภทระดับที่อยู่ของธุรกิจ/ที่อยู่อาศัยของ FedEx ในฐานข้อมูลการส่งของ FedEx และยังสามารถเปลี่ยนแปลงได้ ในการจัดการกับข้อมูลเหล่านี้ FedEx ไม่สามารถการันตีความแม่นยำในปัจจุบันและในอนาคตได้ และไม่การันตีว่าพัสดุที่ส่งไปที่อยู่เหล่านี้จะส่งใบเรียกเก็บเงินตรงกับประเภทธุรกิจ/ที่อยู่อาศัยที่ให้ไว้ที่นี่ การให้ข้อมูลนี้ไม่ควรจะถือว่าเป็นสิ่งที่เปลี่ยนแปลงข้อกำหนดระหว่างแต่ละฝ่ายได้ ดูที่ คู่มือบริการ ของ FedEx หรือข้อตกลงด้านราคาบัญชีที่เกี่ยวข้องอื่นๆ สำหรับข้อกำหนดและเงื่อนไขที่กำหนดการส่งและการเรียกเก็บเงินของ FedEx

API สำหรับการตรวจสอบที่อยู่ทำงานอย่างไร

ตรวจสอบที่อยู่

ใช้ปลายทางนี้เพื่อยืนยันและแก้ไขที่อยู่ที่กรอกไว้และให้ที่อยู่ที่มีจริงกลับคืน รายละเอียดของที่อยู่จะต้องให้และตรวจสอบเพื่อแก้ปัญหาของที่อยู่ ที่อยู่จะแสดงว่าแก้ไขแล้วเมื่อที่อยู่ที่กรอกตรงกับข้อมูลอ้างอิงที่มี

ข้อมูลที่เกี่ยวข้องกับคำขอนี้ได้แก่:

  • ถนน
  • เมือง (ถ้ามี)
  • รหัสรัฐหรือจังหวัด (ถ้ามี)
  • รหัสไปรษณีย์ (ถ้ามี)
  • รหัสประเทศ

หมายเหตุ: รหัสรัฐและชื่อเมืองก็เพียงพอแล้วเมื่อลูกค้าจะส่งไปที่ประเทศที่ไม่มีรหัสไปรษณีย์

API การตรวจสอบที่อยู่จะให้ที่อยู่จริงกลับไปโดยทำปฏิบัติการต่อไปนี้กับที่อยู่ที่ให้ไว้:

  • ในขั้นตอนแรก API จะพยายามทำให้ที่อยู่ที่ให้ไว้เป็นปกติ ขั้นตอนนี้อาจจะประกอบด้วยการแทนที่สิ่งที่ระบุทางถนนทั่วไปอย่างเช่น Street หรือ Parkway ด้วยการย่อตามมาตรฐานเช่น ST และ PKWY รวมถึงการเรียงลำดับองค์ประกอบต่าง ๆ ของที่อยู่ใหม่ ถ้าที่อยู่ที่ให้ไว้ไม่สามารถทำให้เป็นปกติได้ ที่อยู่ที่แก้ปัญหาแล้วจะเป็นที่อยู่ที่ให้ไว้ จะนำค่าต่าง ๆ ที่ไม่ใช่ที่อยู่ออกไป
  • ในขั้นตอนที่สอง API จะพยายามทำข้อมูลที่เป็นปกติให้เป็นมาตรฐานโดยการหาที่อยู่ที่เป็นไปได้หรือที่อยู่จริงที่น่าจะเป็นที่อยู่ที่ผู้ใช้ต้องการ ถ้ากระบวนการการทำให้เป็นมาตรฐานล้มเหลว ที่อยู่ที่แก้ปัญหาแล้วจะเป็นที่อยู่ในรูปแบบปกติของที่อยู่ที่ให้ไว้ อ้างอิงจากองค์ประกอบที่ให้กลับไปเพื่อช่วยมองหาปัญหาที่มีในที่อยู่ที่ให้ไว้
  • องค์ประกอบบางอย่างของที่อยู่แบบปกติก็จะคืนกลับมาด้วย ถ้าการทำให้เป็นมาตรฐานสำเร็จ ที่อยู่ที่แก้ปัญหาที่ให้กลับไปจะเป็นที่อยู่จริง ในกรณีนี้ องค์ประกอบเพิ่มเติมหลาย ๆ อย่างของที่อยู่ที่เป็นมาตรฐานแล้วและข้อมูลที่ได้จากที่อยู่ที่เป็นปกติก็จะคืนมาด้วย

ค่าการแสดงผลของ API สำหรับการตรวจสอบที่อยู่

หากที่อยู่ที่แสดงประกอบด้วยค่าต่อไปนี้สำหรับคุณลักษณะด้านล่าง ที่อยู่จะเป็นที่อยู่ที่ถูกต้อง:

  • รัฐตามที่อยู่เป็นมาตรฐาน
  • คุณลักษณะของที่อยู่ที่ถูกแก้ไขเป็นจริง
  • จุดจัดส่ง (DPV) ถูกต้อง
  • ที่อยู่ที่แทรกเป็นเท็จ

ากไม่มีคุณลักษณะเหล่านี้ ให้ใช้คุณลักษณะเพิ่มเติมในการค้นหาปัญหาของค่าที่อยู่ที่เป็นไปได้

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคุณลักษณะของที่อยู่ ดูที่ คุณลักษณะของที่อยู่

หากข้อมูลที่แสดงรหัสข้อความลูกค้า คือ INTERPOLATED.STREET.ADDRESS ก็จะมีโอกาสที่ที่อยู่ไม่ถูกต้อง สำหรับข้อมูลเพิ่มเติมเกี่ยวกับรหัสข้อความลูกค้า ดูที่คำอธิบายองค์ประกอบของข้อความลูกค้า

คำอธิบายประกอบ

API สำหรับการตรวจสอบที่อยู่แสดงคำอธิบายประกอบพร้อมทุกที่อยู่ที่ตรวจสอบและแสดงแล้ว คำอธิบายประกอบให้ข้อมูลแก่คุณเกี่ยวกับข้อบกพร่องเมื่อเกิดขึ้นและการเปลี่ยนแปลงที่ทำกับที่อยู่ที่ป้อนเพื่อไปให้ถึงที่อยู่ตามตำแหน่งจริงนั้น

การจำแนกที่อยู่

API สำหรับการตรวจสอบที่อยู่ใช้ข้อมูลอ้างอิงเพื่อระบุประเภทของที่อยู่ที่ให้ไว้ การจัดประเภทของที่อยู่ที่ใช้ได้จะคำนวนแยกกันโดยใช้กระบวนการยืนยันที่อยู่และใช้ความคิดเห็นเจ้าหน้าที่ปฏิบัติการเป็นสิ่งอ้างอิง โดยใช้แหล่งข้อมูลเชิงพาณิชย์เพื่อการยืนยันเท่านั้น.

API การยืนยันที่อยู่มีการจัดประเภทที่เป็นไปได้สี่ประเภทสำหรับที่อยู่เท่านั้น: ไม่ทราบ ธุรกิจ ที่อยู่อาศัย และแบบผสม ทุกที่อยู่จะเริ่มจากประเภท 'ไม่ทราบ' และจะเป็นเช่นนั้นไปจนกว่ากฎการตรวจสอบที่อยู่ทางธุรกิจระบุว่าควรจะเปลี่ยนประเภทของที่อยู่นั้น ที่อยู่จะได้รับประเภท 'แบบผสม' ก็ต่อเมื่อเป็นที่อยู่ที่มีผู้เช่าหลายคนและมีทั้งยูนิตที่เป็นธุรกิจและที่อยู่อาศัยเท่านั้น

หมายเหตุ: บริการ FedEx Express ให้บรรทัดที่อยู่เพิ่มเติม (บรรทัดที่อยู่ 3) สำหรับที่อยู่ของผู้รับ ข้อมูลที่อยู่เพิ่มเติมนี้จะให้ข้อมูลที่อยู่สมบูรณ์และเที่ยงตรงมากว่า เพิ่มโอกาสที่จะได้ที่อยู่ที่ถูกต้องมากขึ้น

ที่อยู่ที่มีจริงจะแบ่งเป็นประเภทดังนี้:

ที่อยู่ทางธุรกิจ

ที่อยู่ทางธุรกิจคือที่อยู่ที่ใช้เพื่อระบุสถานที่ตั้งหลักของธุรกิจ เป็นตำแหน่งที่ธุรกิจของคุณควรเปิดทำการ แต่อาจจะไม่ได้เป็นเช่นนั้นเสมอไป

ที่อยู่ทางธุรกิจคือที่ตั้งอย่างเป็นทางการของบริเวณสถานที่บริษัท าจเป็นแบบใดก็ได้ตั้งแต่บ้านที่อยู่ของใครสักคนไปจนถึงวิทยาเขตราคาหลายล้านดอลลาร์ เช่น กลุ่มสถานที่ที่บริษัทเทคโนโลยีขนาดใหญ่นิยมกันและสถานที่อื่นที่คล้ายกัน

ที่อยู่ของที่พักอาศัย

ค่าธรรมเนียมในการจัดส่งไปยังที่พักอาศัยจะบังคับใช้กับการจัดส่งภายในสหรัฐอเมริกาไปยังบ้านหรือบ้านพักอาศัยส่วนตัว รวมถึงตำแหน่งที่ธุรกิจเปิดทำการจากบ้าน ใช้ FedEx Home Delivery สำหรับการจัดส่งไปยังที่พักอาศัยผ่าน FedEx Ground ใน 1 วันทำการ โดยขึ้นอยู่กับระยะทางถึงปลายทาง

ตัวอย่าง:

  • บ้านพักนักบวช
  • สำนักแม่ชี
  • กุฏิพระ
  • ผู้อยู่อาศัยในที่อยู่อาศัยหลายยูนิต เช่น:
    • อาคารอพาร์ทเมนต์
    • คอนโดมิเนียม
    • หอพักของวิทยาลัย
  • ที่พักอาศัยที่มีการขายและ/หรือแจกจ่ายผลิตภัณฑ์

คำแนะนำในการใช้ API สำหรับการตรวจสอบที่อยู่

ต่อไปนี้คือเคล็ดลับที่มีประโยชน์สำหรับการใช้ API การตรวจสอบที่อยู่

  • ใช้การเว้นวรรคอย่างถูกต้อง: ดูให้แน่ใจว่าใส่เว้นวรรคได้อย่างถูกต้องและหลีกเลี่ยงการเว้นวรรคที่ไม่จำเป็น
  • ใช้การสะกดที่ถูกต้อง: หลีกเลี่ยงความผิดพลาดจากการสะกดหรือการพิมพ์ และตรวจสอบให้แน่ใจว่าคุณใช้หมายเลขศูนย์ (0) และตัวอักษร O อย่างถูกต้อง
  • หลีกเลี่ยงอักขระพิเศษ: โปรดงดเว้นการใช้ตัวอักขระพิเศษที่ไม่จำเป็นต้องใช้สำหรับที่อยู่ เช่น จุดหลังตัวย่อ (Ave กับ Ave.)
  • ให้ข้อมูลที่อยู่และถนนเพิ่มเติม: การให้ข้อมูลที่อยู่เพิ่มเติมจะสามารถเพิ่มความแม่นยำของผลลัพธ์ที่อยู่ได้
    • หมายเลขอาคารหรือบ้าน - 1, 1A, 1½, หนึ่ง
    • ชื่อถนน - Main, George Washington, เลขที่ 42
    • คำต่อท้ายถนน - ถนน, Avenue, ถ., Ave
  • ป้อนเมือง รัฐ/จังหวัด และรหัสไปรษณีย์: การให้ข้อมูลครบทั้งสามส่วนจะเพิ่มความแม่นยำผลลัพธ์การค้นหาที่อยู่ของคุณ
  • ป้อนชื่อถนนและที่อยู่ตามลำดับ: องค์ประกอบของเลขที่อยู่มักจะเป็นไปตามรูปแบบที่เริ่มต้นด้วยหมายเลขอาคารหรือบ้าน แล้วตามด้วยองค์ประกอบที่มีทิศทางส่วนหน้า ชื่อถนน ประเภทถนนหรือคำต่อท้าย องค์ประกอบที่มีทิศทางส่วนหลัง ชื่ออพาร์ตเมนต์ หมายเลขอพาร์ตเมนต์ และ/หรือชื่อและหมายเลขกล่องจดหมายส่วนตัว
  • ใช้ตัวย่อที่ถูกต้อง: บริการไปรษณีย์ของสหรัฐฯ และไปรษณีย์ของแคนาดามีตัวย่อที่เป็นมาตรฐานสำหรับรัฐ/จังหวัด คำต่อท้ายถนน และการตั้งชื่ออพาร์ตเมนต์หรือหน่วยงาน
    • อักษรย่อที่ไม่มีมาตรฐานอาจจะทำให้ได้ผลลัพธ์การค้นหาไม่ดี
    • ถ้าคุณไม่แน่ใจเกี่ยวกับตัวย่อ ก็อย่านำมาใช้

ตัวอย่างเช่น

  • หมายเลขอาคารหรือบ้าน - 1, 1A, หนึ่ง
  • ชื่อถนน - Main, George Washington, เลขที่ 42
  • คำต่อท้ายถนน - ถนน, Avenue, ถ., Ave
  • ป้อนเมือง รัฐ/จังหวัด และรหัสไปรษณีย์: การให้ข้อมูลครบทั้งสามส่วนจะเพิ่มความแม่นยำของผลลัพธ์ของคุณ ไม่จำเป็นต้องใช้ส่วน ZIP+4 ของรหัสไปรษณีย์สำหรับการตรวจสอบที่อยู่
  • ใช้ตัวย่อที่ถูกต้อง: บริการไปรษณีย์ของสหรัฐฯ และไปรษณีย์ของแคนาดามีตัวย่อที่เป็นมาตรฐานสำหรับรัฐ/จังหวัด คำต่อท้ายถนน และการตั้งชื่ออพาร์ตเมนต์หรือหน่วยงาน อักษรย่อที่ไม่มีมาตรฐานอาจจะทำให้ได้ผลลัพธ์การค้นหาไม่ดี ถ้าคุณไม่แน่ใจเกี่ยวกับตัวย่อ ก็อย่านำมาใช้
  • พิจารณาถึงการให้ข้อคิดเห็นของการตรวจสอบที่อยู่กับผู้ใช้เพื่อให้พวกเขามีตัวเลือกให้เลือกที่อยู่ที่ถูกต้องที่สุดสำหรับพวกเขา

กฎการดำเนินธุรกิจ

  • หมายเหตุ: ห้ามใช้ API นี้เพื่อพิจารณาความพร้อมของการจัดส่งพัสดุของที่อยู่ FedEx ไม่มีบริการจัดส่งไปยังที่อยู่ที่ถูกต้องได้ครบทุกแห่ง FedEx ไม่มีบริการจัดส่งไปยังตู้ไปรษณีย์ฝากเช่า (ยกเว้นการจัดส่งผ่าน FedEx Ground® Economy (เดิมเรียกว่า FedEx SmartPost®)
  • ข้อมูลที่ส่งกลับโดยที่อยู่ที่แก้ปัญหาแล้วเป็นข้อมูลสำหรับการแนะนำเท่านั้น
  • สามารถตรวจสอบได้สูงสุด 100 ที่อยู่ต่อหนึ่งคำขอ
  • พื้นที่ขั้นต่ำแตกต่างกันไปในแต่ละประเทศ

    ตัวอย่าง สำหรับที่อยู่ของสหรัฐฯ จำเป็นต้องมีอย่างน้อยหนึ่งบรรทัดที่อยู่และมีรหัสไปรษณีย์หรือเมืองและรหัสรัฐ แต่สำหรับที่อยู่ของ AUS (รูปแบบที่อยู่ของออสเตรเลีย) อาจจะเว้นรหัสรัฐไว้ได้โดยไม่ต้องมีรหัสไปรษณีย์

  • ผลลัพธ์การแก้ปัญหาของที่อยู่จะแตกต่างกันไปในแต่ละประเทศ/เขตปกครอง

หมายเหตุ: API การยืนยันที่อาจจะไม่สามารถใช้ได้ในทุกประเทศ โปรดดูที่ ประเทศ/ตำแหน่งที่รองรับ API การตรวจสอบที่อยู่

คอลเล็กชัน JSON API

CLOSE

Response

Copy