Errores

`addon_required`

HTTP HTTP 402.

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

{
  "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"
}

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 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

Parar401 · 402 · 403 (clave, propietario o plan)
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[]

requiredAddonstring

En addon_required: el id del add-on que necesita el plan de la cuenta (los ids que GET /account lista en addons).

Opciones disponibles: qr-codes, incidence, purchases, activity-log, custom-fields, profitability, web-builder, crm, consignments, email-calendar, sales-documents, internal-bookings, internal-communication, advanced-user-permissions

Lo devuelven

37 operaciones

GET /api/v1/repair-tickets — Listar tickets de reparación
POST /api/v1/repair-tickets — Crear un parte de reparación
GET /api/v1/repair-tickets/{ticketId} — Obtener un ticket de reparación
PATCH /api/v1/repair-tickets/{ticketId} — Actualizar un ticket de reparación
PATCH /api/v1/subrents/{subrentId} — Actualizar un subalquiler
GET /api/v1/purchase-orders — Listar pedidos de compra
GET /api/v1/purchase-orders/{purchaseOrderId} — Obtener una orden de compra
PATCH /api/v1/purchase-orders/{purchaseOrderId} — Actualizar una orden de compra
GET /api/v1/custom-fields — Listar definiciones de campos personalizados
GET /api/v1/incidents — Listar incidencias
POST /api/v1/incidents — Abrir una incidencia
GET /api/v1/incidents/{incidentId} — Obtener una incidencia
PATCH /api/v1/incidents/{incidentId} — Actualizar una incidencia
GET /api/v1/incidents/status-counts — Contar incidencias por estado
POST /api/v1/incidents/{incidentId}/comments — Comentar una incidencia
GET /api/v1/crm/opportunities — Listar oportunidades
POST /api/v1/crm/opportunities — Crear una oportunidad
GET /api/v1/crm/opportunities/{opportunityId} — Obtener una oportunidad
PATCH /api/v1/crm/opportunities/{opportunityId} — Actualizar una oportunidad
PATCH /api/v1/crm/opportunities/{opportunityId}/stage — Mover una oportunidad a otra etapa
POST /api/v1/crm/opportunities/{opportunityId}/close — Cerrar una oportunidad
POST /api/v1/crm/opportunities/{opportunityId}/links — Vincular un documento a una oportunidad
GET /api/v1/crm/pipelines — Listar embudos
GET /api/v1/crm/pipelines/{pipelineId} — Obtener un embudo
POST /api/v1/purchase-orders/{purchaseOrderId}/approve — Aprobar un pedido de compra
POST /api/v1/purchase-orders/{purchaseOrderId}/receive — Recibir material de un pedido de compra
GET /api/v1/supplier-invoices — Listar facturas de proveedor
GET /api/v1/supplier-invoices/{supplierInvoiceId} — Obtener una factura de proveedor
POST /api/v1/ai/ask — Preguntar a la IA sobre tus datos
POST /api/v1/invoices/{invoiceId}/validate — Validar una factura
PUT /api/v1/invoices/external/{originSystem}/{originExternalId} — Crear o actualizar el espejo de una factura emitida externamente
PATCH /api/v1/proformas/{proformaId}/status — Cambiar el estado comercial de una proforma
PATCH /api/v1/quotes/{quoteId}/status — Cambiar el estado comercial de un presupuesto
POST /api/v1/contracts/{contractId}/validate — Validar un contrato
POST /api/v1/contracts/{contractId}/sign — Registrar la firma de un contrato
POST /api/v1/supplier-invoices/{supplierInvoiceId}/validate — Validar una factura de proveedor
POST /api/v1/supplier-invoices/{supplierInvoiceId}/void — 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`.

¿Te ha resultado útil esta página?

Ejemplo