Specjalne usługi przesyłki

Usługi specjalne są dodawane na poziomie kartonu podczas tworzenia przesyłki za pośrednictwem mutacji shipmentCreateWorkflow. Użyj specialServices do deklaracji typu wymaganej specjalnej obsługi oraz specialServiceDetails dla dowolnej dodatkowej konfiguracji wymaganej przez tę usługę.

Wsparcie przewoźnika jest różne. Potwierdź ze swoim przewoźnikiem, że wybrany poziom usług obsługuje specjalną usługę, której potrzebujesz, przed przesłaniem przesyłki.

Baterie 

Użyj BATTERY w specialServices, gdy karton zawiera baterie litowo-jonowe lub litowo-metaliczne. Musisz również podać batteryDetail zagnieżdżony wewnątrz specialServiceDetails.

Uwaga: batteryDetail musi być zagnieżdżony wewnątrz specialServiceDetails, a nie przekazywany bezpośrednio na kartonie. Przekazanie go na poziomie kartonu spowoduje błąd walidacji.

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

Typy materiałów baterii:

• LITHIUM_ION — Bateria litowo-jonowa (akumulator)
• LITHIUM_METAL — Bateria litowo-metaliczna (nienadająca się do ładowania)

Typy opakowań baterii:

• BATTERY_INSIDE_EQUIPMENT — Bateria znajduje się wewnątrz przedmiotu w paczce
• BATTERY_ONLY — Paczka zawiera tylko baterię lub baterie
• BATTERY_PACKAGED_WITH_EQUIPMENT — Bateria jest pakowana z urządzeniem, ale nie zawarta w jego wnętrzu

Opcje podpisu 

Użyj SIGNATURE_OPTION w specialServices, aby wymagać podpisu przy dostarczeniu. Podaj signatureOptionDetail zagnieżdżony wewnątrz specialServiceDetails, aby określić typ podpisu.

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

Typy opcji podpisu:

• ADULT — Wymagany podpis osoby dorosłej (odbiorca musi być pełnoletni)
• DIRECT — Wymagany bezpośredni podpis (ktoś na adresie musi się podpisać)
• INDIRECT — Dozwolony pośredni podpis (sąsiad lub zarządca budynku może się podpisać)
• DEFAULT — Używa domyślnego zachowania podpisu dla wybranego poziomu usług
• NONE — Brak wymogu podpisu

Alkohol 

Przesyłki zawierające alkohol są obsługiwane za pośrednictwem funkcji podatków akcyzowych Zonos, która oblicza mające zastosowanie podatki akcyzowe na podstawie pomiarów produktu, takich jak objętość i zawartość alkoholu. Zapoznaj się z przewodnikiem podatków akcyzowych, aby skonfigurować przesyłki zawierające alkohol.

Suchy lód 

Użyj DRY_ICE w specialServices, gdy karton zawiera suchy lód jako chłodnicę. Podaj dryIceDetail zagnieżdżony wewnątrz specialServiceDetails wraz z wagą suchego lodu w kartonie.

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

Towary niebezpieczne 

Użyj DANGEROUS_GOODS w specialServices, gdy karton zawiera materiały niebezpieczne wymagające specjalnej obsługi przewoźnika i dokumentacji poza usługą specjalną dotyczącą baterii.

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

Aby uzyskać szczegółowe wskazówki dotyczące wysyłki materiałów niebezpiecznych, w tym ograniczeń dla poszczególnych przewoźników, zapoznaj się z przewodnikiem wysyłki hazmat.

Łączenie usług specjalnych 

Wiele usług specjalnych można połączyć w jednym kartonie, podając wiele wartości w tablicy specialServices.

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