Maxim

Maxim

Última actualización el Oct 8, 2026

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