Special services voor zendingen

Special services worden op cartonniveau toegevoegd bij het aanmaken van een zending via de shipmentCreateWorkflow-mutatie. Gebruik specialServices om het type speciale afhandeling te declareren en specialServiceDetails voor extra configuratie die die service vereist.

Carrierondersteuning varieert. Bevestig bij uw carrier dat het geselecteerde servicelevel de benodigde special service ondersteunt voordat u een zending indient.

Batterijen 

Gebruik BATTERY in specialServices wanneer een carton lithium-ion- of lithium-metaalbatterijen bevat. U moet ook batteryDetail genest in specialServiceDetails opgeven.

Opmerking: batteryDetail moet genest in specialServiceDetails staan, niet direct op het carton. Door het op cartonniveau door te geven krijgt u een validatiefout.

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

Batterijmateriaaltypen:

• LITHIUM_ION — Lithium-ionbatterij (oplaadbaar)
• LITHIUM_METAL — Lithium-metaalbatterij (niet oplaadbaar)

Batterijverpakkingstypen:

• BATTERY_INSIDE_EQUIPMENT — Batterij zit in een item in het pakket
• BATTERY_ONLY — Het pakket bevat alleen een batterij of batterijen
• BATTERY_PACKAGED_WITH_EQUIPMENT — Batterij is verpakt met apparatuur maar niet erin

Handtekeningopties 

Gebruik SIGNATURE_OPTION in specialServices om een handtekening bij aflevering te vereisen. Geef signatureOptionDetail genest in specialServiceDetails op om het handtekeningtype te specificeren.

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

Handtekeningoptietypen:

• ADULT — Handtekening van volwassene vereist (ontvanger moet meerderjarig zijn)
• DIRECT — Directe handtekening vereist (iemand op het adres moet tekenen)
• INDIRECT — Indirecte handtekening toegestaan (buur of gebouwbeheerder mag tekenen)
• DEFAULT — Gebruikt het standaard handtekeninggedrag voor het geselecteerde servicelevel
• NONE — Geen handtekening vereist

Alcohol 

Alcoholzendingen worden afgehandeld via de accijnsfunctie van Zonos, die de toepasselijke accijns berekent op basis van productmetingen zoals volume en ABV. Zie de accijnsgids om alcoholzendingen te configureren.

Droog ijs 

Gebruik DRY_ICE in specialServices wanneer een carton droog ijs als koelmiddel bevat. Geef dryIceDetail genest in specialServiceDetails op, met het gewicht van het droog ijs in het carton.

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

Gevaarlijke goederen 

Gebruik DANGEROUS_GOODS in specialServices wanneer een carton gevaarlijke stoffen bevat die speciale carrierafhandeling en documentatie vereisen, naast de batterij-special service.

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

Voor gedetailleerde richtlijnen over het verzenden van gevaarlijke stoffen, inclusief beperkingen per carrier, zie de HAZMAT-verzendgids.

Special services combineren 

Meerdere special services kunnen in één carton worden gecombineerd door meerdere waarden in de specialServices-array door te geven.

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