Maxim

Maxim

Última actualización el Nov 3, 2026

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