Crea una baja de materiales y productos del almacén.
v1/writeoffs/add.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| num | string | Sí | Número |
| materials | array | materials o products | Materiales a dar de baja: id o sku y amount |
| products | array | materials o products | Productos a dar de baja: id o sku y amount |
| date | string | No | Fecha de la baja, YYYY-MM-DD. Por defecto hoy |
| materials_storage_id | int | No | Almacén del que se dan de baja los materiales. Por defecto el almacén de bajas de los ajustes de la empresa |
| products_storage_id | int | No | Almacén del que se dan de baja los productos. Por defecto el almacén de bajas de los ajustes de la empresa |
| notes | string | No | Notas |
Línea materials y products:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | int | id o sku | ID del material o del producto |
| sku | string | id o sku | SKU |
| amount | float | Sí | Cantidad, mayor que 0 |
| notes | string | No | Comentario de la línea |
Un material o producto se indica por id o sku. Hace falta al menos una línea en uno de los array.
Una baja nueva se crea con el estado del ajuste Estado por defecto de las nuevas bajas.
Ejemplo de solicitud
{
"num": "48",
"date": "2026-10-06",
"materials": [
{
"id": 2051,
"amount": 0.15,
"notes": "Defecto: grieta"
}
],
"products": [
{
"sku": "P-TABLE-01",
"amount": 1
}
],
"materials_storage_id": 3998,
"products_storage_id": 4001,
"notes": "Defecto al cortar"
}
Ejemplo de respuesta
{
"success": true,
"writeoff_id": 19291,
"num": "48",
"status": 1
}
La respuesta devuelve el ID, el número y el código de estado de la nueva baja.
Errores
| Error | Motivo |
|---|---|
| No num in input | num falta o está vacío |
| No products or materials in input | No se envió ninguna línea |
| Materials is not an array | materials no es un array (igual para products) |
| Line 0 of materials must be an object | La línea no es un objeto (en lugar de 0, el número de línea) |
| SKU or id not set for material 0 | La línea no tiene ni id ni sku |
| Material with id 2051 not found | Material no encontrado o eliminado (para un producto: Product with SKU "P-TABLE-01" not found) |
| Amount must be greater than 0 for material with id 2051 | La cantidad no es un número o no es mayor que 0 tras redondear |
| Invalid notes value for material with id 2051. Must be a string | notes de la línea no es una cadena |
| Notes for material with id 2051 are too long: maximum 10000 characters | El comentario de la línea supera los 10 000 caracteres |
| Storage ID not found | Almacén no encontrado o eliminado |
| Date is not a valid date in format YYYY-MM-DD | Formato de fecha no válido |