Maxim

Maxim

Última actualización el Oct 21, 2026

Modifica una venta. Solo se cambian los campos que envías, el resto se queda como estaba.

v1/orders/edit.php

Parámetros

Campo Tipo Obligatorio Descripción
order_id int Sí ID de la venta
num string No Número de venta sin el prefijo
products array No Líneas de productos. Reemplazan las líneas actuales por completo
materials array No Líneas de materiales. Reemplazan las líneas actuales por completo
customer_id int No ID del cliente
customer_name string No Nombre del cliente y los campos customer_
date_placed string No Fecha de la venta
date_shipped string No Fecha de envío. Una cadena vacía la borra
products_storage_id int No Almacén de productos
materials_storage_id int No Almacén de materiales
production int No 1 activa la producción bajo pedido, 0 la desactiva
delivery_price float No Coste de envío
discount float No Descuento
notes string No Notas

El estado y el estado de pago no se cambian con este método; usa v1/orders/update_status y v1/orders/update_payment.

Líneas de la venta

Las líneas se envían en los array products y materials. Si se envía al menos uno de los array, las líneas se reemplazan por completo, y el array que no se envía se considera vacío. Si no se envía ninguno, las líneas no cambian.

Campo Tipo Obligatorio Descripción
id int id o sku ID del producto o del material
sku string id o sku SKU. Un producto también se busca por sus SKU alternativos
amount float Sí Cantidad
total float Sí Total de la línea (no el precio por unidad)
notes string No Comentario de la línea

Las líneas de la respuesta de v1/orders/get_entry se pueden reenviar sin cambios.

Ejemplo de solicitud

Añadir un descuento y cambiar las notas sin tocar las líneas ni el cliente:

{
    "order_id": 43727,
    "discount": 1500,
    "notes": "Descuento por código promocional"
}

Reemplazar las líneas de la venta:

{
    "order_id": 43727,
    "products": [
        {
            "sku": "P001",
            "amount": 3,
            "total": 39000
        }
    ]
}

Ejemplo de respuesta

{
    "success": true
}

Errores

Error Motivo
No order_id in input Falta order_id
Order not found or access denied Venta no encontrada o eliminada
Products is not an array products no es un array (igual para materials)
No products or materials in input Se enviaron products y materials vacíos
Materials in orders are disabled in company settings Se enviaron materiales, pero el ajuste Permitir el pedido de materiales está desactivado
All products have wrong SKU or id No se encontró ninguna línea (con materiales, "All products and materials have wrong SKU or id")
Storage ID is not set Se envió un almacén vacío
Storage ID not found Almacén no encontrado o eliminado
Date is not a valid date in format YYYY-MM-DD Fecha no válida
Invalid delivery_price value. Must be a number, 0 or greater El coste de envío no es un número o es menor que 0
Invalid discount value. Must be a number, 0 or greater El descuento no es un número o es menor que 0
Customer not found El cliente de customer_id no se encontró o está eliminado
Customer name must not be empty customer_name vacío

Los errores de líneas individuales (sin amount o total, cantidad no válida) son los mismos que en v1/orders/add.