Fedex Logo

info-icon

注意：- 从亚太地区到美国或波多黎各的 FedEx International Connect Plus (FICP) 服务货件，若关税与税金由收件人支付，则需要提供 FedEx 账号：

  1.   如果任何货件货品的制造国家／地区是中国／中国香港 

简介

此API可让您创建开放货件，并允许在一段时间内向其添加包裹，无需一次性输入所有货件和包裹信息。货件将保持开放状态五天，在该时间段内，它可以接受包裹添加和修改操作。货件确认后，即可生成标签、AWB或报告等托运文件。五天时间结束后，您必须确认该货件，否则便会将其清除。

注意：如果自货件创建之时起到第五天结束前未获确认，开放货件将被清除。

Open Ship API详细信息

当您想在一段时间内向某个货件添加多个包裹，并且不确定要添加的包裹数量或托运完成日期时，将使用Open Ship API。这样，在准备托运之前，您可以花一整天的时间灵活地准备货件。

开放托运货件通常是一票多件货件，但也可以是单件包裹货件（也称为单件货件）。

要将一票多件货件(MPS)托运至单一收件人，请使用Open Ship API并将个别包裹添加到货件中，或者添加多个包裹（如果要寄给同一个收件人）。

以下是与开放货件相关的服务：

  • FedEx Express®美国境内和加拿大境内
  • FedEx Ground®美国境内和加拿大境内
  • FedEx Home Delivery®
  • FedEx International Priority®
  • FedEx International Priority® Express (IPE)
  • FedEx International Economy®
  • FedEx Priority OvernightTM
  • FedEx® Regional Economy
  • FedEx® Regional Economy Freight
  • FedEx International Connect Plus®
  • FedEx® First
  • FedEx Priority Express
  • FedEx Priority
  • FedEx Priority Express Freight
  • FedEx Priority Freight
  • FedEx 经济快递服务（仅限英国）

以下是与Open Ship API相关的功能：

管理开放货件

此功能可让寄件人创建、修改、删除开放货件，并检索已创建的开放货件以进行审核或验证。通过该功能可确认已完成货件，以将货件数据传输给FedEx，并生成相应的货件文件。此外，还可以识别并报告交易中的任何错误，并提供相应状态。

此功能的重要信息为accountNumber、Shipment Data、groupPackageCount、index，以表示货件的主包裹。此功能的结果将确保货件数据上传到FedEx系统，以及生成相应的追踪号码、标签和货件报告。

管理开放货件包裹

此功能可让您在已创建的开放货件中添加、修改和删除包裹。此外，还可以检索现有开放货件的现有包裹。

获取开放货件结果（异步）

通过此功能可异步检索已确认的货件结果。确认包含40个或以上包裹的开放货件后，API会异步处理货件。

异步处理货件时，对此请求的回复只会确认请求已成功排入队列，但货件可能会成功处理，也可能不会成功处理。作为响应，它将返回jobId，以便稍后检索结果。此功能使用jobId检索开放货件结果（创建、修改及确认），这些结果可能是标签、货件报告。此外，还可以识别并报告货件中的任何错误，并提供相应状态。

注意：如果异步货件响应中存在错误，请修复该错误并提交新的货件请求。

Open Ship API工作流程

本节详细介绍Open Ship API的工作流程。Open Ship工作流程以两种方式管理或使用两个处理选项：

40个或以下包裹的工作流程

  1. 使用端点创建开放货件可创建包含所有所需托运、包装信息、accountNumber和index的开放货件。
  2. 使用端点添加开放货件包裹可向已创建的开放货件添加一个或多个（不超过40个）包裹。主要输入信息为要添加包裹的开放货件的index和accountNumber。
  3. 使用端点确认开放货件可最终确认所有包裹均已添加，并且货件已完成。主要输入信息为要确认的货件的index和accountNumber。

此确认开放货件端点是此流程的最后一个端点，可验证货件和包裹信息，并成功生成该货件的标签和所有其他报告。该端点还可提供验证期间返回的错误详细信息。可使用端点修改开放货件或修改开放货件包裹并再次确认货件请求是否成功来修复这些错误。

40个以上包裹的工作流程

  1. 使用端点创建开放货件可创建包含所有所需托运、包装信息、accountNumber和index的开放货件。
  2. 使用端点添加开放货件包裹可向已创建的开放货件添加一个或多个（不超过40个）包裹。主要输入信息为要添加包裹的开放货件的index和accountNumber。
  3. 使用端点确认开放货件可确认所有包裹均已添加，并且货件已完成。主要输入信息为要确认的货件的index和accountNumber。在此情况下，由于包裹超过40个，API会异步处理货件，并返回jobId，以便稍后用于检索货件结果。如果响应中存在错误，则应使用修改开放货件或修改开放货件包裹修复这些错误，并使用端点确认开放货件确认货件。
  4. 使用端点“获取开放货件结果”可检索“创建、修改及确认开放货件”的结果，例如标签和托运文件。主要输入信息为已确认货件的jobId和accountNumber。

