Maxim

Maxim

Última actualización el Oct 21, 2026

Crea una producción. Controlata calcula el consumo de materiales, productos usados y recursos a partir de los componentes del producto; no lo envías tú.

v1/production/add.php

Parámetros

Campo Tipo Obligatorio Descripción
products array Sí Productos a fabricar, ver abajo
date string No Fecha de producción, YYYY-MM-DD. Por defecto hoy
name string No Nombre
notes string No Notas
produce_subproducts int No 1: producir los semielaborados junto con los productos, 0: descontarlos del almacén ya hechos. Por defecto según el ajuste de la empresa
materials_storage_id int No Almacén del que se descuentan los materiales. 0: elegir automáticamente
subproducts_storage_id int No Almacén del que se descuentan los productos usados. 0: elegir automáticamente
products_storage_id int No Almacén al que entran los productos fabricados

Línea products:

Campo Tipo Obligatorio Descripción
id int id o sku ID del producto
sku string id o sku SKU del producto
amount float Sí Cantidad, mayor que 0
notes string No Comentario de la línea

Un producto se indica por id o sku (también se busca por SKU alternativos). El mismo producto se puede indicar en varias líneas.

Una producción nueva se crea con el estado del ajuste Estado por defecto de las nuevas producciones.

Ejemplo de solicitud

{
    "date": "2026-10-06",
    "name": "Lote de mesas",
    "products": [
        {
            "id": 512,
            "amount": 10,
            "notes": "Dos capas de aceite"
        },
        {
            "sku": "P-CHAIR-01",
            "amount": 40
        }
    ],
    "materials_storage_id": 3998,
    "products_storage_id": 4001,
    "produce_subproducts": 1
}

Ejemplo de respuesta

{
    "success": true,
    "production_id": 39978,
    "num": 152,
    "status": 0
}

La respuesta devuelve el ID, el número y el código de estado de la nueva producción.

Errores

Error Motivo
No products in input products falta o es un array vacío
Products is not an array products no es un array
Line 0 of products must be an object Una línea de products no es un objeto (en lugar de 0, el número de línea)
SKU or id not set for product 0 La línea no tiene ni id ni sku
Product with id 512 not found Producto no encontrado o eliminado (para un SKU: Product with SKU "P-CHAIR-01" not found)
Amount must be greater than 0 for product with id 512 La cantidad no es un número o no es mayor que 0 tras redondear
Invalid notes value for product with id 512. Must be a string notes de la línea no es una cadena
Notes for product with id 512 are too long: maximum 10000 characters El comentario de la línea supera los 10 000 caracteres
Storage ID is not set Se envió products_storage_id igual a 0
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