Shipment special services

shipmentCreateWorkflow mutation으로 shipment을 생성할 때 special service는 carton level에서 추가됩니다. 필요한 special handling 유형은 specialServices로, 해당 service에 필요한 추가 configuration은 specialServiceDetails로 선언합니다.

Carrier 지원은 다릅니다. shipment을 제출하기 전에 선택한 service level이 필요한 special service를 지원하는지 carrier에 확인하세요.

Battery 

carton에 lithium-ion 또는 lithium-metal battery가 포함되면 specialServices에 BATTERY를 사용합니다. specialServiceDetails 내부에 batteryDetail도 제공해야 합니다.

참고: batteryDetail은 carton에 직접 전달하지 말고 specialServiceDetails 내부에 중첩해야 합니다. carton level에서 전달하면 validation error가 발생합니다.

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

Battery material 유형:

• LITHIUM_ION — Lithium-ion battery(충전식)
• LITHIUM_METAL — Lithium-metal battery(비충전식)

Battery packing 유형:

• BATTERY_INSIDE_EQUIPMENT — package item 내부에 battery가 포함됨
• BATTERY_ONLY — package에 battery만 포함
• BATTERY_PACKAGED_WITH_EQUIPMENT — battery가 equipment와 함께 package되었으나 내부에 포함되지 않음

Signature 옵션 

배송 시 signature가 필요하면 specialServices에 SIGNATURE_OPTION을 사용합니다. signature 유형을 지정하려면 specialServiceDetails 내부에 signatureOptionDetail을 제공합니다.

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

Signature option 유형:

• ADULT — 성인 signature 필요(수령인은 법적 연령이어야 함)
• DIRECT — Direct signature 필요(주소에 있는 사람이 서명해야 함)
• INDIRECT — Indirect signature 허용(이웃 또는 building manager가 서명 가능)
• DEFAULT — 선택한 service level의 기본 signature 동작 사용
• NONE — signature 불필요

Alcohol 

Alcohol shipment은 volume, ABV 등 product measurement를 기반으로 applicable excise tax를 계산하는 Zonos excise duties 기능으로 처리됩니다. alcohol shipment 구성은 excise duties guide를 참고하세요.

Dry ice 

carton에 냉매로 dry ice가 포함되면 specialServices에 DRY_ICE를 사용합니다. carton 내 dry ice weight와 함께 specialServiceDetails 내부에 dryIceDetail을 제공합니다.

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

Dangerous goods 

carton에 battery special service를 넘어 특수 carrier handling과 documentation이 필요한 hazardous material이 포함되면 specialServices에 DANGEROUS_GOODS를 사용합니다.

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

carrier별 제한을 포함한 hazardous material shipping 상세 가이드는 hazmat shipping guide를 참고하세요.

Special service 결합 

specialServices array에 여러 값을 전달하면 단일 carton에서 여러 special service를 결합할 수 있습니다.

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