UPS - Cancelar Envío

Descripción

Este modulo cancela un envío previamente creado en UPS. Recibe el número de identificación del envío (Shipment Identification Number) y realiza una petición DELETE al endpoint /api/shipments/v1/shipments/cancel. Si la cancelación es exitosa, retorna el número de envío, el estado de la respuesta del VoidShipmentResponse y un mensaje de confirmación.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial UPS (provider: ups)
shipment_identification_number	text	Si	Número de identificación del envío a cancelar

Credenciales

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

client_id: Client ID de la API de UPS
client_secret: Client Secret de la API de UPS

Salida

{
  "success": true,
  "shipment_identification_number": "1Z999AA10123456784",
  "status": "CANCELLED",
  "message": "Envio UPS 1Z999AA10123456784 cancelado exitosamente"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_ups",
  "shipment_identification_number": "1Z999AA10123456784"
}

API Utilizada

Endpoint: DELETE /api/shipments/v1/shipments/cancel
Base: UPS API (via helper _upsHelper)
Documentación: https://developer.ups.com/api/reference

Notas

Solo se pueden cancelar envíos que aun no hayan sido recogidos por UPS
El estado se obtiene de VoidShipmentResponse.Status.Description
La operación es irreversible una vez completada