Services spéciaux d'envoi

Les services spéciaux sont ajoutés au niveau du colis lors de la création d'un envoi via la mutation shipmentCreateWorkflow. Utilisez specialServices pour déclarer le type de manutention spéciale requis, et specialServiceDetails pour toute configuration supplémentaire que ce service nécessite.

La prise en charge varie selon le transporteur. Confirmez auprès de votre transporteur que le niveau de service sélectionné prend en charge le service spécial dont vous avez besoin avant de soumettre un envoi.

Batteries 

Utilisez BATTERY dans specialServices lorsqu'un colis contient des batteries lithium-ion ou lithium-métal. Vous devez également fournir batteryDetail imbriqué dans specialServiceDetails.

Note : batteryDetail doit être imbriqué dans specialServiceDetails, et non transmis directement au niveau du colis. Le transmettre au niveau du colis entraînera une erreur de validation.

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

Types de matériaux de batterie :

• LITHIUM_ION — Batterie lithium-ion (rechargeable)
• LITHIUM_METAL — Batterie lithium-métal (non rechargeable)

Types d'emballage de batterie :

• BATTERY_INSIDE_EQUIPMENT — La batterie est contenue à l'intérieur d'un article dans le colis
• BATTERY_ONLY — Le colis ne contient qu'une batterie ou des batteries
• BATTERY_PACKAGED_WITH_EQUIPMENT — La batterie est emballée avec l'équipement mais non contenue à l'intérieur

Options de signature 

Utilisez SIGNATURE_OPTION dans specialServices pour exiger une signature à la livraison. Fournissez signatureOptionDetail imbriqué dans specialServiceDetails pour spécifier le type de signature.

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

Types d'options de signature :

• ADULT — Signature adulte requise (le destinataire doit être majeur)
• DIRECT — Signature directe requise (une personne à l'adresse doit signer)
• INDIRECT — Signature indirecte autorisée (un voisin ou le gardien de l'immeuble peut signer)
• DEFAULT — Utilise le comportement de signature par défaut pour le niveau de service sélectionné
• NONE — Aucune signature requise

Alcool 

Les envois d'alcool sont gérés via la fonctionnalité de droits d'accise de Zonos, qui calcule les taxes d'accise applicables en fonction de mesures de produit comme le volume et le degré d'alcool. Consultez le guide des droits d'accise pour configurer les envois d'alcool.

Glace carbonique 

Utilisez DRY_ICE dans specialServices lorsqu'un colis contient de la glace carbonique comme réfrigérant. Fournissez dryIceDetail imbriqué dans specialServiceDetails avec le poids de glace carbonique dans le colis.

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

Marchandises dangereuses 

Utilisez DANGEROUS_GOODS dans specialServices lorsqu'un colis contient des matières dangereuses nécessitant une manutention et une documentation spéciales du transporteur au-delà du service spécial batterie.

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

Pour des conseils détaillés sur l'expédition de matières dangereuses, y compris les restrictions par transporteur, consultez le guide d'expédition de matières dangereuses.

Combiner des services spéciaux 

Plusieurs services spéciaux peuvent être combinés dans un seul colis en passant plusieurs valeurs dans le tableau specialServices.

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