API Xác thực địa chỉ là giải pháp thông minh để giải quyết các thông tin liên hệ không chính xác và cho phép vận chuyển các gói hàng nhanh hơn mà vẫn đảm bảo độ chính xác. API này sửa đổi một cách thích hợp định dạng thông tin nhập vào về địa chỉ người nhận gần giống địa chỉ hợp lệ và trả về địa chỉ thực có khả năng là địa chỉ vốn định nhập.

API này cũng chú thích về nội dung thiếu sót trong địa chỉ nhập vào hoặc những thay đổi được thực hiện đối với thông tin đã nhập để có được địa chỉ thực đó. Bạn có thể sử dụng API này để xác thực và giải quyết thông tin địa chỉ người nhận trước khi vận chuyển gói hàng.

Lưu ý: Không dùng API này để xác định khả năng giao hàng đến một địa chỉ. Không phải địa chỉ hợp lệ nào FedEx cũng cung cấp dịch vụ giao hàng. FedEx không giao hàng tới các hộp thư bưu điện, ngoại trừ trường hợp giao hàng qua FedEx Ground® Economy (Trước đây là FedEx SmartPost®).

API này cho phép xác thực và chỉnh sửa thông tin địa chỉ người nhận trước khi gửi gói hàng. Địa chỉ chính xác trên nhãn gửi hàng sẽ giúp tránh giao hàng chậm trễ và tránh mất thêm phí chỉnh sửa địa chỉ (do địa chỉ sai).

Lưu ý:

• Kết quả giải quyết địa chỉ khác nhau tùy theo quốc gia/vùng lãnh thổ.
• Địa chỉ nhập trong yêu cầu được so sánh với dữ liệu tham chiếu trong cơ sở dữ liệu FedEx và địa chỉ khớp sẽ được trả về.

Các chức năng của API Xác thực địa chỉ

• Cung cấp kết quả địa chỉ khớp đến cấp độ đường phố.
• Nhận thông tin cập nhật mỗi tháng về cơ sở dữ liệu địa chỉ.
• Phân biệt giữa địa chỉ doanh nghiệp và địa chỉ nơi cư trú nếu tìm thấy kết quả khớp chính xác.
• Hiện không xác minh số buồng hay số căn hộ.

Những khả năng của API Xác thực địa chỉ

• Hoàn thành địa chỉ người nhận chưa đầy đủ. Trong một số trường hợp, API Xác thực địa chỉ có thể thêm thông tin bị thiếu, tùy thuộc vào việc xác minh thông tin được cung cấp dựa trên dữ liệu tham chiếu. Hiện nay, API Xác thực địa chỉ không thể thêm thông tin phụ bị thiếu (ví dụ: căn hộ hoặc buồng).
• Nhận thông tin cập nhật mỗi tháng về cơ sở dữ liệu địa chỉ.
• Chỉnh sửa địa chỉ người nhận không đúng. Ví dụ: chỉnh sửa mã bưu chính không chính xác để thống nhất với phần còn lại của dữ liệu đầu vào.
• Xác định một địa chỉ là địa chỉ doanh nghiệp hay địa chỉ nơi cư trú để tăng độ chính xác của báo giá giá cước ưu đãi. Chỉ áp dụng với địa chỉ tại Hoa Kỳ và Canada.
• Xác nhận tính hợp lệ và đầy đủ của địa chỉ ở nhiều quốc gia trong các khu vực sau: Hoa Kỳ, Canada, Mỹ Latinh, châu Âu, Trung Đông và châu Á Thái Bình Dương. Giờ đây, bạn có thể xác thực thông tin địa chỉ trong nước và quốc tế trước khi gửi gói hàng để tránh giao hàng chậm trễ và tránh mất thêm phí dịch vụ.
• Cung cấp kết quả khớp đến cấp độ đường phố.
• API này có thể kiểm tra tối đa 100 địa chỉ trong một yêu cầu.

Các quốc gia/vùng lãnh thổ hỗ trợ API Xác thực địa chỉ

Bạn có thể sử dụng API Xác thực địa chỉ của FedEx ở các quốc gia sau để xác thực và chỉnh sửa địa chỉ người nhận nhằm giao hàng hiệu quả.

Lưu ý: Thông tin được Yêu cầu xác thực địa chỉ trả về chỉ mang tính đề xuất.

