*Visión general › Conceptos básicos*

# Planes y add-ons

> La API y el MCP están incluidos en cualquier plan de pago; no son un add-on. El acceso necesita un administrador y que Filmo haya activado la API para tu entorno; algunos módulos necesitan su add-on. Llama a `GET /api/v1/account` para ver qué add-ons tiene hoy la cuenta.

## Acceso a la API y MCP

La API y el servidor MCP están incluidos en cualquier plan de pago y no son un add-on: la API no comprueba el plan ni ningún add-on para dejar entrar a una clave. El acceso necesita dos cosas: que Filmo haya activado la API y el MCP para el entorno en el que vive tu cuenta (un interruptor del lado de Filmo, no un ajuste de la cuenta) y que un administrador cree la clave o apruebe la conexión OAuth. Los límites de peticiones son los mismos para todos los planes. Los módulos que tienen un add-on lo conservan, como explica el apartado siguiente. El centro de ayuda trata la suscripción en [Tu suscripción](https://www.filmo.io/es/help/reference/cuenta-y-ajustes/tu-suscripcion-a-filmo/tu-suscripcion).

## Add-ons

Algunos módulos están tras un add-on. Si la cuenta no lo ha contratado, o lo ha dejado caducar, una operación de ese módulo responde 402 [`addon_required`](https://docs.filmo.io/es/rest-api/errors/addon_required) y `requiredAddon` nombra el add-on. Es un 402 y no un 403 porque se trata del add-on, no de los permisos. La respuesta es por recurso: la misma clave puede llamar a otros recursos de la cuenta sin ningún add-on.

| Add-on | Abre |
| --- | --- |
| `crm` | Oportunidades y embudos |
| `incidence` | Incidencias y tickets de reparación |
| `purchases` | Órdenes de compra, facturas de proveedor y actualizaciones de subalquileres |
| `custom-fields` | Definiciones de campos personalizados |
| Crédito de IA | `POST /api/v1/ai/ask`. Sin cuota responde 402 |

Esa tabla nombra los principales add-ons. Los ids salen de un catálogo cerrado: [`addons`](https://docs.filmo.io/es/rest-api/objects/account#response-addons) lista los que tiene la cuenta, y cada operación que puede responder 402 nombra su add-on en la extensión `x-required-addon` de la especificación. Algunas operaciones ajenas a esos módulos también pueden responder 402.

## Qué operaciones pueden responder 402

La lista se genera a partir de las respuestas 402 que declara la especificación. Cada operación de la lista indica su add-on.

| Operación | Permiso |
| --- | --- |
| `GET /api/v1/repair-tickets` | `repair-tickets:read` |
| `POST /api/v1/repair-tickets` | `repair-tickets:write` |
| `GET /api/v1/repair-tickets/{ticketId}` | `repair-tickets:read` |
| `PATCH /api/v1/repair-tickets/{ticketId}` | `repair-tickets:write` |
| `PATCH /api/v1/subrents/{subrentId}` | `subrents:write` |
| `GET /api/v1/purchase-orders` | `purchase-orders:read` |
| `GET /api/v1/purchase-orders/{purchaseOrderId}` | `purchase-orders:read` |
| `PATCH /api/v1/purchase-orders/{purchaseOrderId}` | `purchase-orders:write` |
| `GET /api/v1/custom-fields` | `custom-fields:read` |
| `GET /api/v1/incidents` | `incidents:read` |
| `POST /api/v1/incidents` | `incidents:write` |
| `GET /api/v1/incidents/{incidentId}` | `incidents:read` |
| `PATCH /api/v1/incidents/{incidentId}` | `incidents:write` |
| `GET /api/v1/incidents/status-counts` | `incidents:read` |
| `POST /api/v1/incidents/{incidentId}/comments` | `incidents:write` |
| `GET /api/v1/crm/opportunities` | `crm:read` |
| `POST /api/v1/crm/opportunities` | `crm:write` |
| `GET /api/v1/crm/opportunities/{opportunityId}` | `crm:read` |
| `PATCH /api/v1/crm/opportunities/{opportunityId}` | `crm:write` |
| `PATCH /api/v1/crm/opportunities/{opportunityId}/stage` | `crm:write` |
| `POST /api/v1/crm/opportunities/{opportunityId}/close` | `crm:write` |
| `POST /api/v1/crm/opportunities/{opportunityId}/links` | `crm:write` |
| `GET /api/v1/crm/pipelines` | `crm:read` |
| `GET /api/v1/crm/pipelines/{pipelineId}` | `crm:read` |
| `POST /api/v1/purchase-orders/{purchaseOrderId}/approve` | `purchase-orders:write` |
| `POST /api/v1/purchase-orders/{purchaseOrderId}/receive` | `purchase-orders:write` |
| `GET /api/v1/supplier-invoices` | `supplier-invoices:read` |
| `GET /api/v1/supplier-invoices/{supplierInvoiceId}` | `supplier-invoices:read` |
| `POST /api/v1/ai/ask` | `ai:ask` |
| `POST /api/v1/invoices/{invoiceId}/validate` | `invoices:write` |
| `PUT /api/v1/invoices/external/{originSystem}/{originExternalId}` | `invoices:write` |
| `PATCH /api/v1/proformas/{proformaId}/status` | `invoices:write` |
| `PATCH /api/v1/quotes/{quoteId}/status` | `quotes:write` |
| `POST /api/v1/contracts/{contractId}/validate` | `contracts:write` |
| `POST /api/v1/contracts/{contractId}/sign` | `contracts:write` |
| `POST /api/v1/supplier-invoices/{supplierInvoiceId}/validate` | `supplier-invoices:write` |
| `POST /api/v1/supplier-invoices/{supplierInvoiceId}/void` | `supplier-invoices:write` |

## Consúltalos en tu cuenta

[`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) devuelve [`addons`](https://docs.filmo.io/es/rest-api/objects/account#response-addons), los add-ons a los que la cuenta tiene acceso hoy. Léelo al arrancar y antes de llamar a un recurso que esté detrás de un add-on. El servidor MCP lista solo las herramientas que la clave puede llamar.

## Prueba gratuita

Una prueba gratuita dura 14 días y no necesita tarjeta. Durante ella un administrador puede crear claves y conectar OAuth y MCP, como en cualquier cuenta, así que sirve para probar la API. [`trial`](https://docs.filmo.io/es/rest-api/objects/account#response-trial) tiene `active`, true mientras dura la prueba, y `endsAt`. Mientras una prueba está activa todos los add-ons están desbloqueados, así que lo que construyas durante ella puede empezar a responder 402 después.

- Cuando termina la prueba, las claves y las conexiones OAuth no se revocan, y la autenticación no mira la prueba. Los endpoints que dependen de un add-on responden 402 [`addon_required`](https://docs.filmo.io/es/rest-api/errors/addon_required); los endpoints que no necesitan add-on siguen funcionando.
- Validar una factura o una nota de crédito en una cuenta de prueba consume números de su numeración. Valida solo lo que necesite una prueba.
- Filmo purga los datos de una cuenta cuya prueba terminó y que no se ha convertido en una suscripción de pago unos 30 días después del final.
- Lee [`addons`](https://docs.filmo.io/es/rest-api/objects/account#response-addons) en la cuenta que vayas a usar en producción, no solo en la de prueba, y gestiona [`addon_required`](https://docs.filmo.io/es/rest-api/errors/addon_required) de forma explícita.

La guía de pruebas está en [Pruebas](https://docs.filmo.io/es/rest-api/guides/testing), y el centro de ayuda trata la facturación en [Tu suscripción](https://www.filmo.io/es/help/reference/cuenta-y-ajustes/tu-suscripcion-a-filmo/tu-suscripcion).

---

URL canónica: https://docs.filmo.io/es/concepts/plans-and-add-ons  
Última actualización: 2026-10-09