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](https://developers.controlata.com/hc/api-docs/articles/api-orders-update-status-es) y [v1/orders/update_payment](https://developers.controlata.com/hc/api-docs/articles/api-orders-update-payment-es).

## 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](https://developers.controlata.com/hc/api-docs/articles/api-orders-get-entry-es) 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](https://developers.controlata.com/hc/api-docs/articles/api-orders-add-es).