Tuyên bố miễn trừ trách nhiệm pháp lý: Dữ liệu được cung cấp ở đây là thông tin độc quyền và bí mật của FedEx, được cung cấp miễn phí theo yêu cầu của bạn. Không phần nào của dữ liệu này có thể được phân phối hoặc tiết lộ dưới bất kỳ hình thức nào cho bất kỳ bên thứ ba nào mà không có sự cho phép bằng văn bản của FedEx. Dữ liệu này phản ánh cách phân loại địa chỉ doanh nghiệp/nơi cư trú hiện tại trong cơ sở dữ liệu địa chỉ giao hàng của FedEx và có thể thay đổi. Khi cung cấp thông tin này, FedEx không đảm bảo tính chính xác ở hiện tại hoặc trong tương lai và không đảm bảo rằng các gói hàng gửi đến các địa chỉ này sẽ được lập hóa đơn theo cách phân loại doanh nghiệp/nơi cư trú được cung cấp ở đây. Việc cung cấp thông tin này sẽ không được coi là làm thay đổi các điều khoản của mối quan hệ giữa các bên. Xem Hướng dẫn dịch vụ FedEx và mọi thỏa thuận hiện hành về giá cho tài khoản để biết điều khoản và điều kiện chi phối việc gửi hàng và các khoản phí của FedEx.

Xác thực địa chỉ

Sử dụng điểm cuối này để xác thực và giải quyết các địa chỉ đầu vào và trả về địa chỉ thực. Chi tiết địa chỉ được cung cấp và xác thực để giải quyết một địa chỉ. Một địa chỉ được coi là đã giải quyết khi địa chỉ đầu vào khớp với dữ liệu tham chiếu đã biết.

Thông tin đầu vào cần thiết liên kết với yêu cầu này là:

• Đường phố
• Thành phố (Không bắt buộc)
• Mã tiểu bang hoặc tỉnh (Không bắt buộc)
• Mã bưu chính (Không bắt buộc)
• Mã quốc gia

Lưu ý: Bạn chỉ cần mã tiểu bang hoặc tên thành phố khi khách hàng gửi hàng đến một quốc gia không có mã bưu chính.

API Xác thực địa chỉ trả về địa chỉ thực bằng cách thực hiện các thao tác sau đối với địa chỉ đầu vào:

• Ở bước đầu tiên, API cố gắng đưa địa chỉ đầu vào về trạng thái bình thường. Việc này có thể bao gồm thay thế các từ dùng để gọi tên đường bộ như đường phố và đại lộ bằng các từ viết tắt tiêu chuẩn như ST và PKWY, cũng như sắp xếp lại thứ tự của các thành phần trong địa chỉ. Nếu API không thể đưa địa chỉ đầu vào về trạng thái bình thường, địa chỉ đã giải quyết được trả về sẽ là địa chỉ đầu vào. Các giá trị không phải địa chỉ sẽ được loại bỏ.
• Trong bước thứ hai, API cố gắng chuẩn hóa địa chỉ bình thường hóa bằng cách tìm một địa chỉ thực tế hoặc có khả năng là địa chỉ người dùng định nhập. Nếu API không thể chuẩn hóa, địa chỉ đã giải quyết được trả về sẽ ở dạng bình thường hóa của địa chỉ đầu vào. Hãy tham khảo các phần tử trả về để xác định vấn đề với địa chỉ đã gửi.
• API cũng sẽ trả về các phần tử nhất định của địa chỉ bình thường hóa. Nếu quá trình chuẩn hóa thành công, địa chỉ đã giải quyết được trả về sẽ là địa chỉ thực. Trong trường hợp này, API cũng sẽ trả về nhiều phần tử bổ sung của địa chỉ chuẩn hóa và thông tin về cách thu được địa chỉ chuẩn hóa từ địa chỉ bình thường hóa.

Giá trị trả về của API Xác thực địa chỉ

Nếu địa chỉ được trả về bao gồm những giá trị sau cho các thuộc tính bên dưới, thì địa chỉ đó hợp lệ:

• Trạng thái địa chỉ là Được chuẩn hóa
• Các thuộc tính của Địa chỉ đã giải quyết là Đúng
• Điểm giao hàng hợp lệ (DPV) là Đúng
• Địa chỉ được nội suy là Sai

