Devuelve las ventas de la empresa, de las nuevas a las antiguas: por fecha de venta y, dentro de una misma fecha, por número. Las líneas de las ventas no se incluyen en la lista; las devuelve v1/orders/get_entry.
v1/orders/get_list.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| date_from | string | No | Ventas desde esta fecha de venta inclusive |
| date_to | string | No | Ventas hasta esta fecha de venta inclusive |
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |
Los filtros funcionan sobre date_placed. Sin parámetros se devuelven todas las ventas de la empresa. Consulta la paginación en Reglas generales.
Respuesta
Un array orders. Cada objeto contiene los campos de la venta:
| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID de la venta |
| num | string | Número de venta con el prefijo |
| status | int | Estado, un código de Cambiar el estado de la venta |
| payment | int | Estado de pago, un código de Cambiar el estado de pago |
| date_placed | string | Fecha de la venta |
| date_shipped | string | Fecha de envío. Cadena vacía si no se ha fijado |
| subtotal | float | Suma de las líneas |
| delivery_price | float | Coste de envío |
| discount | float | Descuento |
| total | float | Total: subtotal más delivery_price menos discount |
| cost | float | Coste de la venta |
| amount | float | Cantidad total si todas las líneas comparten una unidad, si no null |
| lines | int | Número de líneas |
| production | int | 1 si la venta se prepara con producción bajo pedido |
| production_num | string | Número de la producción vinculada, null sin producción |
| source | string | De dónde viene la venta: «manual», «api», «shopify» |
| notes | string | Notas |
| products_storage_id | int | Almacén de productos |
| products_storage_name | string | Nombre del almacén de productos |
| materials_storage_id | int | Almacén de materiales |
| materials_storage_name | string | Nombre del almacén de materiales |
| customer_id | int | ID del cliente |
| customer_name | string | Nombre |
| customer_email | string | Correo electrónico |
| customer_phone | string | Teléfono |
| customer_address_real | string | Dirección de entrega |
| customer_address_legal | string | Dirección fiscal |
| customer_agreement | string | Acuerdo |
| customer_manager_name | string | Responsable |
| customer_manager_post | string | Puesto del responsable |
| customer_notes | string | Notas del cliente |
El campo total en la raíz de la respuesta contiene el número total de ventas que cumplen los filtros.
Ejemplo de solicitud
{
"date_from": "2026-10-01",
"date_to": "2026-10-31",
"limit": 100,
"offset": 0
}
Ejemplo de respuesta
{
"success": true,
"orders": [
{
"id": 43727,
"num": "A-1001",
"status": 3,
"payment": 2,
"date_placed": "2026-10-06",
"date_shipped": "2026-10-08",
"subtotal": 30500,
"delivery_price": 500,
"discount": 1000,
"total": 30000,
"cost": 17800,
"amount": 3,
"lines": 2,
"production": 0,
"production_num": null,
"source": "api",
"notes": "Pedido desde la web",
"products_storage_id": 3998,
"products_storage_name": "Almacén principal",
"materials_storage_id": 3998,
"materials_storage_name": "Almacén principal",
"customer_id": 512,
"customer_name": "Juan Pérez",
"customer_email": "juan@example.com",
"customer_phone": "+34 600 111 222",
"customer_address_real": "C/ Mayor 5, 3º, Madrid",
"customer_address_legal": "",
"customer_agreement": "",
"customer_manager_name": "",
"customer_manager_post": "",
"customer_notes": ""
}
],
"total": 1
}
Errores
| Error | Motivo |
|---|---|
| Date is not a valid date in format YYYY-MM-DD | date_from o date_to no válida |
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Invalid offset value. Must be 0 or greater | offset no válido |
| Offset requires limit | se envió offset sin limit |