Layanan khusus pengiriman

Layanan khusus ditambahkan pada tingkat karton saat membuat pengiriman melalui mutasi shipmentCreateWorkflow. Gunakan specialServices untuk mendeklarasikan jenis penanganan khusus yang diperlukan, dan specialServiceDetails untuk konfigurasi tambahan yang diperlukan layanan tersebut.

Dukungan pembawa berbeda-beda. Konfirmasi dengan pembawa Anda bahwa tingkat layanan yang dipilih mendukung layanan khusus yang Anda butuhkan sebelum mengirimkan pengiriman.

Baterai 

Gunakan BATTERY di specialServices saat karton berisi baterai lithium-ion atau lithium-metal. Anda juga harus menyediakan batteryDetail yang tersarang di dalam specialServiceDetails.

Catatan: batteryDetail harus tersarang di dalam specialServiceDetails, bukan diteruskan langsung pada karton. Meneruskannya di tingkat karton akan menghasilkan kesalahan validasi.

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

Jenis material baterai:

• LITHIUM_ION — Baterai lithium-ion (dapat diisi ulang)
• LITHIUM_METAL — Baterai lithium-metal (tidak dapat diisi ulang)

Jenis pengemasan baterai:

• BATTERY_INSIDE_EQUIPMENT — Baterai terdapat di dalam item dalam paket
• BATTERY_ONLY — Paket hanya berisi satu atau beberapa baterai
• BATTERY_PACKAGED_WITH_EQUIPMENT — Baterai dikemas dengan peralatan tetapi tidak terdapat di dalamnya

Opsi tanda tangan 

Gunakan SIGNATURE_OPTION di specialServices untuk memerlukan tanda tangan saat pengiriman. Sediakan signatureOptionDetail yang tersarang di dalam specialServiceDetails untuk menentukan jenis tanda tangan.

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

Jenis opsi tanda tangan:

• ADULT — Tanda tangan dewasa diperlukan (penerima harus berusia dewasa)
• DIRECT — Tanda tangan langsung diperlukan (seseorang di alamat harus menandatangani)
• INDIRECT — Tanda tangan tidak langsung diizinkan (tetangga atau manajer gedung dapat menandatangani)
• DEFAULT — Menggunakan perilaku tanda tangan default untuk tingkat layanan yang dipilih
• NONE — Tidak ada tanda tangan yang diperlukan

Alkohol 

Pengiriman alkohol ditangani melalui fitur bea cukai Zonos, yang menghitung pajak bea cukai yang berlaku berdasarkan pengukuran produk seperti volume dan ABV. Lihat panduan bea cukai untuk mengonfigurasi pengiriman alkohol.

Es kering 

Gunakan DRY_ICE di specialServices saat karton berisi es kering sebagai pendingin. Sediakan dryIceDetail yang tersarang di dalam specialServiceDetails dengan berat es kering dalam karton.

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

Barang berbahaya 

Gunakan DANGEROUS_GOODS di specialServices saat karton berisi bahan berbahaya yang memerlukan penanganan pembawa khusus dan dokumentasi di luar layanan khusus baterai.

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

Untuk panduan terperinci tentang pengiriman bahan berbahaya termasuk pembatasan pembawa, lihat panduan pengiriman hazmat.

Menggabungkan layanan khusus 

Beberapa layanan khusus dapat digabungkan dalam satu karton dengan melewatkan beberapa nilai dalam array specialServices.

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