获取开放货件结果端点是此流程的最后一个端点，可检索已确认的开放货件结果，例如已确认开放货件的标签和所有其他报告。如果响应中返回了错误详细信息，则可以使用端点修改开放货件或修改开放货件包裹修复这些错误，然后使用端点确认开放货件确认货件，最后使用端点获取开放货件结果检索已确认开放货件结果以获得成功请求。

Open Ship API的运作方式

以下是与Open Ship API相关的功能：

创建开放货件

使用此端点可创建包含所需货件信息的开放货件，并至少定义货件中的一个包裹。

以下是用于创建开放货件的所需输入信息：

  • openShipmentAction – 这是开放货件操作，在此情况下，使用值为CREATE_PACKAGE。
  • accountNumber – 这是FedEx帐号。
  • requestedShipment – 开放货件的货件详细信息。
  • index – 开放货件的唯一值，此值可用于修改货件或包裹。这是可选项，如果未提供，可以使用主追踪号码唯一标识该货件。

针对此请求的成功响应将处理货件并生成追踪号码，该号码即为第一个包裹的主追踪号码。请注意，响应中不会生成标签。

添加开放货件包裹

使用此端点可在货件确认之前向现有开放货件请求添加一个或多个包裹。在当天准备货件时，您可以为每个包裹发送单独的添加包裹请求。您也可以在添加包裹请求中发送多个包裹。

注意：货件的包裹总数不得超过开放货件包裹限制。

以下是用于向开放货件添加包裹的所需输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • requestedPackageLineItem – 要添加的详细包裹信息。
  • accountNumber – 这是FedEx帐号。

针对此请求的成功响应将为新添加的包裹生成追踪号码。

修改开放货件包裹

使用此端点可在货件确认之前修改现有Open Ship货件中的一个或多个包裹的详细信息。此详细信息也包括主包裹详细信息，即向开放货件添加的第一个包裹。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。
  • trackingId – 要修改的包裹的一个或多个Open Ship包裹追踪Id。
  • requestedPackageLineItem – 要修改的详细包裹信息。

成功请求将更新目标包裹并返回更新后的货件详细信息。

删除开放货件包裹

使用此端点可在货件确认之前从已创建的开放货件中删除一个或多个包裹。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。
  • trackingId – 收到删除请求的一个或多个Open Ship包裹追踪Id。

成功请求将删除目标包裹，并在输出中将元素deletedPackagesFromOpenshipment的状态返回为true。

注意：如果货件中的主包裹被删除，序列中的下一个包裹将成为主包裹，并重新获分配主追踪号码，号码序列会减去已删除包裹的数量。

检索开放货件包裹

使用此端点可从已创建的开放货件中检索一个或多个包裹，以进行审核或验证。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。
  • trackingId – 要检索其详细信息的一个或多个Open Ship包裹的追踪Id。

成功请求将检索目标包裹。

修改开放货件

使用此端点可在货件确认之前使用所需托运信息修改开放货件请求。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。
  • requestedShipment – 要修改的开放货件的货件详细信息。

成功请求将更新货件详细信息至已创建的开放货件，并在输出中返回已修改包裹的追踪号码和更新后的交易货件详细信息。

检索开放货件

使用此端点可检索已创建的开放货件，以进行审核或验证。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。

成功请求将检索目标开放货件详细信息。

删除开放货件

使用此端点可在货件确认之前删除开放货件请求。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。

成功请求将删除开放货件和所有关联包裹，并在输出中将元素deletedOpenshipment的状态返回为true。

确认开放货件

使用此端点可在所有包裹均添加到货件请求中后验证Open Ship货件数据并将其上传到FedEx系统。

下面是与此请求关联的必要输入信息：

  • index – 这是分配给已创建的开放货件的唯一值。如果此值不可用，则提供主追踪号码。
  • accountNumber – 这是FedEx帐号。
  • labelResponseOptions – 指定要在响应中返回编码字节码还是标签 URL。
    注意：元素 labelResponseOptions 仅在确认开放货件请求中和货件确认后可用，生成标签。

针对40个或以下包裹的成功确认响应将上传货件数据至FedEx系统，并生成包裹标签及所有其他货件报告。

针对40个以上包裹的成功确认响应将确认请求已成功排入队列并返回jobId，以在稍后检索结果。

注意： 开放货件中应至少包含一个包裹，然后才能确认货件。

