Activar plan de gasto

PUT /v1/spending-plans/{id}/activate

Activa un plan de gasto creado previamente. Es el paso que habilita el medio de pago: activa la tarjeta y habilita el retiro en cajero, o registra la entrega de efectivo en mano.

Los planes se crean en estado NOT_STARTED (ver Crear un plan de gasto) y permanecen inactivos hasta que los activas con esta llamada.

Parámetros

Parámetro	En	Tipo	Descripción
id	ruta	string (UUID)	Identificador del plan de gasto a activar.

No lleva cuerpo.

¿No tienes el id?

Búscalo con GET /v1/spending-plans?trip_id=<tu_id> usando el identificador de viaje que enviaste al crear el plan.

Ejemplo

curl -X PUT \
  https://api.sandbox.partner.uvicuo.com/v1/spending-plans/3f7c1e90-2b8a-4c5d-9e10-aa11bb22cc33/activate \
  -H "X-API-Key: $UVICUO_API_KEY"

Respuesta

200 OK — devuelve el plan de gasto actualizado. Revisa su estado resultante:

Estado	Significado
ACTIVE	El plan quedó activo y el medio de pago habilitado. Es el caso normal.
IN_FULFILLMENT	El plan usa efectivo en mano (cash_dispersion_method: CASH_ON_HAND): queda pendiente de confirmar la entrega antes de pasar a ACTIVE.

Planes con efectivo en mano

La confirmación de entrega de efectivo (confirm-cash-delivery) todavía no está expuesta en esta API (roadmap), así que un plan CASH_ON_HAND permanece en IN_FULFILLMENT. Como los gastos de emergencia requieren un plan ACTIVE, no se pueden agregar mientras el plan esté en IN_FULFILLMENT.

Errores comunes

Situación	HTTP	code	Cómo evitarlo
Ya existe un plan ACTIVO para ese empleado (“An ACTIVE spending plan already exists for employee…“).	409	downstream_error	Un empleado solo puede tener un plan activo a la vez: termina/espera el anterior.
El plan no puede activarse en su estado actual (ya activo, terminado, etc.).	409	downstream_error	Verifica el estado con Listar planes antes de activar.
El vehículo no tiene TAG y el presupuesto lo requiere (VEHICLE_HAS_NO_TAG).	422	downstream_error	Revisa tag_status en Vehículos; asigna un TAG activo al vehículo.
No existe un plan con ese id.	404	not_found	Usa un id válido (búscalo por tu trip_id).
El id de la ruta no es un UUID válido.	400	validation_error	—

El detalle exacto del rechazo viene en error.details. Ver Errores para el formato completo.