Eliminar plan
DELETE /api/subscriptions/plans/{subscription_plan_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Elimina un plan sin suscripciones junto con sus productos.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Formato de respuesta: estándar {success, data, message?} (registro único). En el éxito data es {id}.
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
subscription_plan_id |
integer | Sí | Id del plan. |
Reglas:
- Si alguna suscripción (en cualquier estado) usa el plan, no se elimina: desactívalo con Desactivar plan.
Errores:
403si el usuario no es administrador.404si el registro no existe.409si el plan tiene suscripciones.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
subscription_plan_id |
ruta | sí | 3 |
Respuestas
200 — Eliminado
{
"success": true,
"data": {
"id": 3
},
"message": "Plan eliminado con éxito"
}
409 — Con suscripciones
{
"success": false,
"message": "El plan tiene 24 suscripciones y no se puede eliminar. Desactívalo en su lugar."
}
403 — Usuario no administrador
{
"success": false,
"message": "Solo un administrador puede gestionar este recurso."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.