获取货件结果

使用此端点可获取已确认的Open Ship货件数据。此端点只能在货件包含40个以上包裹且开放货件确认中返回jobId时使用。

下面是与此请求关联的必要输入信息：

  • resultMethodType – 将值指定为CREATE。
  • accountNumber – 这是FedEx帐号。
  • jobId – 这是开放货件确认期间收到的jobId。

针对此请求的成功响应将返回已确认的开放货件结果，例如已确认的开放货件的包裹标签和所有其他货件报告。如果响应中返回了错误详细信息，则可以使用端点修改开放货件或修改开放货件包裹修复这些错误，然后使用端点确认开放货件确认货件，最后使用端点获取开放货件结果检索已确认开放货件结果。

一票多件开放托运(MPS)

一票多件开放货件(MPS)由托运给同一个收件人的两个或更多个包裹组成。货件请求中的第一个包裹视为主包裹。

创建一票多件货件：

  • 包含货件级别信息，例如serviceType、packagingType、totalWeight、totalPackageCount和requestedPackageLineItems等主包裹详细信息。
    注意：主包裹的sequenceNumber必须等于1。
  • 将所有包裹添加到货件中。
  • 确认货件。

货件确认后，请使用以下其中一个处理选项：

同步货件处理

同步处理是其中一种最佳处理方法，如果货件包含40个或以下包裹(totalPackageCount<=40)且含有受限货品，则会在内部使用此方法。

包含40个或以下包裹的货件请求在确认时会同步处理，并立即生成标签、货件文件/报告。如果寄件人时间紧迫，并且标签必须在货件确认后立即打印，此即为最佳流程。

注意：40个包裹上限是指示性限制，并非固定的限制。该限制还取决于货件中的包裹和货品的组合。有关详细信息，请联系您的FedEx支持团队。

示例：您的开放货件请求包含10个包裹。如果您在添加所有10个包裹后确认货件，将会同步处理该货件。响应中会创建10个标签，并且会依请求在响应中提供标签URL或编码标签。

以下高级别工作流程示范了同步开放货件处理：

  1. 使用端点创建开放货件。
  2. 使用端点添加开放货件包裹添加1到40个包裹
  3. 使用端点确认开放货件可确认开放货件。
  4. 成功的请求应会生成标签，并且输出响应将根据请求包含标签URL或编码标签。
  5. 如果货件存在错误，将在响应中提供错误详细信息。
  6. 更正所有错误后，使用端点确认开放货件以获得成功响应。

注意：

  • 在此方法中，如果您需要为现有货件新增更多包裹，最多只能新增40件包裹。

异步货件处理

当包裹总数超过40（即totalPackageCount>40）时，API会在内部异步处理货件。如果您的包裹数量很大，并且您要定期提交大宗货件，这是一个非常方便的方法。一旦提交，此大宗货件提交将使用各种昂贵的FedEx资源和操作。利用此处理选项，FedEx可在内部确保这些大宗货件得到轻松处理，并且您还可以定期获取标签数据。

异步处理货件时，对此请求的回复只会确认请求已成功排入队列，但货件可能会成功处理，也可能不会成功处理，并返回jobId，以在稍后检索结果。

注意：此过程需要一些时间来成功完成货件处理，然后您才能检索结果。

若要检索异步货件结果，请使用端点获取开放货件结果并在请求中提供jobId和accountNumber详细信息。此请求的响应将返回包含标签详细信息或货件错误详细信息的货件结果数据。

示例：您的货件包含45个包裹，提交后，将进行异步处理。在响应中，将返回jobId。然后，您应使用端点获取开放货件结果来检索货件结果和标签数据。

以下高级别工作流程示范了异步托运处理：

  1. 使用端点创建开放货件。
  2. 使用端点添加开放货件包裹添加40个或以上包裹。
  3. 使用端点确认开放货件可确认货件。
  4. 成功提交后，系统会提供jobId。
  5. 使用jobId和accountNumber可通过获取开放货件结果端点检索输出结果。
  6. 成功输出将提供货件结果数据和标签详细信息。
  7. 如果结果存在错误，将在响应中提供错误详细信息。

注意：

  • 在此方法中，单个请求所允许的最大包裹数为300件，或最多999件货品。
  • 在此方法中，一旦提交请求，便无法在原始请求中新增、修改或删除包裹。如果响应中存在错误，请使用端点修改开放货件包裹修复错误，然后使用确认开放货件确认货件，并使用获取开放货件结果端点获取成功的输出结果。

Print As You Go (PASGO)

利用 Print As You Go (PASGO) 功能，可以创建包裹并将其添加到 PASGO MPS 开放货件，并且可在添加每个包裹时随即打印标签。这意味着，您可以随印随发标签，而无需等待货件关闭。

