简介
FedEx邮政编码验证API可让FedEx客户验证邮政编码并获取服务承诺。它支持城市、邮政编码、国家/地区以及始发地和目的地相关的查询和验证。并会在回复中返回经验证的邮政编码和位置详细信息。
邮政编码验证API详细信息
邮政编码验证会验证国家/地区和城市的邮政编码,并会在响应中提供经验证的邮政编码。必须提供格式正确的邮政编码才能处理货件或创建托运标签。
此 API 使用提供的输入信息(如寄件日期、邮政编码、国家/地区代码及其他各种信息),并会检查州与城市值之间是否相符。如果发现不相符,且国家/地区为美国或加拿大,则会设置城市和州。例如:FDXE - FedEx Express®、FDXG - FedEx Ground® 和 FXSP - FedEx Ground® Economy(以前称为 FedEx SmartPost®)。此 API 会验证给定输入,并提供位置详细信息和经验证的邮政编码。
FedEx支持向使用和不使用邮政编码的国家/地区提供服务。
使用邮政编码的国家/地区
托运到这些国家/地区的货件应在空运提单和其他文件中包含邮政编码,这样有助于减少延误并最大程度地提高效率。建议FedEx Express客户在位于下列国家/地区的收件人地址中包含有效的邮政编码。
有关使用邮政编码国家/地区的详细信息,请参见使用邮政编码的国家/地区。
不使用邮政编码的国家/地区
顾名思义,对于 FedEx 支持的不使用邮政编码的国家/地区,不强制在其货件中提供邮政编码。如果客户要托运到不使用邮政编码的国家/地区,只需要提供州代码或城市名称。如果不使用邮政编码的国家/地区发生验证错误,请尝试输入“00000”来替代邮政编码,以便强制通过地址验证。使用此虚假邮政编码不会导致问题,因为它根本不存在。
下面是使用FedEx邮政编码验证API的优点:
- 减少托运延误并提高效率。
- 增加准时和完成递送的数量。
- 提升FedEx的城市区域服务,提供灵活的截止时间和取件日程安排。
邮政编码验证API的工作原理
FedEx邮政编码验证使用以下端点来验证城市、国家/地区和始发地与目的地的邮政编码。下列部分说明端点的重要输入和响应:
验证邮政编码
此请求用于根据输入详细信息返回邮政编码详细信息、经验证的邮政编码以及位置说明。与此请求关联的重要输入信息如下:
- carrierCode
- countryCode
- stateOrProvinceCode
- postalCode
- shipDate
此请求的成功结果为针对所提供输入返回的locationdetails和cleanedpostalcode。如果邮政编码无效,例如国家/地区代码、州/省和邮政编码的组合无效,则请求将失败。
常见误解澄清
- 由于地区校准与邮政编码校准是完全独立的校准处理输出,因此无法进行交叉参照。
- 世界上并非所有地理位置都有邮政编码。
有关区域特定列表的详细信息,请参见区域特定服务列表。
业务规则
- 门牌号、街道名称等的组合。至少需要输入一行才能构成有效的实际地址;地址中不允许包含空行。
- 仅当收件人所在国家/地区为美国或加拿大,或者当EEI适用且国家/地区为墨西哥{MX}时,才需要提供2个字母的州/省代码。
- 实际位置的描述性数据可用作真实存在的地址(人们可以前往的地点),也可用作应作为一个单位处理(例如,美国国内的城市-州-邮政编码组合)的“地址组成部分”的容器。
- 根据不同的国家/地区,邮政编码字段的格式和是否存在会有所不同。
JSON API Collection
Response