*Visión general › Conceptos básicos*

# Modelo de datos

> Los pedidos conectan un contacto, un proyecto opcional y el equipo alquilado; de ellos cuelgan los documentos, los pagos, la planificación y el catálogo.

Cada recurso tiene su propia página en la referencia de la API REST (43 páginas de objeto), con sus campos y las operaciones que lo leen y lo escriben. Empieza por el [Resumen de la API REST](https://docs.filmo.io/es/rest-api/overview). La parte de la app del mismo modelo se describe en [Resumen del modelo de datos](https://www.filmo.io/es/help/reference/primeros-pasos/entender-el-modelo-de-datos-de-filmo).

**El modelo de datos**
- abono → contacto · factura (contactId · invoiceId)
- artículo → colección (collectionId)
- contrato → contacto · pedido · proyecto (contactId · orderId · projectId)
- espacio → colección (collectionId)
- factura → pedido · proyecto (orderId · projectId)
- incidencia → artículo · unidad serializada · espacio · vehículo · pedido · proyecto (itemId · serializedItemId · spaceId · vehicleId · orderId · projectId)
- kit → colección (collectionId)
- línea de documento → artículo · pedido (itemId · orderId)
- línea de pedido → pedido · artículo · espacio (orderId · itemId · spaceId)
- miembro del personal → colección (collectionId)
- oportunidad → embudo (pipelineId)
- orden de compra → pedido · proyecto · parte de reparación (orderId · projectId · repairTicketId)
- pago → cuenta de tesorería · contacto (treasuryAccountId · contactId)
- parte de reparación → pedido · contacto (orderId · contactId)
- pedido → proyecto (projectId)
- presupuesto → pedido · proyecto (orderId · projectId)
- proforma → pedido · proyecto (orderId · projectId)
- proyecto → tipo de proyecto · pedido (projectTypeId · orderIds)
- servicio del planificador → pedido · proyecto · servicio · miembro del personal · vehículo · tarea (orderId · projectId · serviceId · staffMemberId · vehicleId · taskId)
- servicio interno → proyecto (projectId)
- subalquiler → artículo · unidad serializada · pedido · proyecto · orden de compra · espacio (itemId · serializedItemId · orderId · projectId · purchaseOrderId · spaceId)
- tarea → proyecto (projectId)
- unidad serializada → artículo · proyecto · contacto (itemId · projectId · contactId)
- usuario → miembro del personal (staffMemberId)
- vehículo → colección (collectionId)
- Generado a partir de los campos …Id y …Ids de los objetos del contrato: cada fila lista a qué otros recursos apunta un objeto y por qué campos.

## Alquileres

- Un contacto es un cliente o un proveedor. Un proyecto agrupa pedidos y trabajo de un contacto, y un pedido puede pertenecer a un proyecto o ir por su cuenta.
- Un pedido lleva un contacto, un periodo de alquiler y líneas. Las líneas pertenecen al pedido y se leen con [`GET /api/v1/orders/{orderId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-the-lines-of-an-order); no existe una colección independiente de líneas.
- [`POST /api/v1/projects/{projectId}/orders/{orderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/link-an-order-to-a-project) y [`DELETE /api/v1/projects/{projectId}/orders/{orderId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/projects/unlink-an-order-from-a-project) asocian un pedido a un proyecto y lo desasocian.
- El ciclo de vida del pedido (reservar, anular la reserva, cancelar, archivar y devolver líneas) es un conjunto de acciones sobre el pedido. Consulta Estados.

## Catálogo y stock

- Un artículo es una entrada del catálogo, con variantes, accesorios y alternativas. Cada unidad física es una unidad serializada de un artículo.
- Un kit es un grupo con nombre de artículos que salen juntos.
- Las colecciones son el árbol con el que se organiza el catálogo: de una colección cuelgan artículos, espacios, vehículos, personal y servicios.
- Un espacio es un almacén que gestiona stock o un espacio alquilable, que se distinguen por `isWarehouse`.
- Las consultas de disponibilidad comprueban artículos, personal y vehículos en un rango de fechas, y las indisponibilidades bloquean un recurso.

## Documentos y dinero

- Los presupuestos, proformas, contratos, facturas y notas de crédito son los documentos. Sus ciclos de vida están en Estados.
- Los pagos de tesorería pasan por cuentas de tesorería y se vinculan a documentos con [`POST /api/v1/treasury/payments/{paymentId}/links`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/link-a-payment-to-a-document).
- Las órdenes de compra, las facturas de proveedor y los subalquileres son el lado de las compras; un subalquiler puede enlazar con su orden de compra.

## Personas, flota y planificación

- El personal y los vehículos son los recursos de la empresa. Las tareas, los servicios internos y el planificador los usan.
- El planificador muestra los servicios de personal y de flota que hay que cubrir en un intervalo de fechas y las asignaciones que los cubren. [`GET /api/v1/schedule`](https://docs.filmo.io/es/rest-api/endpoint-reference/schedule/get-the-schedule-for-a-range) es una proyección de solo lectura de proyectos, pedidos, tareas, asignaciones internas y servicios de pedido.
- Los tickets de reparación y las incidencias registran qué se ha roto y cuánto se presupuesta para arreglarlo.

## Ventas y automatización

- Las oportunidades del CRM avanzan por las etapas de un embudo y se pueden vincular con el presupuesto, el pedido o el proyecto que salió de ellas con [`POST /api/v1/crm/opportunities/{opportunityId}/links`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/link-a-document-to-an-opportunity). Necesitan el add-on de CRM.
- Los workflows se listan con [`GET /api/v1/workflows`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/list-workflows). [`POST /api/v1/workflows/{workflowId}/runs`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/run-a-workflow) inicia una ejecución, no un workflow: las definiciones no se leen ni se escriben a través de la API.

---

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