Servicios especiales de envío

Los servicios especiales se agregan a nivel de cartón al crear un envío mediante la mutación shipmentCreateWorkflow. Utilice specialServices para declarar el tipo de manipulación especial requerida y specialServiceDetails para cualquier configuración adicional que ese servicio requiera.

La compatibilidad con transportistas varía. Confirme con su transportista que el nivel de servicio seleccionado admite el servicio especial que necesita antes de enviar un envío.

Baterías 

Utilice BATTERY en specialServices cuando un cartón contenga baterías de iones de litio o de litio metálico. También debe proporcionar batteryDetail anidado dentro de specialServiceDetails.

Nota: batteryDetail debe estar anidado dentro de specialServiceDetails, no pasarse directamente en el cartón. Pasarlo a nivel de cartón provocará un error de validación.

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

Tipos de material de batería:

• LITHIUM_ION — Batería de iones de litio (recargable)
• LITHIUM_METAL — Batería de litio metálico (no recargable)

Tipos de embalaje de batería:

• BATTERY_INSIDE_EQUIPMENT — La batería está contenida dentro de un artículo del paquete
• BATTERY_ONLY — El paquete contiene solo una batería o baterías
• BATTERY_PACKAGED_WITH_EQUIPMENT — La batería está empaquetada con el equipo pero no contenida dentro de él

Opciones de firma 

Utilice SIGNATURE_OPTION en specialServices para requerir una firma al momento de la entrega. Proporcione signatureOptionDetail anidado dentro de specialServiceDetails para especificar el tipo de firma.

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

Tipos de opción de firma:

• ADULT — Se requiere firma de adulto (el destinatario debe ser mayor de edad)
• DIRECT — Se requiere firma directa (alguien en la dirección debe firmar)
• INDIRECT — Se permite firma indirecta (un vecino o el administrador del edificio puede firmar)
• DEFAULT — Utiliza el comportamiento de firma predeterminado para el nivel de servicio seleccionado
• NONE — No se requiere firma

Alcohol 

Los envíos de alcohol se gestionan mediante la función de aranceles especiales de Zonos, que calcula los impuestos especiales aplicables según mediciones del producto como volumen y ABV. Consulte la guía de aranceles especiales para configurar envíos de alcohol.

Hielo seco 

Utilice DRY_ICE en specialServices cuando un cartón contenga hielo seco como refrigerante. Proporcione dryIceDetail anidado dentro de specialServiceDetails con el peso del hielo seco en el cartón.

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

Mercancías peligrosas 

Utilice DANGEROUS_GOODS en specialServices cuando un cartón contenga materiales peligrosos que requieran manipulación y documentación especiales del transportista, más allá del servicio especial de batería.

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

Para orientación detallada sobre el envío de materiales peligrosos, incluidas las restricciones por transportista, consulte la guía de envío de materiales peligrosos.

Combinación de servicios especiales 

Se pueden combinar varios servicios especiales en un solo cartón pasando múltiples valores en el array specialServices.

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