Fedex Logo

简介

取件请求API可让您检查是否可以取件、安排速递员取件以及取消取件请求。

取件请求API适用于所有地区之间的FedEx Express和FedEx Ground(退件和出境)货件的新包裹或先前已处理的包裹。本详细指南可帮助您快速入门,并让您了解有关取件请求API的所有必要知识。

取件请求API详细信息

以下是与取件请求API关联的重要功能:

取件可用性

通过取件可用性,您可以根据输入的请求检查取件服务是否可用。取件可用性取决于两个因素:截止时间和访问时间。

截止时间 - 安排取件的最晚允许时间。该时间是取件邮政编码所在地的当地时间。

访问时间 - 即从取件备妥(当包裹准备好可供收取时)到司机准备收取包裹之间的时间。

创建取件

此选项可让您安排取件,适用于FedEx Express®和FedEx Ground®国内和国际货件。FedEx Ground和Express取件请求API会返回取件确认号码,还会随已安排取件的Express取件请求一起返回服务站代码。您还可以使用此API安排收取退件。

额外的收件人地址行(地址行3)可让您提供更完整和准确的位置详细信息,以便更快递送FedEx Express®货件。预约FedEx速递员前往您的位置或其他位置(额外收费)取件,可节省您的时间和精力。

取消取件

此选项可让您取消先前安排的取件。此选项适用于FedEx Express和FedEx Ground国内和国际货件。FedEx Express国内和国际取件可于当天取消。FedEx Ground国内和国际货件可在取件请求提交后的24小时取消。如果您的货件已被收取,请致电FedEx客户服务热线800 FedEx (800 3339)来继续取消操作。

取件请求详细信息

FedEx Express取件请求

  • 包裹备妥以供取件的时间不能晚于您位置对应邮政编码所在地的截止时间。可以使用取件可用性请求检索截止时间。
  • 从包裹准备就绪到速递员不再能够进入取件地点收取包裹的相隔时间不能小于“访问时间”,此时间也可以使用取件可用性请求来检索。
  • 例如,“PT4H0M”表示取件时间为4小时0分钟。

  • 可将FedEx Express取件安排在当天或下一个工作日。
  • 单个取件请求的包裹数上限为99。
  • 如果您已安排了定期取件,则不需要安排一次性取件或添加其他定期取件。
  • 取件请求无法更改。要更改请求,必须先取消原始请求,然后输入新请求。
  • FedEx系统现在支持英国国内取件功能。

FedEx Ground取件请求

  • 您可以安排在下一个工作日取件,也可以最多提前2周安排于任一工作日取件。
  • 单个取件请求的包裹数上限为99。
  • 如果您已安排了定期取件,则不需要安排一次性取件或添加其他定期取件。
  • 前往住宅地址取件需要收取附加费。
  • 取件请求无法更改。要更改请求,必须先取消原始请求,然后输入新请求。

取件请求API服务类型

FedEx Express取件

当您请求FedEx Express取件时(包括通过fedex.com和FedEx客户服务发出请求),将收取速递员取件费用。

FedEx Ground取件

FedEx Ground可应要求提供取件服务,但会收取额外费用。对于定期预约取件客户,我们会向与定期预约取件关联的帐号收取每周取件费用。

  • 对于没有定期预约取件的客户,我们会按每个包裹收取待命取件费用。如果您自行前往FedEx托运服务站投递包裹,则不会收取待命取件费用。此外,待命取件费用不适用于FedEx Ground® Economy(以前称为FedEx SmartPost®)打印退件标签、FedEx Ground® Economy(以前称为FedEx SmartPost®)以电子邮件发送退件标签和FedEx Ground®包裹退件计划取件。
  • 对于定期预约取件客户,FedEx Ground可应要求提供从FedEx Ground帐户的托运位置以外的地址收取包裹的服务。此服务将按每周每个唯一地址收取额外备用地址取件费用。

FedEx Extra Hours

FedEx Extra Hours服务提供周一到周五隔夜1日达取件选项,让零售商能够利用FedEx Express本地隔天送达服务完成夜间订单。

有关可用服务的详细信息,请访问fedex.com。

取件请求API的工作原理

以下是取件请求API提供的取件选项:

检查取件可用性

使用此端口可申请获取可用的取件预约详细信息。

与此请求关联的重要输入信息如下:

  • 取件地址/邮政详细信息。
  • 取件请求类型(如当天/未来)。
  • 取件的FedEx运输承运人(如:express/ground)。
  • 是否为国内/国际取件。

如若申请成功,将返回可用的取件预约详细信息。例如:取件截止时间、取件日期、取件时间、默认备妥时间及其他取件可用性预约详细信息。如果发生任何失败情况,还会返回错误情况和说明。

创建取件

使用此端口可为待取件的包裹创建取件请求。

与此请求关联的重要输入信息如下:

  • FedEx帐号,用于为取件开具发票。
  • 始发地详细信息(地址、位置和取件地址类型,如帐户/寄件人/其他)。
  • 取件的FedEx运输承运人(express/ground)。
  • 关联帐户的地址详细信息。

成功的取件请求将返回要预约取件的取件确认号码、取件通知和服务站代码。如果发生任何失败,还会返回错误和说明。

取消取件

使用此请求取消已安排的包裹取件请求。

与此请求关联的重要输入信息如下:

  • 取件确认代码(提交取件请求时获得)
  • 取件的FedEx运输承运人(Express/Ground)
  • 安排的日期(取件派遣发生的日期)
  • 服务站(负责处理取件请求的FedEx Express服务站)

成功的取件取消操作将返回确认号码和取件取消确认消息。如果发生任何失败,还会返回错误和说明。

注意:提交取件确认号码和相应服务站代码(仅适用于FDXE)以取消预约的取件。提交取件请求时将获取取件确认号码和相应的服务站代码(仅适用于FDXE)信息。如果您在已派遣FedEx速递员前往取件位置后才尝试取消取件,则会收到失败通知。

业务规则 

  • 要请求在不同的国家/地区取件,请提供国家/地区元素以及您希望FedEx前往收取货件所在地的相应国家/地区代码。
  • FedEx将为成功派遣请求返回一个派遣确认号码。除非添加的包裹超出了原始请求的尺寸或重量,否则,派遣请求应限制为每天一个请求。
  • 如果所输入的包裹备妥和营业结束之间的时间间隔不够长,派遣请求可能会失败。如果您有任何关于取件时间的疑问,请拨打您所在区域的FedEx支持热线。
  • 取件请求API支持的重量类型为“LB”和“KG”。包裹和货品的重量单位应相同,否则请求将导致错误。
  • 如果您需要同时安排FedEx Express(包括墨西哥国内托运)和FedEx Ground包裹取件,则需要分别为每个承运人安排一个取件。
  • 如果取件位置在偏远地区,请确保提前准备好包裹,以配合偏远地区取件时间。
  • 始终包含包裹可取件的最晚时间(或者您公司的下班时间)。
  • 我们在全球精选的服务站提供FedEx Express包裹的星期六取件服务。很多FedEx服务站还提供星期六投递服务。使用“服务站服务”端点来接收星期六投递服务站的列表。
  • 对于FedEx Ground和FedEx Express取件,您可以请求一个与您FedEx帐号关联的托运位置不同的备用取件地址。
  • 如果您需要FedEx Express或FedEx Ground定期取件服务,请与FedEx客户主管联系。
  • 只有在以下情况下,您才能取消FedEx Express或FedEx Ground取件:
    • 请求包裹备妥时间尚未到达,及
    • 尚未派遣速递员。

JSON API Collection

CLOSE

Response

Copy