重要事项：

  • 您的 FedEx 账户必须启用 PASGO 功能才能使用此功能。
  • 发出 API 请求时，必须将 openShipmentAction 的枚举值设置为 PROVIDE_DOCUMENTS_INCREMENTALLY。
  • 此功能支持仅 Base64 格式的标签。无论在 labelSpecification 中提供了什么，输出都将采用 Base64 格式。
  • 每个货件最多可以添加 40 个包裹。尝试添加超过 40 个包裹将导致错误。在这种情况下，您需要创建新的 PASGO 开放货件，或通过 Ship API 或 Open Ship API 使用标准 API 调用。
  • 可以通过以下操作来管理货件：
    • 检索开放货件包裹
    • 修改开放货件包裹
    • 删除开放货件包裹
    • OpenShipmentDelete V1 
  • 此功能目前不支持危险品和锂电池货件选项。
  • 仅来自欧洲的货件支持 Print As You Go。

FedEx托运标签

FedEx API支持多种标签。FedEx API支持三类标签选项，包括热敏标签、普通纸标签和可自定义标签。您可以使用Open Ship API端点来生成各种标签。

FedEx提供两种标签格式用于支持托运服务：

  • 热敏标签
  • 激光标签

热敏标签

FedEx API可让您使用各种热敏标签打印机来打印所有托运类型的托运标签，例如FedEx Express®、FedEx Ground®和FedEx International Ground®。

FedEx API支持以下热敏标签大小：

  • 4x6英寸 – 不含可配置文件标签（文件标签）
  • 4x6.75英寸 – 包含或不含文件标签
  • 4x8英寸 – 提供用于容纳所选图形或文本文件的空间
  • 4x8.5英寸 – 含可配置文件标签（专为轮胎识别标签而添加）
  • 4x9英寸 – 提供容纳图形或文本以及文件标签的空间
  • 4x10.5英寸 – 含可配置文件标签（专为轮胎识别标签而添加）

标签贴纸类型：4X8.5英寸和4X10.5英寸（包含使用相同条形码的额外文件标签）。主标签上会显示一个条形码，另一个条形码显示在文件标签上。此标签贴纸类型值对于轮胎包裹很有用，因为一个标签可贴在轮胎胎面，另一个文件标签及复制的条形码和操作说明可贴在轮胎侧壁。使用这些标签贴纸类型可减少轮胎重贴标签的次数，并提升了立体扫描优化恢复。有关标签贴纸的详细信息，请参考标签贴纸类型。

注意：文件标签是一种附带其他托运信息的可去除粘性标签，使用热敏打印机打印托运标签时，可为标签贴纸选择此标签。

热敏标签元素

热敏托运标签包含三个基本元素：

  • 人工读取的内容：此标签部分包含托运信息。
  • 默认情况下，Ground人工读取的条形码将经过加密。
  • 二维码：二维字母数字条形码会使用美国国家标准协会(ANSI) MH10.8.3标准存储FedEx Express货件和FedEx Ground货件的数据。二维码使用可移植数据文件(PDF) 417符号表示法创建。
  • FedEx特定条形码：
    • ASTRA (Advanced Sorting Tracking Routing Assistance)适用于已完全采用FDX 1D条形码的FedEx Express货件；条形码“96”适用于FedEx Ground和FedEx Home Delivery货件。FedEx Ground还允许使用SSCC-18“00”条形码。
    • 适用于FedEx Express货件的FedEx 1D (FDX1D)条形码使用ANSI/AIM BC4-1995 (Uniform Symbology Specification CODE-128C)创建。

生成热敏标签的重要信息

以下是生成热敏标签所需的重要信息：

  • LabelFormatType：用于接收Open Ship回复API中正确的标签图像：
    • COMMON2D：用于接收标签的标签格式类型。
    • LABEL_DATA_ONLY：该值用于接收条形码数据（如果创建了自定义标签）。

    • 有效值：

  • ImageType：根据您使用的打印机格式化热敏标签时的必需信息；可提供要返回的数据流类型或位图类型。

    • EPL2 - Eltron（标签贴纸类型）
    • ZPLII - Zebra（标签贴纸类型）

    • 有效值：

    注意：货件所需的所有标签都在一个缓冲区中生成并返回。

受支持的热敏打印机

建议对FedEx API使用以下热敏打印机：

  • Unimark
  • Eltron
    • Orion (EPL2)
    • Eclipse (EPL2)
  • Zebra
    • LP2443 (EPL2)
    • LP2844 (EPL2)
    • Gk420 (ZPL)
    • LP2348 Plus (EPL2/ZPL)
    • Z4M Plus（ZPL或EPL）
    • ZP500/ZP505 (EPL2/ZPL)
    • Z4M/Z4M+ (EPL2/ZPL)
    • ZM400 (EPL2/ZPL)
    • ZT410 (EPL2/ZPL)
    • 其他ZT4xx系列打印机(EPL2/ZPL)

