配送特別サービス

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 配列で複数の値を渡すことにより、複数の特別サービスを 1 つのカートンに組み合わせることができます。

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