運送特殊服務

特殊服務在透過 shipmentCreateWorkflow 異動建立運送時在紙箱級別新增。使用 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 消費稅功能處理，該功能根據產品量和酒精度數等測量值計算適用的消費稅。請參閱消費稅指南以設定酒精運送。

乾冰 

當紙箱包含乾冰作為製冷劑時，在 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"
      }
    }
  }
]