注意：这些打印机都与ASCII Eltron编程语言(EPL2)页面模式兼容。热敏打印机既可以作为连接至系统串行端口的直接写入打印机，也可以作为本机Windows安装的打印机用于连接LPT、串行或USB。FedEx提供的打印机的固件版本可能因地区而异。

每项服务打印的热敏标签数量

下表列出了各特殊服务所需的每种标签类型的数量。所有必要的标签都通过调用FedEx Common Label Server (CLS)生成，CLS会返回一个缓冲区（C.O.D.退件标签除外）。

每项美国服务打印的热敏标签数量

服务类型

热敏标签（FedEx CLS将在响应中返回相应的标签数量）

FedEx Express美国

1个托运标签

FedEx Ground美国/ FedEx Home Delivery

1个托运标签

每项美国出口国际服务打印的热敏标签数量

服务类型

热敏标签（FedEx CLS将在响应中返回相应的标签数量）

FedEx Express美国出口国际

1个托运标签

2个收件人标签

FedEx Express美国出口国际代理人自选选项

1个托运标签

2个收件人标签

FedEx Ground美国出口国际

1个托运标签

FedEx Ground美国出口国际货到付款

1个托运标签

2个C.O.D.退件标签

每项加拿大境内服务打印的热敏标签数量

服务类型

热敏标签（FedEx CLS将在响应中返回相应的标签数量）

FedEx Express加拿大境内

非危险品/干冰货件：

1个托运标签

FedEx Ground加拿大境内

1个托运标签

FedEx Ground加拿大境内货到付款

1个托运标签

2个C.O.D.退件标签

每项加拿大出口国际服务打印的热敏标签数量

服务类型

热敏标签（FedEx CLS将在响应中返回相应的标签数量）

FedEx Express加拿大出口国际

非危险品/干冰货件：

1个托运标签

2个收件人标签

FedEx Express加拿大出口国际代理人自选

非危险品/干冰货件：

1个托运标签

2个收件人标签

FedEx Ground加拿大出口国际

1个托运标签

每个菲律宾和泰国进口货件打印的热敏标签数量

服务类型

热敏标签（FedEx CLS将在响应中返回相应的标签数量）

菲律宾入境货件

2个印有帐号的托运标签

打印1个不含帐号的收件人标签

3份商业发票副本

泰国入境货品货件

打印3个含帐号的托运标签

打印1个不含帐号的收件人标签

泰国入境文件货件

2个印有帐号的托运标签

打印1个不含帐号的收件人标签

文件标签

如果使用热敏打印机来打印托运标签，您可以选择包含文件标签的标签贴纸（一种附带其他托运信息的可去除粘性标签）。您可以在托运数据中配置此托运信息，也可以选择打印特定于您的托运需求的可配置数据。

激光标签

FedEx API支持使用激光打印机打印标签。这些标签通常打印在U.S. Letter或A4纸上，然后对半折叠以放入标准的FedEx标签袋中。使用激光打印机打印的标签会以PDF的格式生成，因此不需要缩放或调整大小。有关标签贴纸的详细信息，请参考标签贴纸类型。

先决条件

下列要求适用于PDF标签：

  • 需要安装Adobe Reader 6.0或更高版本才能处理标签。
  • 打印机驱动程序配置必须将打印比例设置为无。
  • 在浏览器中显示普通纸PDF标签时不需要使用HTML包装器。
  • Acrobat建议使用下列浏览器来查看PDF文件：
    • Microsoft Internet Explorer 10或更高版本
    • Firefox 1.0或更高版本
    • Mozilla 1.7或更高版本

PDF标签选项不必指定图像方向参数（宽度和高度）或屏幕分辨率，便可在浏览器中正常显示标签。

激光标签元素

激光托运标签包含三个基本元素：

  • 人工读取的内容 – 此标签部分包含托运信息。
  • 默认情况下，Ground人工读取的条形码将经过加密。
  • 二维(2D)码 – 二维字母数字条形码会使用美国国家标准协会(ANSI) MH10.8.3标准存储FedEx Express货件和FedEx Ground货件的数据。二维码使用可移植数据文件(PDF) 417格式创建。
  • FedEx特定条形码：
    • ASTRA (Advanced Sorting Tracking Routing Assistance)适用于已完全采用FDX 1D条形码的FedEx Express货件；条形码“96”适用于FedEx Ground和FedEx Home Delivery货件。如果适用，FedEx Ground还允许使用SSCC-18“00”条形码。
    • 适用于FedEx Express货件的FedEx 1D (FDX1D)条形码使用ANSI/AIM BC4-1995 (Uniform Symbology Specification CODE-128C)创建。

