*API REST › Guías*

# Permisos (scopes)

> Una clave lleva permisos; cada operación exige exactamente uno. Concede los mínimos que necesites.

Los permisos del contrato. Cada uno tiene un ancla para enlazarlo.

| Permiso | Permite | Operaciones | Herramientas MCP |
| --- | --- | --- | --- |
| `account:read` | Leer la cuenta que hizo la petición: su nombre, zona horaria, moneda, país, add-ons, la clave de API con sus permisos (scopes) y los límites de uso. `GET /api/v1/account` es la primera llamada de cualquier integración, así que este es el permiso (scope) que hay que conceder primero. | 1 | 1 |
| `ai:ask` | Hacer una pregunta al asistente de Filmo sobre los datos de la cuenta en lenguaje natural. Nunca escribe, pero cada llamada gasta créditos de IA de la cuenta, y puede buscar en la web. | 1 | 1 |
| `availability:read` | Consultar la disponibilidad de artículos en un rango de fechas, y leer las indisponibilidades de una persona, un vehículo o un espacio. | 2 | 2 |
| `availability:write` | Declarar, corregir, cerrar y eliminar indisponibilidades de una persona, un vehículo o un espacio. Eliminar una indisponibilidad no se puede deshacer. | 3 | 3 |
| `collections:read` | Leer el árbol de colecciones con el que se organiza el catálogo. | 1 | 1 |
| `collections:write` | Crear y renombrar colecciones, y moverlas dentro del árbol. | 2 | 2 |
| `contacts:read` | Leer contactos (clientes y proveedores), sus direcciones y contactos relacionados, y buscar contactos por número de contacto. | 4 | 4 |
| `contacts:write` | Crear, modificar y eliminar contactos, sus direcciones, condiciones comerciales y vínculos con contactos relacionados. Eliminar un contacto elimina también sus relaciones, notas, archivos, tareas, métodos de pago y acceso al portal de clientes, y no se puede deshacer. Quitar una dirección tampoco se puede deshacer. | 10 | 10 |
| `contracts:read` | Leer contratos de alquiler con el estado de su documento y de su firma. | 2 | 2 |
| `contracts:write` | Validar, firmar, anular y cancelar contratos de alquiler. Validar un contrato le asigna número y lo bloquea. Anularlo le quita la validez. Cancelar un contrato es terminal: un contrato cancelado ya no se puede firmar. Un contrato ya firmado solo se puede deshacer anulando el documento. | 4 | 4 |
| `crm:read` | Leer oportunidades del CRM y los embudos por los que avanzan. | 4 | 4 |
| `crm:write` | Crear y modificar oportunidades, moverlas entre etapas, cerrarlas y vincularles documentos. | 5 | 5 |
| `custom-fields:read` | Leer las definiciones de los campos personalizados de la cuenta (identificador, tipo y valores aceptados), no los valores guardados en los registros. | 1 | 1 |
| `incidents:read` | Leer incidencias (material roto, perdido o dañado) y el recuento de incidencias por estado. | 3 | 3 |
| `incidents:write` | Abrir y actualizar incidencias, y comentarlas. | 3 | 3 |
| `internal-services:read` | Leer servicios internos, las asignaciones planificadas que no cuelgan de un pedido. | 2 | 2 |
| `internal-services:write` | Crear y modificar servicios internos. | 2 | 2 |
| `invoices:read` | Lee facturas (con sus líneas), notas de crédito y proformas (totales y estado; sus líneas no se publican). | 7 | 7 |
| `invoices:write` | Validar y anular facturas y notas de crédito, cambiar el estado comercial de las proformas y crear o actualizar el espejo de una factura emitida por otro sistema. Validar una factura o una nota de crédito le asigna número, la firma y la bloquea, y después ninguna de las dos se puede editar; anularla conserva el número y no se puede deshacer. Anular una factura no emite una nota de crédito. | 6 | 6 |
| `items:read` | Leer artículos del catálogo y sus unidades serializadas. | 4 | 4 |
| `items:write` | Crear, modificar y eliminar artículos, incluidos sus precios, propiedades físicas, accesorios, alternativas y variantes, y actualizar unidades serializadas. Eliminar un artículo elimina también sus unidades serializadas, notas, archivos y tareas, y no se puede deshacer. | 9 | 9 |
| `kits:read` | Leer kits, los grupos con nombre de artículos que salen juntos. | 2 | 2 |
| `kits:write` | Crear y modificar kits. | 2 | 2 |
| `notes:read` | Leer las notas adjuntas a una entidad de la cuenta. | 1 | 1 |
| `notes:write` | Escribir notas en entidades de la cuenta. | 1 | 1 |
| `orders:read` | Leer pedidos de alquiler y sus líneas. | 3 | 3 |
| `orders:write` | Crear y modificar pedidos, y ejecutar acciones sobre ellos (reservar, anular la reserva, cancelar, archivar, devolver líneas). Cancelar un pedido no se puede deshacer desde la API. Devolver líneas devuelve el material al stock, así que un reintento sin la misma `Idempotency-Key` lo devuelve dos veces. Envía tu propia clave. Reservar descuenta stock y crea las tareas de entrega y devolución. | 7 | 7 |
| `planner:read` | Leer los servicios de personal y de flota de una ventana de fechas, con quién los cubre, y los recursos que se pueden asignar. | 2 | 2 |
| `planner:write` | Asignar recursos a los servicios del planificador y quitarlos. | 2 | 2 |
| `projects:read` | Leer proyectos y el catálogo de tipos de proyecto. | 3 | 3 |
| `projects:write` | Crear, modificar y archivar proyectos, y vincularles pedidos o desvincularlos. | 5 | 5 |
| `purchase-orders:read` | Leer órdenes de compra a proveedores. | 2 | 2 |
| `purchase-orders:write` | Modificar, aprobar y recepcionar órdenes de compra. Recepcionar una orden de compra registra inventario nuevo, así que un reintento sin el mismo `Idempotency-Key` duplica el stock. Envía tu propia clave. | 3 | 3 |
| `quotes:read` | Leer presupuestos (versión activa) y sus líneas. | 3 | 3 |
| `quotes:write` | Modificar el estado comercial de los presupuestos. Confirmar una versión de un presupuesto pasa todas las demás versiones a `superseded`. | 1 | 1 |
| `repair-tickets:read` | Leer tickets de reparación. | 2 | 2 |
| `repair-tickets:write` | Crear y modificar tickets de reparación, incluidas sus líneas. Enviar `lines` al actualizar un ticket sustituye todo el conjunto de líneas: envíalas todas o ninguna. | 2 | 2 |
| `schedule:read` | Leer la agenda consolidada de un rango de fechas: proyectos, pedidos, tareas, servicios internos y servicios de pedido. | 1 | 1 |
| `services:read` | Leer servicios, las líneas vendibles que no proceden del inventario. | 2 | 2 |
| `services:write` | Crear y modificar servicios, incluidos los precios. | 2 | 2 |
| `spaces:read` | Leer almacenes y espacios alquilables. | 2 | 2 |
| `spaces:write` | Modificar y eliminar espacios, y reemplazar sus servicios y equipamiento y establecer su precio. Eliminar un espacio elimina también sus notas, archivos, tareas, imágenes e indisponibilidades declaradas, y no se puede deshacer. | 4 | 4 |
| `staff:read` | Leer miembros del personal y comprobar la disponibilidad del personal en un rango de fechas. | 3 | 3 |
| `staff:write` | Crear, modificar y eliminar miembros del personal (solo datos de organización). Eliminar a un miembro del personal no se puede deshacer. | 3 | 3 |
| `subrents:read` | Leer subalquileres, el material alquilado a otras empresas para cubrir un trabajo. | 2 | 2 |
| `subrents:write` | Modificar subalquileres. | 1 | 1 |
| `supplier-invoices:read` | Leer facturas recibidas de proveedores. | 2 | 2 |
| `supplier-invoices:write` | Validar y anular facturas recibidas de proveedores. Validar una factura de proveedor le asigna número y la bloquea, y anularla conserva su número. Ambas acciones requieren el add-on de compras. | 2 | 2 |
| `tags:read` | Leer el vocabulario de etiquetas de la cuenta. | 1 | 1 |
| `tags:write` | Crear y eliminar etiquetas, y asignarlas o quitarlas en entidades. Eliminar una etiqueta la quita de todas las entidades que la tenían, y no se puede deshacer. | 4 | 4 |
| `tasks:read` | Leer tareas, eventos de la agenda y tipos de tarea. | 3 | 3 |
| `tasks:write` | Crear, modificar y eliminar tareas. Eliminar una tarea no se puede deshacer. | 3 | 3 |
| `treasury:read` | Leer cuentas de tesorería, pagos y métodos de pago, y los pagos de una factura. | 6 | 6 |
| `treasury:write` | Registrar, modificar y vincular pagos. Registrar un pago escribe en tus cuentas: un reintento sin el mismo `Idempotency-Key` lo registra dos veces. Envía tu propia clave. | 3 | 3 |
| `users:read` | Leer las personas con acceso a la cuenta, con su rol y estado de acceso. Solo los administradores pueden llamarla. | 1 | 1 |
| `vehicles:read` | Leer vehículos de la flota y comprobar la disponibilidad de la flota en un rango de fechas. | 3 | 3 |
| `vehicles:write` | Crear, modificar y eliminar vehículos. Eliminar un vehículo no se puede deshacer. | 3 | 3 |
| `workflows:read` | Listar los workflows de la cuenta y si cada uno está activo. Las definiciones no se publican. | 1 | 1 |
| `workflows:run` | Iniciar una ejecución de un workflow, como hace el botón Ejecutar de la app. La ejecución se realiza en segundo plano y hace lo que digan los pasos del workflow, así que puede cambiar datos en Filmo y tener efectos fuera de Filmo. Este es el permiso más amplio del contrato: una ejecución hace lo que digan los pasos del workflow. Concédelo solo a las integraciones que necesiten iniciar workflows y envía tu propio `Idempotency-Key`. | 1 | 1 |

