Límit d'automatitzacions actives

30 de setembre de 2026

Què canvia

El pla fixa un límit d'automatitzacions actives de l'empresa. Activar un esborrany o reprendre una regla pausada comprova aquest límit abans de desar. El pressupost mensual d'execucions continua separat: no es comprova en activar, sinó en admetre una execució.

Els esborranys i les regles pausades o eliminades no compten. Les regles ja actives per sobre del límit es continuen executant i es poden editar o pausar; aquest límit no les pausa automàticament. Pausa una regla activa amb POST /v1/automations/rules/{rule}/pause per alliberar una plaça, o amplia el pla abans de tornar a intentar l'activació.

Operacions afectades i tools MCP

Són canvis en operacions i tools existents. Les seves URLs, noms, camps del request i scopes continuen iguals.

Consulta tots dos límits abans d'activar

GET /v1/automations/usage i get_automation_usage afegeixen active_rules: {count, limit} a l'objecte de consum. count és el nombre actual de regles actives i no eliminades de l'empresa. limit és el límit del pla: zero no permet activar; null vol dir que no hi ha un sostre automàtic. La capacitat d'Enterprise s'acorda segons contracte. La v1 pública i MCP no exposen limit_mode.

Aquest és un fragment de la resposta. Els camps mensuals existents — consumed, limit, reset_at, period i threshold_percent — conserven el seu contracte:

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

Gestiona el rebuig d'activació

Amb un límit fix, count >= limit rebutja l'activació amb HTTP 402, error.type: payment_required_error i error.code: automation_active_rules_limit_exceeded. Decideix segons el codi estable; error.message és text en castellà per a persones. details.active_rules de l'error és el recompte actual i details.limit és el límit:

{
  "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 retorna JSON-RPC -32008 amb message: automation_active_rules_limit_exceeded, data.code igual a aquest codi, data.http_status: 402 i data.details: {active_rules, limit}. L'app fa servir HTTP 422 amb el mateix codi. Les transicions no vàlides d'una regla conserven el seu error natiu i tenen prioritat sobre el límit.

Els reintents immediats no alliberen una plaça. Pausa una regla activa o amplia el pla i torna a consultar el consum. El rebuig no activa la regla ni en pausa una altra.

Documentació relacionada