生成激光标签的重要信息

生成激光标签需要以下FedEx API元素：

  • LabelSpecification/LabelFormatType：用于接收Open Ship回复API中正确的标签图像：有效值为：
    • COMMON2D – 用于接收标签的标签格式类型。
    • LABEL_DATA_ONLY – 此值用于接收条形码数据（如果创建了自定义标签）。
  • LabelSpecification/ImageType：用于指示标签格式。要返回的数据流类型或位图类型：

    有效值为：

    • PDF – 普通纸
    • PNG – 普通纸
  • LabelSpecification/LabelStockType：对于所有标签类型都是必需的。指定标签贴纸的标签前端或后端是否贴有文件标签。使用PDF或PNG的图像类型时，这些值会显示激光格式标签：
    • PAPER_4X6
    • PAPER_4X8
    • PAPER_4X9
    • PAPER_4X675
      这些值会显示普通纸格式托运标签：
    • PAPER_7X47
    • PAPER_85X11_BOTTOM_HALF_LABEL
    • PAPER_85X11_TOP_HALF_LABEL
    • PAPER_LETTER

注意：如果您请求普通纸标签，则返回的数据是采用Base64编码的标签图像，您必须先进行Base64解码才能显示该标签文件。

受支持的激光打印机

大部分激光打印机都支持此标签类型；但如果要通过喷墨打印机进行打印，则不接受这些标签。
注意：如果您使用的是彩色激光打印机，则色彩定义应设置为黑色，即使打印机只安装了黑色墨盒也是如此。

各项服务需要的激光标签数量

下表列出了各特殊服务所需的每种标签类型的数量。所有必要的标签都通过调用FedEx Common Label Server (CLS)生成，CLS会返回一个缓冲区（C.O.D.退件标签除外）。

每项美国服务打印的激光标签数量

服务类型

激光标签 - PDF格式

FedEx Ground / FedEx Home Delivery美国

1个托运标签

每项美国出口国际服务打印的激光标签数量

服务类型

激光标签 - PDF格式

FedEx Express美国出口国际

回复中有1个托运标签；必须至少打印3个标签 – 包裹上1个标签以及文件袋上2个标签。

FedEx Express美国出口国际代理人自选

回复中有1个托运标签；必须至少打印3个标签 – 包裹上1个标签以及文件袋上2个标签。

FedEx Ground美国出口国际

1个托运标签

FedEx Ground美国出口国际货到付款

1个托运标签

2个C.O.D.退件标签

每项墨西哥境内服务打印的激光标签数量

服务类型

激光标签 - PDF格式

FedEx Express墨西哥境内

FedEx Express墨西哥境内

非危险品/干冰货件：

1个托运标签

每项加拿大境内服务打印的激光标签数量

服务类型

激光标签 - PDF格式

FedEx Express加拿大境内

FedEx Express加拿大境内

非危险品/干冰货件：

1个托运标签

FedEx Ground加拿大境内

1个托运标签

FedEx Ground加拿大境内货到付款

1个托运标签

2个C.O.D.退件标签

每项加拿大出口国际服务打印的激光标签数量

服务类型

激光标签 - PDF格式

FedEx Express加拿大出口国际

FedEx Express加拿大出口国际

非危险品/干冰货件：

1个托运标签

2个收件人标签

FedEx Express加拿大出口国际代理人自选

FedEx Express加拿大出口国际代理人自选

非危险品/干冰货件：

1个托运标签

2个收件人标签

FedEx Ground加拿大出口国际

1个托运标签

每项加拿大出口国际服务打印的激光标签数量

服务类型

激光标签 - PDF格式

FedEx Express加拿大出口国际

FedEx Express加拿大出口国际

非危险品/干冰货件：

1个托运标签

2个收件人标签

FedEx Express加拿大出口国际代理人自选

FedEx Express加拿大出口国际代理人自选

非危险品/干冰货件：

1个托运标签

2个收件人标签

FedEx Ground加拿大出口国际

1个托运标签

每个菲律宾和泰国进口货件打印的激光标签数量

服务类型

热敏标签（FedEx CLS将在响应中返回相应的标签数量）

菲律宾入境货件

2个印有帐号的托运标签

打印1个不含帐号的收件人标签

3份商业发票副本

泰国入境货品货件

打印3个含帐号的托运标签

打印1个不含帐号的收件人标签

泰国入境文件货件

2个印有帐号的托运标签

打印1个不含帐号的收件人标签

