DHL Express - Cancelar Envio

Descripcion

Este modulo cancela un envio previamente creado en DHL Express. Recibe el numero de envio (shipment ID) y realiza una peticion DELETE al endpoint /shipments/{shipment_id}. Si la cancelacion es exitosa, retorna el ID del envio y el estado CANCELLED.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial DHL Express (provider: dhl_express)
shipment_id	text	Si	Numero de envio 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 basico

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

API Utilizada

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

Notas

Solo se pueden cancelar envios que aun no hayan sido recogidos por DHL
Una vez cancelado, el numero de seguimiento quedara invalidado
La operacion es irreversible