Nếu các thuộc tính này không được liệt kê, hãy sử dụng các thuộc tính khác để xác định những vấn đề có thể xảy ra với các giá trị địa chỉ.

Để biết thêm thông tin về Các thuộc tính địa chỉ, hãy xem Các thuộc tính địa chỉ.

Nếu thông báo trả về cho khách hàng là INTERPOLATED.STREET.ADDRESS, thì có khả năng địa chỉ không hợp lệ. Để biết thêm thông tin về mã thông báo khách hàng, hãy tham khảo nội dung mô tả phần tử của thông báo khách hàng.

Chú thích

API Xác thực địa chỉ trả về các chú thích cho mỗi địa chỉ được xác thực và trả về. Chú thích cung cấp cho bạn thông tin về nội dung thiếu sót (nếu có) và sự thay đổi so với địa chỉ đầu vào để có được địa chỉ thực đó.

API Xác thực địa chỉ sử dụng dữ liệu tham chiếu để xác định cách phân loại một địa chỉ nhất định. Cách phân loại một địa chỉ chức năng được tính toán độc lập với quá trình xác thực địa chỉ và dựa trên ý kiến phản hồi của nhân viên vận hành, với nguồn dữ liệu thương mại chỉ được sử dụng để xác nhận.

API Xác thực địa chỉ chỉ có bốn cách phân loại khả thi cho địa chỉ: khỗng xác định, doanh nghiệp, nơi cư trú và hỗn hợp. Tất cả địa chỉ đều bắt đầu với loại "không xác định" và sẽ ở trạng thái đó cho đến khi các quy tắc kinh doanh xác thực địa chỉ xác định rằng loại của địa chỉ cần thay đổi. Một địa điểm chỉ được phân loại là "hỗn hợp" nếu đó là địa chỉ cho nhiều người thuê, bao gồm cả căn cho doanh nghiệp và căn cư trú.

Lưu ý: Dịch vụ FedEx Express cung cấp thêm một dòng địa chỉ (dòng địa chỉ 3) cho phần địa chỉ người nhận. Thông tin địa chỉ bổ sung này cung cấp chi tiết hoàn chỉnh và chính xác hơn về địa điểm, cải thiện khả năng nhận được địa chỉ chính xác.

Các địa chỉ thực được phân loại như sau:

Địa chỉ doanh nghiệp

Địa chỉ doanh nghiệp là địa chỉ được sử dụng để chỉ định nơi kinh doanh chính của bạn. Địa điểm này được cho là nơi mà doanh nghiệp của bạn hoạt động nhưng có thể không phải lúc nào cũng vậy.

Địa chỉ doanh nghiệp là địa điểm chính thức của trụ sở công ty. Địa điểm này có thể là bất kỳ nơi nào, từ địa chỉ nhà của một người đến khuôn viên trị giá hàng triệu đô la như trụ sở các công ty công nghệ lớn, cùng nhiều địa điểm khác.

Địa chỉ cư trú

Phí giao hàng đến nơi cư trú sẽ áp dụng với các lô hàng trong nội địa Hoa Kỳ được gửi đến nhà hoặc nơi cư trú riêng, bao gồm cả địa điểm có doanh nghiệp hoạt động tại nhà. Hãy sử dụng FedEx Home Delivery để giao hàng đến nơi cư trú thông qua FedEx Ground trong 1 ngày làm việc, dựa theo khoảng cách đến nơi nhận hàng.

Ví dụ:

• Nhà của viện trưởng
• Tu viện
• Nhà của mục sư
• Cư dân trong những nơi cư trú nhiều căn, chẳng hạn như:
  • Khu căn hộ
  • Chung cư
  • Ký túc xá đại học

• Nơi cư trú có bán và/hoặc phân phối sản phẩm

Sau đây là một số mẹo hữu ích để sử dụng API Xác thực địa chỉ:

• Sử dụng dấu cách hợp lý: Đảm bảo đặt dấu cách ở đúng vị trí và tránh các dấu cách không cần thiết.
• Nhập đúng chính tả: Tránh mọi lỗi chính tả và lỗi đánh máy. Đồng thời, đảm bảo bạn sử dụng đúng số không (0) và chữ cái O.
• Tránh ký tự đặc biệt: Hãy tránh sử dụng các ký tự đặc biệt không cần thiết trong địa chỉ, chẳng hạn như dấu chấm sau từ viết tắt (Ave thay vì Ave.).
• Cung cấp thêm thông tin về đường phố và địa chỉ: Bằng cách cung cấp thông tin địa chỉ bổ sung, bạn có thể tăng độ chính xác của kết quả địa chỉ.
  • Số nhà hoặc tòa nhà - 1, 1A, 1½, One
  • Tên đường phố - Main, George Washington, 42
  • Hậu tố chỉ đường phố - Road, Avenue, Rd, Ave
