Tope de automatizaciones activas

30 de septiembre de 2026

Qué cambia

El plan fija un tope de automatizaciones activas de la empresa. Activar un borrador o reanudar una regla pausada comprueba ese tope antes de guardar. El presupuesto mensual de ejecuciones sigue separado: no se comprueba al activar, sino al admitir una ejecución.

Los borradores y las reglas pausadas o eliminadas no cuentan. Las reglas ya activas por encima del tope siguen ejecutándose y se pueden editar o pausar; este límite no las pausa automáticamente. Pausa una regla activa con POST /v1/automations/rules/{rule}/pause para liberar una plaza, o amplía el plan antes de volver a intentar la activación.

Operaciones afectadas y tools MCP

Son cambios en operaciones y tools existentes. Sus URLs, nombres, campos del request y scopes siguen iguales.

Consulta ambos límites antes de activar

GET /v1/automations/usage y get_automation_usage añaden active_rules: {count, limit} al objeto de consumo. count es el número actual de reglas activas y no eliminadas de la empresa. limit es el tope del plan: cero no permite activar; null significa que no hay un techo automático. La capacidad de Enterprise se acuerda según contrato. La v1 pública y MCP no exponen limit_mode.

Este es un fragmento de la respuesta. Los campos mensuales existentes — consumed, limit, reset_at, period y threshold_percent — conservan su contrato:

{
  "data": {
    "active_rules": { "count": 7, "limit": 7 }
  }
}

Gestiona el rechazo de activación

Con un tope fijo, count >= limit rechaza la activación con HTTP 402, error.type: payment_required_error y error.code: automation_active_rules_limit_exceeded. Decide según el código estable; error.message es texto en español para personas. details.active_rules del error es el recuento actual y details.limit es el tope:

{
  "error": {
    "type": "payment_required_error",
    "code": "automation_active_rules_limit_exceeded",
    "message": "Tu plan permite 7 automatizaciones activas y ya tienes 7. Pausa alguna de las activas o amplía el plan para activar esta.",
    "param": null,
    "details": { "active_rules": 7, "limit": 7 },
    "doc_url": "https://docs.factuarea.com/guides/errors#automation_active_rules_limit_exceeded",
    "request_id": "req_01HKQS5NACTIVERULECAP01"
  }
}

MCP activate_automation_rule devuelve JSON-RPC -32008 con message: automation_active_rules_limit_exceeded, data.code igual a ese código, data.http_status: 402 y data.details: {active_rules, limit}. La app usa HTTP 422 con el mismo código. Las transiciones no válidas de una regla conservan su error nativo y tienen prioridad sobre el tope.

Los reintentos inmediatos no liberan una plaza. Pausa una regla activa o amplía el plan y vuelve a consultar el consumo. El rechazo no activa la regla ni pausa otra.

Documentación relacionada