DHL Express - Cancelar Envío

Descripción

Este modulo cancela un envío previamente creado en DHL Express. Recibe el número de envío (shipment ID) y realiza una petición DELETE al endpoint /shipments/{shipment_id}. Si la cancelación es exitosa, retorna el ID del envío y el estado CANCELLED.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
shipment_id	text	Si	Número de envío a cancelar

Credenciales

Se requiere una credencial de tipo dhl_express con los siguientes campos:

api_key: API Key de DHL Express

Las credenciales se obtienen desde el portal de desarrolladores de DHL (https://developer.dhl.com/).

Salida

{
  "success": true,
  "shipment_id": "1234567890",
  "status": "CANCELLED",
  "message": "Envio DHL 1234567890 cancelado exitosamente"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_dhl",
  "shipment_id": "1234567890"
}

API Utilizada

Endpoint: DELETE /shipments/{shipment_id}
Base: DHL Express API (via helper _dhlHelper)
Documentación: https://developer.dhl.com/api-reference/dhl-express-mydhl-api

Notas

Solo se pueden cancelar envíos que aun no hayan sido recogidos por DHL
Una vez cancelado, el número de seguimiento quedará invalidado
La operación es irreversible