自定义标签

FedEx允许您对FedEx生成的标签进行自定义。您可以添加与您业务相关的文本，并选择在FedEx文件和标签的热敏标签自定义部分上使用的条形码（符号）类型。

为了支持您的托运应用程序，FedEx Open Ship API提供了两个选项可供您自定义托运标签：

  • 将PNG PAPER 7x4.75英寸图形置于标签贴纸中。例如，您可以在8-1/2x11英寸的表格上创建装箱单。在此表格中，您还可以放置7x4.75英寸的PNG PAPER图形，而不是自行创建自定义标签。
  • 将图形或文本文件添加至4x8英寸或4x9英寸热敏标签。此标签尺寸提供2英寸的空间用于容纳您的图形或文本。

注意：无法更改标签的人工读取内容和标签公共部分中的条形码。

自定义验证器标签

您可以创建包裹级别和货件级别的非托运自定义标签，方法是指定所需的自定义信息、如何格式化该信息以及要将其放在自定义标签上的位置。自定义标签受限于热敏标签格式。

自定义热敏标签

FedEx API提供了两种热敏标签格式，您可以使用图形或文本文件进行自定义，而无需创建自定义标签。这些标签支持所有FedEx托运服务。这些格式包括：

  • 4x8英寸热敏标签，不含文件标签
  • 4x9英寸热敏标签，含文件标签

这些标签类型提供 2 英寸的可自定义部分。此功能适用于在设置为 203 DPI 或 300 DPI 的热敏打印机上打印的热敏标签。

自定义标签规则

这些标签格式的使用规则如下：

  • 只能自定义托运标签。例如，如果打印含有您徽标的4x8英寸Express托运标签，则次要收件人标签将不会显示该徽标。
  • 可自定义的图形或文本的高度不能超过2英寸，宽度不能超过4-1/2英寸。
  • FedEx不提供更正服务。图形和/或文本将按照其在托运服务中提交的原样进行打印。
  • 如果未提供打印图形和/或文本所需的所有数据（例如：X和Y坐标），则会返回一个不含自定义数据的有效托运标签。如果尝试使用该图形和/或文本重新创建另一个标签，您必须取消此标签表示的货件。
  • 对于 203 DPI（8 点/毫米）打印机分辨率，关于 X 和 Y 坐标的位置，插入点坐标数据为 4.00x6.75 英寸热敏标签（包含底部文件标签）的上边界和左边界的交叉点。对于包含顶部文件标签的 4.00x6.75 英寸热敏标签，以 164 点为单位递增插入点的 Y 坐标值。对于不含文件标签的 4.00x6.00 英寸标签，以 8 点为单位递增插入点的 Y 坐标值。热敏标签元素属性是根据 203 DPI（8 点/毫米）打印机分辨率而定的。
  • 对于 300 DPI（12 点/毫米）打印机分辨率，关于 X 和 Y 坐标的位置，插入点坐标数据为 4.00x6.75 英寸热敏标签（包含底部文件标签）的上边界和左边界的交叉点。对于包含顶部文件标签的 4.00x6.75 英寸热敏标签，以 246 点为单位递增插入点的 Y 坐标值。对于不含文件标签的 4.00x6.00 英寸标签，以 12 点为单位递增插入点的 Y 坐标值。热敏标签元素属性是根据 300 DPI（12 点/毫米）打印机分辨率而定的。
    注意：
    • 对于 FXD1D 条形码，X 尺寸（符号中最窄条的宽度）对于 203 DPI 打印机为 15 mil（3 点），对于 300 DPI 打印机为 13.3 mil（4 点）。
    • 对于 2D PDF-417 条形码，对于 203 DPI 打印机，X 尺寸为 10 mil（2 点）。为了获得与 300 DPI 打印机最接近的等效 X 尺寸，必须使用 9.99 mil（3 点）。
    • 对于标签顶部的寄件人/其他块和收件人信息下的寄件人参考块（其中使用了非常小的字体），标签开发人员需要检查 ZPL 编程指南以交叉引用字体集特性，来为各种其他打印头分辨率选择等效的执行字体集。
  • 字符插入点位于顶行字符串中第一个字符的左上角。
  • 打印机限制要求位置原点处于正视图左上象限。这样，数据便可以从标签的可自定义部分开始，向下写入到标签的FedEx部分（实际的热敏标签数据）。在这种情况下，您的徽标或文本将被FedEx标签信息覆盖。您必须更正此位置才能使用托运标签。
  • 将文件标签信息添加至4x9英寸标签时，必须使用标准4x6英寸文件标签热敏标签所用的相同流程进行配置。

注意：应只添加单比特位色彩图像，因为标签将以黑白颜色打印。

