Servizi speciali di spedizione

I servizi speciali vengono aggiunti a livello di cartone quando si crea una spedizione tramite la mutazione shipmentCreateWorkflow. Utilizza specialServices per dichiarare il tipo di movimentazione speciale richiesta e specialServiceDetails per qualsiasi configurazione aggiuntiva richiesta dal servizio.

Il supporto del corriere varia. Verifica con il tuo corriere che il livello di servizio selezionato supporti il servizio speciale di cui hai bisogno prima di inviare una spedizione.

Batterie 

Utilizzare BATTERY in specialServices quando un cartone contiene batterie agli ioni di litio o al litio-metallo. Devi anche fornire batteryDetail annidato all'interno di specialServiceDetails.

Nota: batteryDetail deve essere annidato all'interno di specialServiceDetails, non passato direttamente sul cartone. Passarlo a livello di cartone comporterà un errore di convalida.

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

Tipi di materiale della batteria:

• LITHIUM_ION — Batteria agli ioni di litio (ricaricabile)
• LITHIUM_METAL — Batteria al litio-metallo (non ricaricabile)

Tipi di imballaggio della batteria:

• BATTERY_INSIDE_EQUIPMENT — La batteria è contenuta all'interno di un articolo nella confezione
• BATTERY_ONLY — La confezione contiene solo una o più batterie
• BATTERY_PACKAGED_WITH_EQUIPMENT — La batteria è imballata con l'apparecchiatura ma non è contenuta al suo interno

Opzioni di firma 

Utilizzare SIGNATURE_OPTION in specialServices per richiedere una firma al momento della consegna. Fornire signatureOptionDetail annidato all'interno di specialServiceDetails per specificare il tipo di firma.

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

Tipi di opzioni di firma:

• ADULT — È richiesta la firma di un adulto (il destinatario deve essere maggiorenne)
• DIRECT — È richiesta la firma diretta (qualcuno all'indirizzo deve firmare)
• INDIRECT — È consentita la firma indiretta (può firmare il vicino o l'amministratore dell'edificio)
• DEFAULT — Utilizza il comportamento della firma predefinito per il livello di servizio selezionato
• NONE — Non è richiesta alcuna firma

Alcol 

Le spedizioni di alcolici vengono gestite tramite la funzione accise di Zonos, che calcola le accise applicabili in base alle misurazioni del prodotto come volume e gradazione alcolica. Vedi la guida alle accise per configurare le spedizioni di alcolici.

Ghiaccio secco 

Utilizzare DRY_ICE in specialServices quando un cartone contiene ghiaccio secco come refrigerante. Fornire dryIceDetail annidato all'interno di specialServiceDetails con il peso del ghiaccio secco nel cartone.

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

Merci pericolose 

Utilizzare DANGEROUS_GOODS in specialServices quando un cartone contiene materiali pericolosi che richiedono una gestione e una documentazione speciali da parte del trasportatore oltre al servizio speciale sulla batteria.

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

Per indicazioni dettagliate sulla spedizione di materiali pericolosi, comprese le restrizioni per corriere, consultare la guida alla spedizione di sostanze pericolose.

Combinazione di servizi speciali 

È possibile combinare più servizi speciali in un unico cartone inserendo più valori nell'array specialServices.

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