*Workflows › Referencia › Acciones › Pedidos*

# Listar pedidos

> Lista pedidos con los filtros del contrato público: estado, contacto, proyecto, número de pedido, solapamiento de fechas y rangos de creación o actualización.

## De un vistazo

| Propiedad | Valor |
| --- | --- |
| Dominio | `orders` |
| Grupo en el editor | Pedidos › Pedidos |
| Se ejecuta como | El propietario del workflow, con sus permisos |
| Permiso | Acceso de consulta a al menos uno de: Ventas, Pedidos, Entregas. Los administradores siempre pasan; un módulo fuera del plan bloquea a todos. |
| Destructiva | No: el catálogo MCP público no la marca como destructiva |
| También disponible en | API REST, MCP (`filmo_orders_list`) |

ACCIÓN `orders.findMany`

## Entradas

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | number | No |  = `100` |
| `createdOn` | string | No |  |
| `createdAfter` | string | No |  |
| `createdBefore` | string | No |  |
| `createdFrom` | string | No |  |
| `createdTo` | string | No |  |
| `updatedOn` | string | No |  |
| `updatedAfter` | string | No |  |
| `updatedBefore` | string | No |  |
| `updatedFrom` | string | No |  |
| `updatedTo` | string | No |  |
| `status` | enum<string> | No |  `draft`, `reserved`, `prepared`, `in_use`, `returned`, `completed`, `cancelled` |
| `statuses` | string[] | No | Filtra por status, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. `draft`, `reserved`, `prepared`, `in_use`, `returned`, `completed`, `cancelled` |
| `contactId` | string | No |  |
| `contactIds` | string[] | No | Filtra por contactId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. |
| `projectId` | string | No |  |
| `projectIds` | string[] | No | Filtra por projectId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. |
| `overlapsFrom` | string | No |  |
| `overlapsTo` | string | No |  |
| `orderNumber` | string | No |  |
| `orderNumberIs` | string | No |  |
| `orderNumberContains` | string | No |  |
| `startsOn` | string | No |  |
| `startsAfter` | string | No |  |
| `startsBefore` | string | No |  |
| `startsFrom` | string | No |  |
| `startsTo` | string | No |  |
| `endsOn` | string | No |  |
| `endsAfter` | string | No |  |
| `endsBefore` | string | No |  |
| `endsFrom` | string | No |  |
| `endsTo` | string | No |  |

## Salidas

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `items` | object[] |  |
| `items.id` | string |  |
| `items.orderNumber` | string |  |
| `items.externalReference` | string |  |
| `items.status` | enum<string> |  `draft`, `reserved`, `prepared_partially`, `prepared`, `picked_up_partially`, `picked_up`, `returned_partially`, `returned`, `checked_in_partially`, `checked_in`, `archived`, `cancelled` |
| `items.startDate` | string |  |
| `items.endDate` | string |  |
| `items.rentalDays` | number |  |
| `items.projectId` | string |  |
| `items.projectName` | string |  |
| `items.contact` | json |  |
| `items.itemsCount` | number |  |
| `items.subTotalPrice` | string |  |
| `items.discountTotal` | string |  |
| `items.insuranceTotal` | string |  |
| `items.depositTotal` | string |  |
| `items.taxesPrice` | string |  |
| `items.netPrice` | string |  |
| `items.grossPrice` | string |  |
| `items.tags` | string[] |  |
| `items.customFields` | object[] |  |
| `items.customFields.id` | string |  |
| `items.customFields.name` | string |  |
| `items.customFields.value` | json |  |
| `items.source` | string |  |
| `items.createdAt` | string |  |
| `items.updatedAt` | string |  |
| `items.tagRefs` | object[] |  |
| `items.tagRefs.id` | string |  |
| `items.tagRefs.name` | string |  |
| `total` | number |  |
| `nextCursor` | string |  |

---

URL canónica: https://docs.filmo.io/es/workflows/reference/actions/orders-findmany  
Última actualización: 2026-10-25