運輸特殊服務

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

乾冰 

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