*API REST › Errores*

# `addon_required`

> HTTP HTTP 402.

Estado HTTP: `402` · Tipo del problema: `https://docs.filmo.io/errors/addon_required`

## Cuándo ocurre

402. La cuenta no ha contratado (o ha dejado caducar) el add-on al que pertenece la operación, que se nombra en `requiredAddon`. Ningún rol ni scope lo evita. Se responde por recurso: el CRM, el mantenimiento y las incidencias (el add-on de incidencias), las compras y los campos personalizados necesitan cada uno su propio add-on, y [`POST /api/v1/ai/ask`](https://docs.filmo.io/es/rest-api/endpoint-reference/ai/ask-the-ai-about-your-data) lo responde cuando la cuenta se queda sin créditos de IA. Las operaciones que no necesitan ningún add-on no se ven afectadas.

## Qué hacer

Un administrador añade al plan el add-on nombrado en `requiredAddon`, o dejas de llamar a las operaciones de ese módulo. No cambies la clave ni sus scopes.

## Reintento

| Condición | Qué hacer | Nota |
| --- | --- | --- |
| 401 · 402 · 403 (clave, propietario o plan) | Parar | No reintentes: reenviar la misma petición vuelve a fallar. Actúa sobre la clave, su propietario o el plan: usa una clave válida con el permiso adecuado, pide a un administrador el permiso que falta o contrata el add-on. |

## Campos de errors[]

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `requiredAddon` | string | En `addon_required`: el id del add-on que necesita el plan de la cuenta (los ids que `GET /account` lista en `addons`). `qr-codes`, `incidence`, `purchases`, `activity-log`, `custom-fields`, `profitability`, `web-builder`, `crm`, `consignments`, `email-calendar`, `sales-documents`, `internal-bookings`, `internal-communication`, `advanced-user-permissions` |

## Ejemplo

*addon_required*

```json
{
  "type": "https://docs.filmo.io/errors/addon_required",
  "title": "Add-on required",
  "status": 402,
  "code": "addon_required",
  "detail": "Your plan does not include the add-on this operation requires",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "requiredAddon": "incidence"
}
```

## Lo devuelven

- [`GET /api/v1/repair-tickets`](https://docs.filmo.io/es/rest-api/endpoint-reference/repair-tickets/list-repair-tickets) — Listar tickets de reparación
- [`POST /api/v1/repair-tickets`](https://docs.filmo.io/es/rest-api/endpoint-reference/repair-tickets/create-a-repair-ticket) — Crear un parte de reparación
- [`GET /api/v1/repair-tickets/{ticketId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/repair-tickets/get-a-repair-ticket) — Obtener un ticket de reparación
- [`PATCH /api/v1/repair-tickets/{ticketId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/repair-tickets/update-a-repair-ticket) — Actualizar un ticket de reparación
- [`PATCH /api/v1/subrents/{subrentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/update-a-subrent) — Actualizar un subalquiler
- [`GET /api/v1/purchase-orders`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/list-purchase-orders) — Listar pedidos de compra
- [`GET /api/v1/purchase-orders/{purchaseOrderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/get-a-purchase-order) — Obtener una orden de compra
- [`PATCH /api/v1/purchase-orders/{purchaseOrderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/update-a-purchase-order) — Actualizar una orden de compra
- [`GET /api/v1/custom-fields`](https://docs.filmo.io/es/rest-api/endpoint-reference/custom-fields/list-custom-field-definitions) — Listar definiciones de campos personalizados
- [`GET /api/v1/incidents`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/list-incidents) — Listar incidencias
- [`POST /api/v1/incidents`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/open-an-incident) — Abrir una incidencia
- [`GET /api/v1/incidents/{incidentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/get-an-incident) — Obtener una incidencia
- [`PATCH /api/v1/incidents/{incidentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/update-an-incident) — Actualizar una incidencia
- [`GET /api/v1/incidents/status-counts`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/count-incidents-by-status) — Contar incidencias por estado
- [`POST /api/v1/incidents/{incidentId}/comments`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/comment-on-an-incident) — Comentar una incidencia
- [`GET /api/v1/crm/opportunities`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/list-opportunities) — Listar oportunidades
- [`POST /api/v1/crm/opportunities`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/create-an-opportunity) — Crear una oportunidad
- [`GET /api/v1/crm/opportunities/{opportunityId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/get-an-opportunity) — Obtener una oportunidad
- [`PATCH /api/v1/crm/opportunities/{opportunityId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/update-an-opportunity) — Actualizar una oportunidad
- [`PATCH /api/v1/crm/opportunities/{opportunityId}/stage`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/move-an-opportunity-to-another-stage) — Mover una oportunidad a otra etapa
- [`POST /api/v1/crm/opportunities/{opportunityId}/close`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/close-an-opportunity) — Cerrar una oportunidad
- [`POST /api/v1/crm/opportunities/{opportunityId}/links`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/link-a-document-to-an-opportunity) — Vincular un documento a una oportunidad
- [`GET /api/v1/crm/pipelines`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/list-pipelines) — Listar embudos
- [`GET /api/v1/crm/pipelines/{pipelineId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/get-a-pipeline) — Obtener un embudo
- [`POST /api/v1/purchase-orders/{purchaseOrderId}/approve`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/approve-a-purchase-order) — Aprobar un pedido de compra
- [`POST /api/v1/purchase-orders/{purchaseOrderId}/receive`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/receive-material-from-a-purchase-order) — Recibir material de un pedido de compra
- [`GET /api/v1/supplier-invoices`](https://docs.filmo.io/es/rest-api/endpoint-reference/supplier-invoices/list-supplier-invoices) — Listar facturas de proveedor
- [`GET /api/v1/supplier-invoices/{supplierInvoiceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/supplier-invoices/get-a-supplier-invoice) — Obtener una factura de proveedor
- [`POST /api/v1/ai/ask`](https://docs.filmo.io/es/rest-api/endpoint-reference/ai/ask-the-ai-about-your-data) — Preguntar a la IA sobre tus datos
- [`POST /api/v1/invoices/{invoiceId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/validate-an-invoice) — Validar una factura
- [`PUT /api/v1/invoices/external/{originSystem}/{originExternalId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/create-or-update-the-mirror-of-an-externally-issued-invoice) — Crear o actualizar el espejo de una factura emitida externamente
- [`PATCH /api/v1/proformas/{proformaId}/status`](https://docs.filmo.io/es/rest-api/endpoint-reference/proformas/change-the-commercial-status-of-a-proforma) — Cambiar el estado comercial de una proforma
- [`PATCH /api/v1/quotes/{quoteId}/status`](https://docs.filmo.io/es/rest-api/endpoint-reference/quotes/change-the-commercial-status-of-a-quote) — Cambiar el estado comercial de un presupuesto
- [`POST /api/v1/contracts/{contractId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/validate-a-contract) — Validar un contrato
- [`POST /api/v1/contracts/{contractId}/sign`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/record-the-signature-of-a-contract) — Registrar la firma de un contrato
- [`POST /api/v1/supplier-invoices/{supplierInvoiceId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/supplier-invoices/validate-a-supplier-invoice) — Validar una factura de proveedor
- [`POST /api/v1/supplier-invoices/{supplierInvoiceId}/void`](https://docs.filmo.io/es/rest-api/endpoint-reference/supplier-invoices/void-a-supplier-invoice) — Anular una factura de proveedor

## Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

---

URL canónica: https://docs.filmo.io/es/rest-api/errors/addon_required  
Última actualización: 2026-10-25