Obtener los datos de una compra

Maxim

Maxim

Última actualización el Oct 21, 2026

Devuelve los datos de una compra y sus líneas.

v1/purchases/get_entry.php

Parámetros

Campo Tipo Obligatorio Descripción
purchase_id int Sí ID de la compra

Respuesta

Un objeto purchase 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

Y dos array de líneas de la compra: materials y products.

Campos de la línea:

Campo Tipo Descripción
id int ID del material o del producto
sku string SKU
name string Nombre
amount float Cantidad
unit string Unidad de medida
total float Total de la línea
price float Precio por unidad: total dividido entre amount
cost float Coste de la línea
position int Número de línea en la ficha de la compra, desde 0
notes string Comentario de la línea. Cadena vacía si no hay

La numeración de position es común para ambos array: con ella se restaura el orden de las líneas como en la ficha de la compra.

Las líneas de la respuesta se pueden enviar a v1/purchases/edit sin cambios: los campos de más se ignoran.

Ejemplo de solicitud

{
    "purchase_id": 29645
}

Ejemplo de respuesta

{
    "success": true,
    "purchase": {
        "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",
        "materials": [
            {
                "id": 2051,
                "sku": "M010",
                "name": "Tablón de roble",
                "amount": 0.2,
                "cost": 27300,
                "unit": "m3",
                "position": 0,
                "total": 26000,
                "price": 130000,
                "notes": "Comprobar el grosor"
            },
            {
                "id": 2052,
                "sku": "M011",
                "name": "Cola de carpintero",
                "amount": 10,
                "cost": 4200,
                "unit": "kg",
                "position": 1,
                "total": 4000,
                "price": 400,
                "notes": ""
            }
        ],
        "products": []
    }
}

Errores

Error Motivo
No purchase_id in input Falta purchase_id
Purchase not found or access denied Compra no encontrada o eliminada