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](https://developers.controlata.com/hc/api-docs/articles/api-purchases-update-status-es) |
| payment | int | Estado de pago, un código de [Cambiar el estado de pago](https://developers.controlata.com/hc/api-docs/articles/api-purchases-update-payment-es) |
| 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](https://developers.controlata.com/hc/api-docs/articles/api-purchases-edit-es) 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 |
