*Visión general › Conceptos básicos*

# Cuentas y aislamiento

> Una clave está ligada a una suscripción. La mayoría de los recursos se limitan exactamente a esa suscripción; los contactos, los proyectos, las etiquetas y los campos personalizados también son visibles desde la cuenta principal de una cuenta de facturación.

## Organizaciones y cuentas

Una empresa de Filmo puede ser una suscripción por sí sola, o una organización con varias. En una organización, una cuenta completa es la principal, y una cuenta de facturación es la que factura bajo una cuenta completa principal. La clave que creas pertenece a una de ellas, y [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) devuelve el nombre de la cuenta que hizo la petición.

Ninguna operación cruza nunca datos entre organizaciones distintas.

## Dos tipos de visibilidad

**Aislamiento: qué ve una clave**
- Organización
-   Cuenta completa (principal): Solo ve sus propios datos.
-     Cuentas de facturación: Facturan bajo la cuenta principal. También ven los recursos heredados de la cuenta principal.
- Heredado de la cuenta principal: Contactos, Proyectos, Etiquetas, Campos personalizados, Leer un pedido por id
- Igualdad estricta de suscripción: Elementos, Elementos con número de serie, Espacios, Facturas, Presupuestos, Tareas, Tipos de tarea, Tickets de reparación, Vehículos, Personal, Subalquileres, Pedidos de compra, Contratos, Tipos de proyecto, La lista de pedidos, Disponibilidad
- No hay ampliación entre cuentas de facturación hermanas, ni de la cuenta principal a sus cuentas de facturación, y ninguna operación cruza datos entre organizaciones.
- Leer un recurso fuera de tu tenancy es un 404 not_found, idéntico a que no exista. Escribir un cuerpo que referencia un identificador fuera de ella es un 400 validation_error que nombra el campo, y no se escribe nada.

Hasta dónde ve una clave depende de cómo modela Filmo la propiedad de cada recurso. La tabla siguiente enumera los recursos de cada tipo.

| Semántica | Recursos | Qué ve una clave |
| --- | --- | --- |
| Heredado de la cuenta principal | Contactos, proyectos, etiquetas y campos personalizados, y lectura de un pedido por id | Una cuenta de facturación también ve estos recursos de su cuenta principal, y valida las referencias contra ese mismo conjunto cuando escribe. Una cuenta completa, y una suscripción fuera de cualquier organización, solo ve los suyos. |
| Igualdad estricta de suscripción | Todo lo demás: artículos, unidades serializadas, espacios, facturas, presupuestos, tareas, tipos de tarea, tickets de reparación, vehículos, personal, subalquileres, órdenes de compra, contratos, tipos de proyecto, la lista de pedidos y la disponibilidad | Exactamente la suscripción a la que pertenece la clave. No se amplía a la organización. |

La herencia va en un solo sentido. No hay ampliación entre cuentas de facturación hermanas ni de una cuenta principal a sus cuentas de facturación. Leer un pedido por id es heredado, pero la lista de pedidos es estricta, así que un pedido que puedes abrir por id puede no aparecer en tu lista.

## Qué obtienes fuera de tu aislamiento

| Tú haces | Resultado | Por qué |
| --- | --- | --- |
| Leer un recurso fuera del aislamiento de tu clave | 404 `not_found` | Es idéntico a que el recurso no exista. La API nunca revela que existe. |
| Escribir un cuerpo que referencia un identificador fuera de tu aislamiento, como el `contactId` de un pedido | 400 `validation_error` que nombra el campo, y no se escribe nada | El mensaje es el mismo tanto si el identificador no existe como si pertenece a otra cuenta, de modo que no sirve para sondear ninguno de los dos casos. Es un 400 porque lo que está mal es el cuerpo, no la ruta. |

> **Un 404 no siempre es un registro eliminado:** Si un registro desaparece de tu sincronización con un 404, puede que se haya eliminado, archivado o que nunca haya estado en tu aislamiento. Confírmalo antes de eliminar nada por tu parte; [Sincronizar datos](https://docs.filmo.io/es/rest-api/guides/syncing-data) explica cómo.

Las integraciones que dan servicio a varias empresas de alquiler necesitan una clave por cuenta de cliente; consulta [Integraciones con varias cuentas](https://docs.filmo.io/es/rest-api/guides/multi-account-integrations). Las mismas ideas en la app se explican en [Preferencias del espacio de trabajo](https://www.filmo.io/es/help/reference/cuenta-y-ajustes/ajustes-de-la-empresa/ajustes-de-los-datos-de-la-cuenta).

---

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