*Visión general › Conceptos básicos*

# Estados

> La mayoría de los estados son listas cerradas de valores de texto. En los pedidos, el campo muestra uno de 12 estados en bruto, mientras que el filtro del listado usa siete grupos más amplios.

Un valor nuevo sería un cambio documentado y aditivo, así que un cliente debe tolerar un valor que no conozca. Los estados de las notas de crédito y de las proformas no son listas cerradas en absoluto: son texto libre, así que tolera cualquier valor ahí. Las tablas de abajo son las que más necesita un integrador; la tabla generada al final lista todos los enums de estado. La vista de la propia app sobre el ciclo de vida del pedido está en [Ciclo de vida de un pedido](https://www.filmo.io/es/help/reference/pedidos/crear-y-montar-un-pedido/ciclo-de-vida-y-estados-del-pedido).

## Pedidos

**Estados del pedido: 12 valores en bruto, 7 grupos de filtro**
- draft → draft
- reserved → reserved
- prepared_partially, prepared → prepared (Incluye la preparación parcial.)
- picked_up → in_use (Recogido o en uso.)
- returned_partially, returned, checked_in_partially → returned (Incluye la devolución parcial y la recepción parcial.)
- checked_in → completed (Recibido y completado.)
- cancelled → cancelled
- La descripción del filtro no coloca en ningún grupo picked_up_partially ni archived. archived aparece entre los valores del DTO, pero un pedido archivado no se puede listar ni leer.

El campo `status` de un pedido muestra el estado en bruto, uno de 12 valores. El filtro `status` de [`GET /api/v1/orders`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders) usa grupos operativos, la misma vista que la app. No envíes un valor en bruto al filtro ni esperes un grupo en el campo.

| Estado en bruto (campo) | Grupo de filtros |
| --- | --- |
| `draft` | `draft` |
| `reserved` | `reserved` |
| `prepared_partially`, `prepared` | `prepared` (incluye la preparación parcial) |
| `picked_up` | `in_use` (entregado o en uso) |
| `picked_up_partially` | `in_use`. La redacción de la especificación lista solo recogido, así que si necesitas exactamente este estado, lee los pedidos y comprueba tú mismo el estado en bruto |
| `returned_partially`, `returned` | `returned` (incluye la devolución parcial) |
| `checked_in_partially` | `returned` (incluye la recepción parcial) |
| `checked_in` | `completed` (recepcionado y completado) |
| `cancelled` | `cancelled` |
| `archived` | Ninguno. Filmo nunca produce este valor: un pedido archivado deja de ser visible para la API, no aparece en los listados y su GET responde 404 |

Para filtrar por varios grupos a la vez, usa [`statuses`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders#param-statuses), una lista de hasta 50 valores que devuelve lo que coincida con cualquiera de ellos.

## Facturas

**Estados de factura y de presupuesto**
- status de la factura: draft (Un borrador.); validated (Validada y numerada.); voided (Anulada.)
- paymentStatus de la factura: unpaid (Nada cobrado todavía (también para facturas sin cobro registrado).); partially_paid (Cobrada en parte.); paid (Cobrada por completo.); overpaid (Cobrado por encima del total.); overdue (Vencida y sin cobrar.); voided (El documento está anulado.)
- status del presupuesto: draft (Un borrador.); validated (Validado y numerado.)
- operativeStatus del presupuesto: pending (A la espera de respuesta.); confirmed (Aceptado.); cancelled (Rechazado o cancelado.); superseded (Sustituido por otra versión.)
- Los dos estados de cada documento son independientes: uno dice en qué punto del ciclo está el documento y el otro, cómo va su cobro o su respuesta comercial.

Una factura tiene dos campos. `status` es el ciclo de vida del documento; `paymentStatus` es el estado del pago. El filtro de lista [`paymentStatus`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-invoices#param-paymentStatus) usa los mismos valores que devuelve el campo `paymentStatus`, y [`GET /api/v1/invoices`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-invoices) devuelve únicamente documentos de tipo factura.

| Campo | Valor | Significado |
| --- | --- | --- |
| `status` | `draft` | Aún sin validar |
| `status` | `validated` | Validada y numerada |
| `status` | `voided` | Anulada |
| `paymentStatus` | `unpaid` | Todavía no se ha cobrado nada, también en facturas sin un cobro registrado |
| `paymentStatus` | `partially_paid` | Parte del total cobrado |
| `paymentStatus` | `paid` | Cobrado por completo |
| `paymentStatus` | `overpaid` | Cobrado por encima del total |
| `paymentStatus` | `overdue` | Vencido y sin pagar |
| `paymentStatus` | `voided` | El documento se anula, sea cual sea lo cobrado antes |

## Presupuestos

Un presupuesto también tiene dos campos, y el detalle aplana la versión activa del presupuesto. `status` es el ciclo de vida del documento de esa versión; `operativeStatus` es el estado comercial, y [`PATCH /api/v1/quotes/{quoteId}/status`](https://docs.filmo.io/es/rest-api/endpoint-reference/quotes/change-the-commercial-status-of-a-quote) lo cambia. Confirmar una versión deja las demás como `superseded`.

| Campo | Valor | Significado |
| --- | --- | --- |
| `status` | `draft` | Aún sin validar |
| `status` | `validated` | Validada y numerada |
| `operativeStatus` | `pending` | A la espera de respuesta |
| `operativeStatus` | `confirmed` | Aceptado |
| `operativeStatus` | `cancelled` | Rechazado o cancelado |
| `operativeStatus` | `superseded` | Sustituido por otra versión |

## Todos los enums de estado

Esta tabla se genera a partir de la especificación y lista los enums de estado de todos los recursos, incluidos proyectos, tareas, contratos y el resto.

| Campo | Valores |
| --- | --- |
| `ContactDto.status` | `active`, `inactive`, `archived` |
| `ContactDetailDto.status` | `active`, `inactive`, `archived` |
| `RelatedContactDto.status` | `active`, `inactive`, `archived` |
| `OrderDto.status` | `draft`, `reserved`, `prepared_partially`, `prepared`, `picked_up_partially`, `picked_up`, `returned_partially`, `returned`, `checked_in_partially`, `checked_in`, `archived`, `cancelled` |
| `OrderDetailDto.status` | `draft`, `reserved`, `prepared_partially`, `prepared`, `picked_up_partially`, `picked_up`, `returned_partially`, `returned`, `checked_in_partially`, `checked_in`, `archived`, `cancelled` |
| `OrderLineDto.status` | `draft`, `reserved`, `prepared`, `picked_up`, `sold`, `returned`, `checked_in`, `cancelled`, `lost` |
| `InvoiceDto.status` | `draft`, `validated`, `voided` |
| `InvoiceDto.paymentStatus` | `unpaid`, `partially_paid`, `paid`, `overpaid`, `overdue`, `voided` |
| `InvoiceDetailDto.status` | `draft`, `validated`, `voided` |
| `InvoiceDetailDto.paymentStatus` | `unpaid`, `partially_paid`, `paid`, `overpaid`, `overdue`, `voided` |
| `QuoteDto.status` | `draft`, `validated` |
| `QuoteDto.operativeStatus` | `pending`, `confirmed`, `cancelled`, `superseded` |
| `QuoteDetailDto.status` | `draft`, `validated` |
| `QuoteDetailDto.operativeStatus` | `pending`, `confirmed`, `cancelled`, `superseded` |
| `ProjectDto.status` | `draft`, `budgeted`, `confirmed`, `in_progress`, `invoiced`, `completed`, `cancelled`, `archived` |
| `ProjectDetailDto.status` | `draft`, `budgeted`, `confirmed`, `in_progress`, `invoiced`, `completed`, `cancelled`, `archived` |
| `RepairTicketDto.status` | `draft`, `sent`, `partially_converted`, `fully_invoiced`, `closed` |
| `RepairTicketDetailDto.status` | `draft`, `sent`, `partially_converted`, `fully_invoiced`, `closed` |
| `VehicleDto.status` | `active`, `maintenance`, `inactive` |
| `SubrentDto.status` | `pending`, `active`, `completed`, `cancelled` |
| `PurchaseOrderDto.status` | `draft`, `pending`, `completed`, `cancelled` |
| `ContractDto.status` | `draft`, `validated`, `voided` |
| `ContractDto.operativeStatus` | `pending`, `signed`, `cancelled` |
| `OpportunityDto.status` | `open`, `won`, `lost` |
| `OpportunityDetailDto.status` | `open`, `won`, `lost` |
| `TreasuryAccountDto.status` | `active`, `needs_reauth`, `disconnected`, `archived` |
| `CreditNoteDto.status` | `draft`, `validated`, `voided` |
| `OrderLineReturnResultDto.status` | `returned`, `failed` |
| `UserDto.status` | `active`, `pending`, `inactive` |

---

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