自定义标签图形项目元素

API可为FedEx Express和FedEx Ground标签提供PNG（可移植网络图形）图像。PNG标签图形是API支持的热敏或普通纸标签的副本。此标签选项可让您将PNG标签图形置于标签贴纸上，而无需创建自定义标签。

当使用嵌入在托运文件中的4x6英寸PNG图形时，适用以下要求：

  • 标签贴纸
  • 打印机
  • 缩放

标签贴纸

4x6 英寸 PNG 标签只应与即撕即贴标签贴纸配合使用。FedEx Ground 和 FedEx Express 标签验证团队将拒绝不是在即撕即贴标签贴纸上打印的 4x6 英寸 PNG 标签，包括任何打印在普通纸上的标签。

打印机

建议使用激光打印机来打印标签。不应使用喷墨打印机，因为它们在创建可扫描条形码时会产生不一致。除非色彩定义设置为黑色，否则不能使用彩色打印机打印4x6英寸PNG标签，即使打印机只安装了黑色墨盒也是如此。要产生可供FedEx集散中心扫描的正确条形码定义，就必须进行此设置。

缩放

在托运交易中返回的图像的每英寸点数(DPI)为200，尺寸为4（宽）x6（高）英寸或800x1200像素。此标签的方向为纵向，适合打印在4x6英寸标签区域中。打印出来后，标签尺寸将为4x6英寸。

为了采用所需DPI生成标签和条形码，您必须在打印之前缩放图像（或调整其大小）。缩放图像的方式取决于您用来查看和打印标签的应用程序。要以英寸为单位缩放4x6英寸标签的PNG图像：精确使用4英寸宽和6英寸长。

标签复查核对清单

所有条形码

验证要点：

  • 空白区：条形码上下两边必须始终至少留有0.1英寸的空白区域。
  • 空白区：条形码左右两边必须始终至少留有0.2英寸的空白区域。
  • 验证是否所有条形码都符合最低高度要求。

打印质量

导致标签被拒的常见问题：

  • 竖条分离
  • 印迹淡化/空心字
  • 重复的空心字（电辊问题）
  • 斑点（热转印）
  • 剥落（激光）表示存在墨粉融合问题
  • 打印时起皱（热转印）
  • 直接热敏标签的打印对比度至少必须为90%

Ground标签的人工读取详细信息

对于FedEx Ground标签的人工读取内容，需要验证以下项目：

  • 数据与条形码匹配
  • FedEx Ground徽标：徽标可从FedEx Identity网站fedex.com下载。
  • FedEx Home Delivery徽标：在1英寸以内的托运目的地地址方框中，标签必须至少包含一个大写“H”。“H”必须至少为0.25x0.70英寸。
  • 服务描述
  • 寄件人信息
  • 收件人信息
  • 邮政编码和路线
  • 寄件日期
  • 实际重量
  • 客户自动化设备信息（Meter、应用程序/系统、版本）
  • 尺寸
  • 其他参考信息
  • 追踪号码和表单ID（追踪号码必须是14位数）
  • 机坪ID
  • 邮政编码

Express标签的人工读取详细信息

标签上必须打印以下元素才能通过验证：

  • FedEx Express徽标：徽标可从FedEx Identity网站fedex.com下载。
  • 服务描述
  • 包裹类型（如果是国际货件）
  • 递送星期日期（例如，MON表示星期一）
  • 递送截止日期
  • Meter号
  • 寄件日期
  • 所有MPS上的件数格式、主标签用语、CRN标签用语
  • 机坪ID
  • 邮政编码和路线
  • URSA路线前缀和后缀
  • 处理代码
  • 服务区域承诺
  • 收件人和寄件人的电话号码
  • 重量
  • 尺寸（如适用）
  • 参考字段（如果为酒精货件）
  • 追踪号码和表单ID（追踪号码必须是14位数）
  • 在ASTRA标签中，12位数的追踪号码位于32个字符条形码中的第17到28位。在新的FDX 1D条形码中，追踪号码位于第21到34位。FedEx Express追踪号码仍然为12位数。前面两位是数字零。

业务规则

以下规则适用于Open Ship API：

  • 也可以使用单个包裹创建和确认开放货件。
  • 注意：如果自货件创建之时起到第五天结束前未获确认，开放货件将被清除。
  • 货件确认后，无法向开放货件添加更多包裹。
  • 当创建始发地为英国本土且目的地为英国海峡群岛（或相反方向）的货件时，您必须在请求中提供货件的描述和价值。生成一份空运提单副件和两份商业发票或形式发票副件，可用于此货件。
  • 需要按照以下条件进行货件创建：
Tariff_Changes_Updated

JSON API Collection

CLOSE

Response

Copy