DOCS

Specjalne usługi

Specjalne usługi przesyłki

Konfiguruj specjalne wymagania obsługi dla przesyłek zawierających baterie, suchy lód, towary niebezpieczne lub wymagające podpisu.

GraphQL

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órą 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 weryfikacji.

Przykład przesyłki z bateriami

"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.

Przykład opcji 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.

Przykład przesyłki z suchym lodem

"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.

Przykład towarów niebezpiecznych

"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.

Przykład wielu usług specjalnych

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

Czy ta strona była pomocna?