Special services til forsendelser

Special services tilføjes på karton-niveau, når du opretter en forsendelse via shipmentCreateWorkflow-mutationen. Brug specialServices til at angive typen af særlig håndtering, der kræves, og specialServiceDetails for eventuel yderligere konfiguration, som den service kræver.

Carrier-understøttelse varierer. Bekræft med din carrier, at det valgte serviceniveau understøtter den special service, du har brug for, før du indsender en forsendelse.

Batterier 

Brug BATTERY i specialServices, når en karton indeholder lithium-ion- eller lithium-metal-batterier. Du skal også angive batteryDetail indlejret i specialServiceDetails.

Bemærk: batteryDetail skal være indlejret i specialServiceDetails, ikke sendt direkte på kartonen. At sende det på karton-niveau resulterer i en valideringsfejl.

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

Batterimaterialetyper:

• LITHIUM_ION — Lithium-ion-batteri (genopladeligt)
• LITHIUM_METAL — Lithium-metal-batteri (ikke-genopladeligt)

Batteripakningstyper:

• BATTERY_INSIDE_EQUIPMENT — Batteri er indeholdt i en vare i pakken
• BATTERY_ONLY — Pakken indeholder kun et batteri eller batterier
• BATTERY_PACKAGED_WITH_EQUIPMENT — Batteri er pakket med udstyret, men ikke indeholdt i det

Signaturmuligheder 

Brug SIGNATURE_OPTION i specialServices for at kræve signatur ved levering. Angiv signatureOptionDetail indlejret i specialServiceDetails for at specificere signaturtypen.

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

Signaturmulighedstyper:

• ADULT — Voksen signatur påkrævet (modtager skal være myndig)
• DIRECT — Direkte signatur påkrævet (nogen på adressen skal signere)
• INDIRECT — Indirekte signatur tilladt (nabo eller bygningsadministrator kan signere)
• DEFAULT — Bruger standard signaturadfærd for det valgte serviceniveau
• NONE — Ingen signatur påkrævet

Alkohol 

Alkoholforsendelser håndteres gennem Zonos' excise duties-funktion, som beregner gældende punktafgifter baseret på produktmålinger som volumen og ABV. Se excise duties-guiden for at konfigurere alkoholforsendelser.

Tøris 

Brug DRY_ICE i specialServices, når en karton indeholder tøris som kølemiddel. Angiv dryIceDetail indlejret i specialServiceDetails med vægten af tøris i kartonen.

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

Farligt gods 

Brug DANGEROUS_GOODS i specialServices, når en karton indeholder farlige materialer, der kræver særlig carrier-håndtering og dokumentation ud over batteri special service.

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

For detaljeret vejledning om forsendelse af farlige materialer inklusive begrænsninger pr. carrier, se hazmat shipping-guiden.

Kombinere special services 

Flere special services kan kombineres i en enkelt karton ved at sende flere værdier i specialServices-arrayet.

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