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 nested in specialServiceDetails opgeven.

Opmerking: batteryDetail moet nested 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 nested 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 excise duties-functie van Zonos, die toepasselijke accijns berekent op basis van productmetingen zoals volume en ABV. Zie de excise duties-gids om alcoholzendingen te configureren.

Droog ijs 

Gebruik DRY_ICE in specialServices wanneer een carton droog ijs als koelmiddel bevat. Geef dryIceDetail nested in specialServiceDetails op met het gewicht 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 shipping guide.

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"
      }
    }
  }
]