Devuelve los datos de una venta, el cliente y las líneas de la venta.

```
v1/orders/get_entry.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| order_id | int | Sí | ID de la venta |

## Respuesta

Un objeto order con 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](https://developers.controlata.com/hc/api-docs/articles/api-orders-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-orders-update-payment-es) |
| 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 |

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

Campos de la línea:

| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del producto o del material |
| 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 venta, 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 venta.

Las líneas de la respuesta se pueden enviar a [v1/orders/edit](https://developers.controlata.com/hc/api-docs/articles/api-orders-edit-es) sin cambios: los campos de más se ignoran.

## Ejemplo de solicitud

```
{
    "order_id": 43727
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "order": {
        "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": "",
        "products": [
            {
                "id": 815,
                "sku": "P001",
                "name": "Mesa de roble",
                "amount": 2,
                "unit": "ud",
                "total": 26000,
                "price": 13000,
                "cost": 15400,
                "position": 0,
                "notes": "Grabado: Ana"
            },
            {
                "id": 816,
                "sku": "P002",
                "name": "Taburete de roble",
                "amount": 1,
                "unit": "ud",
                "total": 4500,
                "price": 4500,
                "cost": 2400,
                "position": 1,
                "notes": ""
            }
        ],
        "materials": []
    }
}
```

## Errores

| Error | Motivo |
|---|---|
| No order_id in input | Falta order_id |
| Order not found or access denied | Venta no encontrada o eliminada |