• Nhập thành phố, tiểu bang/tỉnh và mã ZIP hoặc mã bưu chính: Cung cấp cả ba thông tin này sẽ tăng độ chính xác của kết quả địa chỉ.
• Nhập đường phố và địa chỉ theo thứ tự: Các thành phần trong địa chỉ cụ thể thường tuân theo một cách thức, bắt đầu bằng số nhà hoặc tòa nhà, tiếp theo là thành phần chỉ hướng đứng trước, tên đường phố, loại hoặc hậu tố chỉ đường phố, thành phần chỉ hướng đứng sau, từ viết tắt chỉ loại hình căn hộ, số căn hộ và/hoặc từ viết tắt chỉ hộp thư cá nhân và số hộp thư cá nhân.
• Sử dụng đúng từ viết tắt: Dịch vụ bưu chính Hoa Kỳ và Bưu chính Canada có các từ viết tắt tiêu chuẩn dành cho tiểu bang/tỉnh, hậu tố chỉ đường phố và từ viết tắt chỉ loại hình căn hộ hoặc nhà ở.
  • Từ viết tắt không đúng tiêu chuẩn có thể khiến kết quả tìm kiếm không chính xác.
  • Nếu bạn không chắc chắn về một từ viết tắt thì đừng sử dụng từ đó.

Ví dụ:

• Số nhà hoặc tòa nhà như 1, 1A, One.
• Tên đường phố như Main, George Washington, 42.
• Hậu tố chỉ đường phố như Road, Avenue, Rd, Ave.
• Nhập thành phố, tiểu bang/tỉnh và mã bưu chính: Cung cấp tất cả thông tin địa chỉ sẽ tăng độ chính xác cho kết quả của bạn. Không cần phần ZIP+4 của mã bưu chính để kiểm tra địa chỉ.
• Sử dụng đúng từ viết tắt: Dịch vụ bưu chính Hoa Kỳ và các cơ quan bưu chính ở những quốc gia khác xác định từ viết tắt tiêu chuẩn dành cho tiểu bang/tỉnh, hậu tố chỉ đường phố và từ viết tắt chỉ loại hình căn hộ/nhà ở. Từ viết tắt không đúng tiêu chuẩn có thể khiến kết quả tìm kiếm không chính xác. Nếu bạn không chắc chắn về một từ viết tắt thì đừng sử dụng từ đó.
• Hãy cân nhắc việc trả ý kiến phản hồi về kết quả xác thực địa chỉ cho người dùng để họ có thể chọn địa chỉ chính xác nhất đối với họ.

• Không sử dụng API này để xác định khả năng giao hàng đến một địa chỉ. FedEx không cung cấp dịch vụ giao hàng tới mỗi địa chỉ hợp lệ. FedEx không giao hàng tới các hộp thư bưu điện (ngoại trừ trường hợp giao hàng qua FedEx Ground® Economy (Trước đây gọi là FedEx SmartPost^®).
• Thông tin địa chỉ đã giải quyết được trả về chỉ mang tính đề xuất.
• API này có thể kiểm tra tối đa 100 địa chỉ trong một yêu cầu.
• Các trường bắt buộc tối thiểu khác nhau tùy theo quốc gia.

  Ví dụ: các địa chỉ ở Hoa Kỳ cần ít nhất một dòng địa chỉ và mã bưu chính hoặc mã thành phố và mã tiểu bang, nhưng với các địa chỉ AUS (định dạng địa chỉ ở Úc), bạn có thể bỏ qua mã tiểu bang ngay cả khi không có mã bưu chính.

• Kết quả giải quyết địa chỉ có thể khác nhau tùy theo quốc gia/vùng lãnh thổ.

Lưu ý: API Xác thực địa chỉ có thể sẽ không áp dụng được cho tất cả các quốc gia. Hãy tham khảo phần Quốc gia/vùng lãnh thổ hỗ trợ API Xác thực địa chỉ.