Obtener los datos de una venta

Maxim

Maxim

Última actualización el Oct 21, 2026

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
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

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 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