货运特殊服务

特殊服务在通过 shipmentCreateWorkflow mutation 创建货运时在纸箱级别添加。使用 specialServices 声明所需的特殊处理类型，使用 specialServiceDetails 进行该服务所需的任何其他配置。

承运商支持有所不同。 在提交货运前，请与您的承运商确认所选服务级别是否支持您需要的特殊服务。

电池 

当纸箱包含锂离子或锂金属电池时，在 specialServices 中使用 BATTERY。您还必须在 specialServiceDetails 中嵌套提供 batteryDetail。

注意： batteryDetail 必须嵌套在 specialServiceDetails 内，而不是直接传递到纸箱。在纸箱级别传递它会导致验证错误。

"shipmentCartons": [
  {
    "specialServices": ["BATTERY"],
    "specialServiceDetails": {
      "batteryDetail": {
        "material": "LITHIUM_ION",
        "packingType": "BATTERY_INSIDE_EQUIPMENT"
      }
    }
  }
]

电池材料类型：

• LITHIUM_ION — 锂离子电池（可充电）
• LITHIUM_METAL — 锂金属电池（不可充电）

电池包装类型：

• BATTERY_INSIDE_EQUIPMENT — 电池包含在包装中的物品内
• BATTERY_ONLY — 包装仅包含一个或多个电池
• BATTERY_PACKAGED_WITH_EQUIPMENT — 电池与设备一起包装，但不包含在其内

签名选项 

在 specialServices 中使用 SIGNATURE_OPTION 以要求交付时签名。在 specialServiceDetails 内嵌套提供 signatureOptionDetail 以指定签名类型。

"shipmentCartons": [
  {
    "specialServices": ["SIGNATURE_OPTION"],
    "specialServiceDetails": {
      "signatureOptionDetail": {
        "signatureOptionType": "ADULT"
      }
    }
  }
]

签名选项类型：

• ADULT — 需要成人签名（收货人必须达到法定年龄）
• DIRECT — 需要直接签名（地址处的某人必须签名）
• INDIRECT — 允许间接签名（邻居或楼宇管理员可以签名）
• DEFAULT — 使用所选服务级别的默认签名行为
• NONE — 不需要签名

酒精 

酒精货运通过 Zonos 的消费税功能处理，该功能根据产品测量（如体积和 ABV）计算适用的消费税。请参阅消费税指南来配置酒精货运。

干冰 

当纸箱包含作为冷却剂的干冰时，在 specialServices 中使用 DRY_ICE。在 specialServiceDetails 内嵌套提供 dryIceDetail 以及纸箱中干冰的重量。

"shipmentCartons": [
  {
    "specialServices": ["DRY_ICE"],
    "specialServiceDetails": {
      "dryIceDetail": {
        "weight": 0.5,
        "weightUnit": "KILOGRAM"
      }
    }
  }
]

危险品 

当纸箱包含需要特殊承运商处理和文件的危险材料（超过电池特殊服务）时，在 specialServices 中使用 DANGEROUS_GOODS。

"shipmentCartons": [
  {
    "specialServices": ["DANGEROUS_GOODS"]
  }
]

有关危险品运输的详细指导，包括承运商限制，请参阅危险品运输指南。

组合特殊服务 

多个特殊服务可以通过在 specialServices 数组中传递多个值来组合在单个纸箱中。

"shipmentCartons": [
  {
    "specialServices": ["BATTERY", "SIGNATURE_OPTION"],
    "specialServiceDetails": {
      "batteryDetail": {
        "material": "LITHIUM_ION",
        "packingType": "BATTERY_INSIDE_EQUIPMENT"
      },
      "signatureOptionDetail": {
        "signatureOptionType": "DIRECT"
      }
    }
  }
]