Maxim

Maxim

Última actualización el Oct 8, 2026

Devuelve las compras de la empresa, de las nuevas a las antiguas por fecha del pedido de compra. Las líneas de las compras no se incluyen en la lista; las devuelve v1/purchases/get_entry.

v1/purchases/get_list.php

Parámetros

Campo Tipo Obligatorio Descripción
date_from string No Compras desde esta fecha de pedido inclusive
date_to string No Compras hasta esta fecha de pedido inclusive
supplier_id int No Solo las compras de este proveedor
limit int No Tamaño de página, de 1 a 1000
offset int No Cuántos registros omitir

Los filtros de fecha funcionan sobre date_placed. Sin parámetros se devuelven todas las compras de la empresa. Consulta la paginación en Reglas generales.

Respuesta

Un array purchases con los campos de la compra:

Campo Tipo Descripción
id int ID de la compra
status int Estado, un código de Cambiar el estado de la compra
payment int Estado de pago, un código de Cambiar el estado de pago
date_placed string Fecha del pedido de compra
date_received string Fecha de recepción. Cadena vacía si no se ha fijado
supplier_id int ID del proveedor
supplier_name string Nombre del proveedor
materials_storage_id int Almacén de materiales
materials_storage_name string Nombre del almacén de materiales
products_storage_id int Almacén de productos
products_storage_name string Nombre del almacén de productos
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
amount float Cantidad total si todas las líneas comparten una unidad, si no null
lines int Número de líneas
notes string Notas

El campo total en la raíz de la respuesta contiene el número total de compras que cumplen los filtros.

Ejemplo de solicitud

{
    "date_from": "2026-10-01",
    "supplier_id": 45,
    "limit": 100,
    "offset": 0
}

Ejemplo de respuesta

{
    "success": true,
    "purchases": [
        {
            "id": 29645,
            "status": 1,
            "payment": 0,
            "date_placed": "2026-10-06",
            "date_received": "",
            "supplier_id": 45,
            "supplier_name": "Maderas García",
            "materials_storage_id": 3998,
            "materials_storage_name": "Almacén principal",
            "products_storage_id": 3998,
            "products_storage_name": "Almacén principal",
            "subtotal": 30000,
            "delivery_price": 1500,
            "discount": 0,
            "total": 31500,
            "amount": null,
            "lines": 2,
            "notes": "Factura n.º 118"
        }
    ],
    "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