## Cada permiso

### account:read

Leer la cuenta que hizo la petición: su nombre, zona horaria, moneda, país, add-ons, la clave de API con sus permisos (scopes) y los límites de uso. [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) es la primera llamada de cualquier integración, así que este es el permiso (scope) que hay que conceder primero.

- [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) — Obtener la cuenta

### ai:ask

Hacer una pregunta al asistente de Filmo sobre los datos de la cuenta en lenguaje natural. Nunca escribe, pero cada llamada gasta créditos de IA de la cuenta, y puede buscar en la web.

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

### availability:read

Consultar la disponibilidad de artículos en un rango de fechas, y leer las indisponibilidades de una persona, un vehículo o un espacio.

- [`POST /api/v1/availability/check`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/check-item-availability) — Comprobar la disponibilidad de artículos
- [`GET /api/v1/availability/unavailabilities`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/list-the-unavailabilities-of-a-resource) — Listar las indisponibilidades de un recurso

### availability:write

Declarar, corregir, cerrar y eliminar indisponibilidades de una persona, un vehículo o un espacio. Eliminar una indisponibilidad no se puede deshacer.

- [`POST /api/v1/availability/unavailabilities`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/declare-an-unavailability) — Declarar una indisponibilidad
- [`PATCH /api/v1/availability/unavailabilities/{unavailabilityId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/correct-or-close-an-unavailability) — Corregir o cerrar una indisponibilidad
- [`DELETE /api/v1/availability/unavailabilities/{unavailabilityId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/delete-an-unavailability) — Eliminar una indisponibilidad

### collections:read

Leer el árbol de colecciones con el que se organiza el catálogo.

- [`GET /api/v1/collections`](https://docs.filmo.io/es/rest-api/endpoint-reference/collections/list-collections) — Listar colecciones

### collections:write

Crear y renombrar colecciones, y moverlas dentro del árbol.

- [`POST /api/v1/collections`](https://docs.filmo.io/es/rest-api/endpoint-reference/collections/create-a-collection) — Crear una colección
- [`PATCH /api/v1/collections/{collectionId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/collections/update-a-collection) — Actualizar una colección

### contacts:read

Leer contactos (clientes y proveedores), sus direcciones y contactos relacionados, y buscar contactos por número de contacto.

- [`GET /api/v1/contacts`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/list-contacts) — Listar contactos
- [`GET /api/v1/contacts/{contactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/get-a-contact) — Obtener un contacto
- [`GET /api/v1/contacts/{contactId}/related-contacts`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/list-the-contacts-related-to-a-contact) — Listar los contactos relacionados con un contacto
- [`POST /api/v1/contacts/lookup`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/look-up-contacts-by-external-reference) — Buscar contactos por referencia externa

### contacts:write

Crear, modificar y eliminar contactos, sus direcciones, condiciones comerciales y vínculos con contactos relacionados. Eliminar un contacto elimina también sus relaciones, notas, archivos, tareas, métodos de pago y acceso al portal de clientes, y no se puede deshacer. Quitar una dirección tampoco se puede deshacer.

- [`POST /api/v1/contacts`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/create-a-contact) — Crear un contacto
- [`PATCH /api/v1/contacts/{contactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/update-a-contact) — Actualizar un contacto
- [`DELETE /api/v1/contacts/{contactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/delete-a-contact) — Eliminar un contacto
- [`PATCH /api/v1/contacts/{contactId}/preferences`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/update-the-commercial-terms-of-a-contact) — Actualizar las condiciones comerciales de un contacto
- [`POST /api/v1/contacts/{contactId}/addresses`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/add-an-address-to-a-contact) — Añadir una dirección a un contacto
- [`PATCH /api/v1/contacts/{contactId}/addresses/{addressId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/update-an-address-of-a-contact) — Actualizar una dirección de un contacto
- [`DELETE /api/v1/contacts/{contactId}/addresses/{addressId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/remove-an-address-from-a-contact) — Quitar una dirección de un contacto
- [`POST /api/v1/contacts/{contactId}/related-contacts`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/relate-two-contacts) — Relacionar dos contactos
- [`PATCH /api/v1/contacts/{contactId}/related-contacts/{relatedContactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/change-the-role-of-a-relationship) — Cambiar el rol de una relación
- [`DELETE /api/v1/contacts/{contactId}/related-contacts/{relatedContactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/unrelate-two-contacts) — Quitar la relación entre dos contactos

### contracts:read

Leer contratos de alquiler con el estado de su documento y de su firma.

- [`GET /api/v1/contracts`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/list-contracts) — Listar contratos
- [`GET /api/v1/contracts/{contractId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/get-a-contract) — Obtener un contrato

### contracts:write

Validar, firmar, anular y cancelar contratos de alquiler. Validar un contrato le asigna número y lo bloquea. Anularlo le quita la validez. Cancelar un contrato es terminal: un contrato cancelado ya no se puede firmar. Un contrato ya firmado solo se puede deshacer anulando el documento.

- [`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/contracts/{contractId}/void`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/void-a-contract) — Anular un contrato
- [`POST /api/v1/contracts/{contractId}/cancel`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/cancel-a-contract-operatively) — Cancelar un contrato a efectos operativos

### crm:read

Leer oportunidades del CRM y los embudos por los que avanzan.

- [`GET /api/v1/crm/opportunities`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/list-opportunities) — Listar oportunidades
- [`GET /api/v1/crm/opportunities/{opportunityId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/get-an-opportunity) — Obtener 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

### crm:write

Crear y modificar oportunidades, moverlas entre etapas, cerrarlas y vincularles documentos.

- [`POST /api/v1/crm/opportunities`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/create-an-opportunity) — Crear 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

### custom-fields:read

Leer las definiciones de los campos personalizados de la cuenta (identificador, tipo y valores aceptados), no los valores guardados en los registros.

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

### incidents:read

Leer incidencias (material roto, perdido o dañado) y el recuento de incidencias por estado.

- [`GET /api/v1/incidents`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/list-incidents) — Listar incidencias
- [`GET /api/v1/incidents/{incidentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/get-an-incident) — Obtener 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

### incidents:write

Abrir y actualizar incidencias, y comentarlas.

- [`POST /api/v1/incidents`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/open-an-incident) — Abrir una incidencia
- [`PATCH /api/v1/incidents/{incidentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/update-an-incident) — Actualizar una incidencia
- [`POST /api/v1/incidents/{incidentId}/comments`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/comment-on-an-incident) — Comentar una incidencia

### internal-services:read

Leer servicios internos, las asignaciones planificadas que no cuelgan de un pedido.

- [`GET /api/v1/internal-services`](https://docs.filmo.io/es/rest-api/endpoint-reference/internal-services/list-internal-services) — Listar servicios internos
- [`GET /api/v1/internal-services/{internalServiceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/internal-services/get-an-internal-service) — Obtener un servicio interno

### internal-services:write

Crear y modificar servicios internos.

- [`POST /api/v1/internal-services`](https://docs.filmo.io/es/rest-api/endpoint-reference/internal-services/create-an-internal-service) — Crear un servicio interno
- [`PATCH /api/v1/internal-services/{internalServiceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/internal-services/update-an-internal-service) — Actualizar un servicio interno

### invoices:read

Lee facturas (con sus líneas), notas de crédito y proformas (totales y estado; sus líneas no se publican).

- [`GET /api/v1/invoices`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-invoices) — Listar facturas
- [`GET /api/v1/invoices/{invoiceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/get-an-invoice) — Obtener una factura
- [`GET /api/v1/invoices/{invoiceId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-the-lines-of-an-invoice) — Listar las líneas de una factura
- [`GET /api/v1/credit-notes`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/list-credit-notes) — Listar notas de crédito
- [`GET /api/v1/credit-notes/{creditNoteId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/get-a-credit-note) — Obtener una nota de crédito
- [`GET /api/v1/proformas`](https://docs.filmo.io/es/rest-api/endpoint-reference/proformas/list-proformas) — Listar proformas
- [`GET /api/v1/proformas/{proformaId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/proformas/get-a-proforma) — Obtener una proforma

### invoices:write

Validar y anular facturas y notas de crédito, cambiar el estado comercial de las proformas y crear o actualizar el espejo de una factura emitida por otro sistema. Validar una factura o una nota de crédito le asigna número, la firma y la bloquea, y después ninguna de las dos se puede editar; anularla conserva el número y no se puede deshacer. Anular una factura no emite una nota de crédito.

- [`POST /api/v1/invoices/{invoiceId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/validate-an-invoice) — Validar una factura
- [`POST /api/v1/invoices/{invoiceId}/void`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/void-an-invoice) — Anular 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
- [`POST /api/v1/credit-notes/{creditNoteId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/validate-a-credit-note) — Validar una nota de crédito
- [`POST /api/v1/credit-notes/{creditNoteId}/void`](https://docs.filmo.io/es/rest-api/endpoint-reference/credit-notes/void-a-credit-note) — Anular una nota de crédito
- [`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

### items:read

Leer artículos del catálogo y sus unidades serializadas.

- [`GET /api/v1/items`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/list-items) — Listar artículos
- [`GET /api/v1/items/{itemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/get-an-item) — Obtener un artículo
- [`GET /api/v1/serialized-items`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/list-serialized-items) — Listar unidades serializadas
- [`GET /api/v1/serialized-items/{serializedItemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/get-a-serialized-item) — Obtener una unidad serializada

### items:write

Crear, modificar y eliminar artículos, incluidos sus precios, propiedades físicas, accesorios, alternativas y variantes, y actualizar unidades serializadas. Eliminar un artículo elimina también sus unidades serializadas, notas, archivos y tareas, y no se puede deshacer.

- [`POST /api/v1/items`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/create-an-item) — Crear un artículo
- [`PATCH /api/v1/items/{itemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-an-item) — Actualizar un artículo
- [`DELETE /api/v1/items/{itemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/delete-an-item) — Eliminar un artículo
- [`PATCH /api/v1/items/{itemId}/physical-properties`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-weight-and-dimensions) — Actualizar peso y dimensiones
- [`PATCH /api/v1/items/{itemId}/pricing`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-the-pricing-of-an-item) — Actualizar los precios de un artículo
- [`PATCH /api/v1/serialized-items/{serializedItemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-a-serialized-item) — Actualizar una unidad serializada
- [`PUT /api/v1/items/{itemId}/accessories`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-the-accessories-of-an-item) — Actualizar los accesorios de un artículo
- [`PUT /api/v1/items/{itemId}/alternatives`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-the-alternatives-of-an-item) — Actualizar las alternativas de un artículo
- [`PATCH /api/v1/items/{itemId}/variants/{variantId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-a-variant-of-an-item) — Actualizar una variante de un artículo

### kits:read

Leer kits, los grupos con nombre de artículos que salen juntos.

- [`GET /api/v1/kits`](https://docs.filmo.io/es/rest-api/endpoint-reference/kits/list-kits) — Listar kits
- [`GET /api/v1/kits/{kitId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/kits/get-a-kit) — Obtener un kit

### kits:write

Crear y modificar kits.

- [`POST /api/v1/kits`](https://docs.filmo.io/es/rest-api/endpoint-reference/kits/create-a-kit) — Crear un kit
- [`PATCH /api/v1/kits/{kitId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/kits/update-a-kit) — Actualizar un kit

### notes:read

Leer las notas adjuntas a una entidad de la cuenta.

- [`GET /api/v1/notes`](https://docs.filmo.io/es/rest-api/endpoint-reference/notes/list-the-notes-of-an-entity) — Listar las notas de una entidad

### notes:write

Escribir notas en entidades de la cuenta.

- [`POST /api/v1/notes`](https://docs.filmo.io/es/rest-api/endpoint-reference/notes/write-a-note-on-an-entity) — Escribe una nota en una entidad

### orders:read

Leer pedidos de alquiler y sus líneas.

- [`GET /api/v1/orders`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders) — Listar pedidos
- [`GET /api/v1/orders/{orderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/get-an-order) — Obtener un pedido
- [`GET /api/v1/orders/{orderId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-the-lines-of-an-order) — Listar las líneas de un pedido

### orders:write

Crear y modificar pedidos, y ejecutar acciones sobre ellos (reservar, anular la reserva, cancelar, archivar, devolver líneas). Cancelar un pedido no se puede deshacer desde la API. Devolver líneas devuelve el material al stock, así que un reintento sin la misma `Idempotency-Key` lo devuelve dos veces. Envía tu propia clave. Reservar descuenta stock y crea las tareas de entrega y devolución.

- [`POST /api/v1/orders`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/create-an-order) — Crear un pedido
- [`PATCH /api/v1/orders/{orderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/update-the-header-of-an-order) — Actualizar la cabecera de un pedido
- [`POST /api/v1/orders/{orderId}/cancel`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/cancel-an-order) — Cancelar un pedido
- [`PUT /api/v1/orders/{orderId}/archive`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/archive-or-restore-an-order) — Archivar o restaurar un pedido
- [`POST /api/v1/orders/line-items/returns`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/return-order-lines) — Devolver líneas de pedido
- [`POST /api/v1/orders/{orderId}/reserve`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/reserve-an-order) — Reservar un pedido
- [`POST /api/v1/orders/{orderId}/unreserve`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/unreserve-an-order) — Anula la reserva de un pedido

### planner:read

Leer los servicios de personal y de flota de una ventana de fechas, con quién los cubre, y los recursos que se pueden asignar.

- [`GET /api/v1/planner/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/planner/list-the-services-to-cover) — Listar los servicios por cubrir
- [`GET /api/v1/planner/resources`](https://docs.filmo.io/es/rest-api/endpoint-reference/planner/list-the-assignable-resources) — Listar los recursos asignables

### planner:write

Asignar recursos a los servicios del planificador y quitarlos.

- [`POST /api/v1/planner/assignments`](https://docs.filmo.io/es/rest-api/endpoint-reference/planner/assign-a-resource-to-a-service) — Asignar un recurso a un servicio
- [`POST /api/v1/planner/assignments/remove`](https://docs.filmo.io/es/rest-api/endpoint-reference/planner/remove-a-resource-from-a-service) — Quitar un recurso de un servicio

### projects:read

Leer proyectos y el catálogo de tipos de proyecto.

- [`GET /api/v1/projects`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/list-projects) — Listar proyectos
- [`GET /api/v1/projects/{projectId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/get-a-project) — Obtener un proyecto
- [`GET /api/v1/project-types`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/list-project-types) — Listar tipos de proyecto

### projects:write

Crear, modificar y archivar proyectos, y vincularles pedidos o desvincularlos.

- [`POST /api/v1/projects`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/create-a-project) — Crear un proyecto
- [`PUT /api/v1/projects/{projectId}/archive`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/archive-or-restore-a-project) — Archivar o restaurar un proyecto
- [`PATCH /api/v1/projects/{projectId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/update-a-project) — Actualizar un proyecto
- [`POST /api/v1/projects/{projectId}/orders/{orderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/link-an-order-to-a-project) — Vincular un pedido a un proyecto
- [`DELETE /api/v1/projects/{projectId}/orders/{orderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/unlink-an-order-from-a-project) — Desvincular un pedido de un proyecto

### purchase-orders:read

Leer órdenes de compra a proveedores.

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

### purchase-orders:write

Modificar, aprobar y recepcionar órdenes de compra. Recepcionar una orden de compra registra inventario nuevo, así que un reintento sin el mismo `Idempotency-Key` duplica el stock. Envía tu propia clave.

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

### quotes:read

Leer presupuestos (versión activa) y sus líneas.

- [`GET /api/v1/quotes`](https://docs.filmo.io/es/rest-api/endpoint-reference/quotes/list-quotes) — Listar presupuestos
- [`GET /api/v1/quotes/{quoteId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/quotes/get-a-quote) — Obtener un presupuesto
- [`GET /api/v1/quotes/{quoteId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/quotes/list-the-lines-of-a-quote) — Listar las líneas de un presupuesto

### quotes:write

Modificar el estado comercial de los presupuestos. Confirmar una versión de un presupuesto pasa todas las demás versiones a `superseded`.

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

### repair-tickets:read

Leer tickets de reparación.

- [`GET /api/v1/repair-tickets`](https://docs.filmo.io/es/rest-api/endpoint-reference/repair-tickets/list-repair-tickets) — Listar tickets 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

### repair-tickets:write

Crear y modificar tickets de reparación, incluidas sus líneas. Enviar `lines` al actualizar un ticket sustituye todo el conjunto de líneas: envíalas todas o ninguna.

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

### schedule:read

Leer la agenda consolidada de un rango de fechas: proyectos, pedidos, tareas, servicios internos y servicios de pedido.

- [`GET /api/v1/schedule`](https://docs.filmo.io/es/rest-api/endpoint-reference/schedule/get-the-schedule-for-a-range) — Obtener la agenda de un rango

### services:read

Leer servicios, las líneas vendibles que no proceden del inventario.

- [`GET /api/v1/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/list-services) — Listar servicios
- [`GET /api/v1/services/{serviceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/get-a-service) — Obtener un servicio

### services:write

Crear y modificar servicios, incluidos los precios.

- [`POST /api/v1/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/create-a-service) — Crear un servicio
- [`PATCH /api/v1/services/{serviceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/update-a-service) — Actualizar un servicio

### spaces:read

Leer almacenes y espacios alquilables.

- [`GET /api/v1/spaces`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/list-warehouses-and-spaces) — Listar almacenes y espacios
- [`GET /api/v1/spaces/{spaceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/get-a-warehouse-or-space) — Obtener un almacén o espacio

### spaces:write

Modificar y eliminar espacios, y reemplazar sus servicios y equipamiento y establecer su precio. Eliminar un espacio elimina también sus notas, archivos, tareas, imágenes e indisponibilidades declaradas, y no se puede deshacer.

- [`PATCH /api/v1/spaces/{spaceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/update-a-warehouse-or-space) — Actualizar un almacén o espacio
- [`DELETE /api/v1/spaces/{spaceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/delete-a-space) — Eliminar un espacio
- [`PUT /api/v1/spaces/{spaceId}/amenities`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/replace-the-amenities-and-equipment) — Reemplazar las comodidades y el equipamiento
- [`PATCH /api/v1/spaces/{spaceId}/pricing`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/update-the-pricing-of-a-space) — Actualizar los precios de un espacio

### staff:read

Leer miembros del personal y comprobar la disponibilidad del personal en un rango de fechas.

- [`GET /api/v1/staff`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/list-staff) — Listar personal
- [`GET /api/v1/staff/{staffId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/get-a-staff-member) — Obtener un miembro del personal
- [`POST /api/v1/staff/availability`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/check-staff-availability) — Comprobar la disponibilidad del personal

### staff:write

Crear, modificar y eliminar miembros del personal (solo datos de organización). Eliminar a un miembro del personal no se puede deshacer.

- [`POST /api/v1/staff`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/create-a-staff-member) — Crear un miembro del personal
- [`PATCH /api/v1/staff/{staffId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/update-a-staff-member) — Actualizar un miembro del personal
- [`DELETE /api/v1/staff/{staffId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/delete-a-staff-member) — Eliminar un miembro del personal

### subrents:read

Leer subalquileres, el material alquilado a otras empresas para cubrir un trabajo.

- [`GET /api/v1/subrents`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/list-subrents) — Listar subalquileres
- [`GET /api/v1/subrents/{subrentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/get-a-subrent) — Obtener un subalquiler

### subrents:write

Modificar subalquileres.

- [`PATCH /api/v1/subrents/{subrentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/update-a-subrent) — Actualizar un subalquiler

### supplier-invoices:read

Leer facturas recibidas de proveedores.

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

### supplier-invoices:write

Validar y anular facturas recibidas de proveedores. Validar una factura de proveedor le asigna número y la bloquea, y anularla conserva su número. Ambas acciones requieren el add-on de compras.

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

### tags:read

Leer el vocabulario de etiquetas de la cuenta.

- [`GET /api/v1/tags`](https://docs.filmo.io/es/rest-api/endpoint-reference/tags/list-tags) — Listar etiquetas

### tags:write

Crear y eliminar etiquetas, y asignarlas o quitarlas en entidades. Eliminar una etiqueta la quita de todas las entidades que la tenían, y no se puede deshacer.

- [`POST /api/v1/tags`](https://docs.filmo.io/es/rest-api/endpoint-reference/tags/create-a-tag) — Crear una etiqueta
- [`DELETE /api/v1/tags/{tagId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/tags/delete-a-tag) — Eliminar una etiqueta
- [`POST /api/v1/tags/{tagId}/assignments`](https://docs.filmo.io/es/rest-api/endpoint-reference/tags/assign-a-tag-to-an-entity) — Asignar una etiqueta a una entidad
- [`DELETE /api/v1/tags/{tagId}/assignments`](https://docs.filmo.io/es/rest-api/endpoint-reference/tags/remove-a-tag-from-an-entity) — Quitar una etiqueta de una entidad

### tasks:read

Leer tareas, eventos de la agenda y tipos de tarea.

- [`GET /api/v1/tasks`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/list-tasks) — Listar tareas
- [`GET /api/v1/tasks/{taskId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/get-a-task) — Obtener una tarea
- [`GET /api/v1/task-types`](https://docs.filmo.io/es/rest-api/endpoint-reference/task-types/list-task-types) — Listar tipos de tarea

### tasks:write

Crear, modificar y eliminar tareas. Eliminar una tarea no se puede deshacer.

- [`POST /api/v1/tasks`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/create-a-task) — Crear una tarea
- [`PATCH /api/v1/tasks/{taskId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/update-a-task) — Actualizar una tarea
- [`DELETE /api/v1/tasks/{taskId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/delete-a-task) — Eliminar una tarea

### treasury:read

Leer cuentas de tesorería, pagos y métodos de pago, y los pagos de una factura.

- [`GET /api/v1/invoices/{invoiceId}/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-the-payments-of-an-invoice) — Listar los pagos de una factura
- [`GET /api/v1/treasury/accounts`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/list-treasury-accounts) — Listar cuentas de tesorería
- [`GET /api/v1/treasury/accounts/{accountId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/get-a-treasury-account) — Obtener una cuenta de tesorería
- [`GET /api/v1/treasury/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/list-treasury-payments) — Listar pagos de tesorería
- [`GET /api/v1/treasury/payments/{paymentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/get-a-payment) — Obtener un pago
- [`GET /api/v1/payment-methods`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/list-payment-methods) — Listar métodos de pago

### treasury:write

Registrar, modificar y vincular pagos. Registrar un pago escribe en tus cuentas: un reintento sin el mismo `Idempotency-Key` lo registra dos veces. Envía tu propia clave.

- [`POST /api/v1/treasury/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/record-an-incoming-or-outgoing-payment) — Registrar un pago entrante o saliente
- [`PATCH /api/v1/treasury/payments/{paymentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/update-a-payment) — Actualizar un pago
- [`POST /api/v1/treasury/payments/{paymentId}/links`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/link-a-payment-to-a-document) — Vincular un pago a un documento

### users:read

Leer las personas con acceso a la cuenta, con su rol y estado de acceso. Solo los administradores pueden llamarla.

- [`GET /api/v1/users`](https://docs.filmo.io/es/rest-api/endpoint-reference/users/list-users) — Listar usuarios

### vehicles:read

Leer vehículos de la flota y comprobar la disponibilidad de la flota en un rango de fechas.

- [`GET /api/v1/vehicles`](https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/list-vehicles) — Listar vehículos
- [`GET /api/v1/vehicles/{vehicleId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/get-a-vehicle) — Obtener un vehículo
- [`POST /api/v1/vehicles/availability`](https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/check-fleet-availability) — Comprobar la disponibilidad de la flota

### vehicles:write

Crear, modificar y eliminar vehículos. Eliminar un vehículo no se puede deshacer.

- [`POST /api/v1/vehicles`](https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/create-a-vehicle) — Crear un vehículo
- [`PATCH /api/v1/vehicles/{vehicleId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/update-a-vehicle) — Actualizar un vehículo
- [`DELETE /api/v1/vehicles/{vehicleId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/delete-a-vehicle) — Eliminar un vehículo

### workflows:read

Listar los workflows de la cuenta y si cada uno está activo. Las definiciones no se publican.

- [`GET /api/v1/workflows`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/list-workflows) — Listar workflows

### workflows:run

Iniciar una ejecución de un workflow, como hace el botón Ejecutar de la app. La ejecución se realiza en segundo plano y hace lo que digan los pasos del workflow, así que puede cambiar datos en Filmo y tener efectos fuera de Filmo. Este es el permiso más amplio del contrato: una ejecución hace lo que digan los pasos del workflow. Concédelo solo a las integraciones que necesiten iniciar workflows y envía tu propio `Idempotency-Key`.

- [`POST /api/v1/workflows/{workflowId}/runs`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/run-a-workflow) — Ejecutar un workflow

---

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