Producción

8 artículos Maxim Por Maxim

Producción

Producción: fabricar productos a partir de sus componentes. Envías solo los productos y las cantidades, y Controlata calcula el consumo de materiales, productos usados y recursos a partir de los componentes del producto, y el coste por FIFO. A través de la API puedes crear, editar y eliminar producciones, cambiar el estado, y obtener la lista y los datos de una producción. Las rutas de los métodos se indican respecto a la dirección base de la API; las reglas comunes a todos los métodos (autorización, formato de las solicitudes, edición parcial, paginación) se describen en Descripción general de la API y Reglas generales. Métodos Método Qué hace v1/production/get_statuses Devuelve los estados de producción de la empresa v1/production/add Crea una producción v1/production/edit Modifica una producción v1/production/delete Elimina una producción v1/production/update_status Cambia el estado de la producción v1/production/get_list Devuelve la lista de producciones v1/production/get_entry Devuelve una producción con sus productos y su consumo

Estados de producción

Devuelve los estados de producción de la empresa en el orden en que aparecen en Controlata. Los estados se pueden configurar de forma individual, así que obtén los códigos con este método en lugar de fijarlos en tu integración. v1/production/get_statuses.php Parámetros El método no admite parámetros; el cuerpo de la solicitud se puede omitir. Respuesta Un array statuses. Campo Tipo Descripción code int Código del estado. Se envía como status en v1/production/update_status y v1/production/get_list name string Nombre del estado Los códigos van en orden a partir de 0. Si la empresa no ha configurado estados, se devuelven los predeterminados: Código Estado 0 Planificado 1 En progreso 2 Completado Los estados creados en la empresa llegan con los nombres que se les dieron en Controlata. Ejemplo de solicitud {} Ejemplo de respuesta { "success": true, "statuses": [ { "code": 0, "name": "Planificado" }, { "code": 1, "name": "En progreso" }, { "code": 2, "name": "Completado" } ] } Errores El método solo devuelve los errores comunes de autorización y de límite de solicitudes, consulta Descripción general de la API.

Crear una producción

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

Editar una producción

Modifica una producción. Solo se cambian los campos que envías, el resto se queda como estaba. v1/production/edit.php Parámetros Campo Tipo Obligatorio Descripción production_id int Sí ID de la producción products array No Productos a fabricar: id o sku y amount, como en v1/production/add . Reemplazan los actuales por completo date string No Fecha de producción, YYYY-MM-DD 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 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 El estado no se cambia con este método; usa v1/production/update_status. El número no se puede cambiar. Ejemplo de solicitud { "production_id": 39978, "products": [ { "id": 512, "amount": 12 } ], "notes": "Añadidas dos mesas" } Ejemplo de respuesta { "success": true } Errores Error Motivo No production_id in input Falta production_id Production not found or access denied Producción no encontrada o eliminada Products of a production linked to a sale cannot be changed. Edit the sale instead Cambio de los productos de una producción bajo pedido No products in input Se envió un array products vacío Products is not an array products no es un array Product with id 512 not found Producto no encontrado o eliminado 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 Storage ID is not set Se envió products_storage_id igual a 0, o 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 Formato de fecha no válido Los demás errores de las líneas products son los mismos que en v1/production/add.

Eliminar una producción

Elimina una producción. v1/production/delete.php Parámetros Campo Tipo Obligatorio Descripción production_id int Sí ID de la producción La eliminación no se puede deshacer. Una producción bajo pedido (order_id mayor que 0) no se elimina con este método: desactiva la producción en la venta o elimina la venta, consulta Crear una venta. Ejemplo de solicitud { "production_id": 39978 } Ejemplo de respuesta { "success": true } Errores Error Motivo No production_id in input Falta production_id Production not found or access denied Producción no encontrada o ya eliminada A production linked to a sale cannot be deleted. Edit the sale instead La producción se creó para una venta

Cambiar el estado de la producción

Cambia el estado de la producción. El estado determina si los materiales, los productos usados y los recursos se descuentan y si los productos fabricados entran en el almacén. v1/production/update_status.php Parámetros Campo Tipo Obligatorio Descripción production_id int Sí ID de la producción status int Sí Código de estado de v1/production/get_statuses Ejemplo de solicitud { "production_id": 39978, "status": 2 } Ejemplo de respuesta { "success": true } Errores Error Motivo No production_id in input Falta un campo obligatorio (en lugar de production_id, el nombre del campo) Invalid status value. Must be one of: 0, 1, 2 El código no está en la lista de estados de la empresa. Los códigos permitidos se enumeran en el texto del error Production not found or access denied Producción no encontrada o eliminada

Obtener la lista de producciones

Devuelve las producciones de la empresa, de las nuevas a las antiguas: por fecha y, dentro de una misma fecha, por número. v1/production/get_list.php Parámetros Campo Tipo Obligatorio Descripción date_from string No Producciones desde esta fecha inclusive, YYYY-MM-DD date_to string No Producciones hasta esta fecha inclusive, YYYY-MM-DD status int No Código de estado de v1/production/get_statuses limit int No Tamaño de página, de 1 a 1000 offset int No Cuántos registros omitir Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales. Respuesta Un array production con los campos de la producción (sin los productos ni el consumo, que devuelve Obtener los datos de una producción): Campo Tipo Descripción id int ID de la producción num int Número. Se asigna automáticamente name string Nombre date string Fecha de producción, YYYY-MM-DD status int Código de estado de Estados de producción order_id int ID de la venta para la que se creó la producción. 0 si no está vinculada a una venta produce_subproducts int 1 si los semielaborados se producen junto con los productos materials_storage_id int Almacén del que se descuentan los materiales. 0 si se elige automáticamente materials_storage_name string Nombre del almacén de materiales products_storage_id int Almacén al que entran los productos fabricados products_storage_name string Nombre del almacén de los productos fabricados subproducts_storage_id int Almacén del que se descuentan los productos usados. 0 si se elige automáticamente subproducts_storage_name string Nombre del almacén de los productos usados cost float Coste de toda la producción price float Valor de los productos fabricados a su precio de venta amount float Cantidad total de productos. null si los productos tienen unidades distintas lines int Número de líneas de productos notes string Notas El campo total contiene el número total de producciones que cumplen los filtros. Ejemplo de solicitud { "date_from": "2026-10-01", "status": 0, "limit": 100, "offset": 0 } Ejemplo de respuesta { "success": true, "production": [ { "id": 39978, "num": 152, "name": "Lote de mesas", "date": "2026-10-06", "status": 0, "order_id": 0, "produce_subproducts": 1, "materials_storage_id": 3998, "materials_storage_name": "Principal", "products_storage_id": 4001, "products_storage_name": "Productos terminados", "subproducts_storage_id": 0, "subproducts_storage_name": null, "cost": 184250, "price": 390000, "amount": 50, "lines": 2, "notes": "" } ], "total": 1 } Errores Error Motivo Date is not a valid date in format YYYY-MM-DD date_from o date_to no válida Invalid status value. Must be a number status no es un número Invalid limit value. Must be between 1 and 1000 limit no válido Offset requires limit se envió offset sin limit

Obtener los datos de una producción

Devuelve una producción: sus campos, los productos fabricados y el consumo de materiales, productos usados y recursos. v1/production/get_entry.php Parámetros Campo Tipo Obligatorio Descripción production_id int Sí ID de la producción Respuesta Un objeto production con los campos de la producción: Campo Tipo Descripción id int ID de la producción num int Número. Se asigna automáticamente name string Nombre date string Fecha de producción, YYYY-MM-DD status int Código de estado de Estados de producción order_id int ID de la venta para la que se creó la producción. 0 si no está vinculada a una venta produce_subproducts int 1 si los semielaborados se producen junto con los productos materials_storage_id int Almacén del que se descuentan los materiales. 0 si se elige automáticamente materials_storage_name string Nombre del almacén de materiales products_storage_id int Almacén al que entran los productos fabricados products_storage_name string Nombre del almacén de los productos fabricados subproducts_storage_id int Almacén del que se descuentan los productos usados. 0 si se elige automáticamente subproducts_storage_name string Nombre del almacén de los productos usados cost float Coste de toda la producción price float Valor de los productos fabricados a su precio de venta amount float Cantidad total de productos. null si los productos tienen unidades distintas lines int Número de líneas de productos notes string Notas y cuatro array de líneas. products: los productos fabricados. Campo Tipo Descripción id int ID del producto sku string SKU name string Nombre amount float Cantidad unit string Unidad de medida cost float Coste de la línea price float Valor de la línea al precio de venta del producto notes string Comentario de la línea. Cadena vacía si no hay materials: el consumo de materiales en toda la producción. Si un material se descuenta de varios almacenes, llega una línea aparte por cada uno. Campo Tipo Descripción id int ID del material sku string SKU name string Nombre storage_id int Almacén del que se descontó el material amount float Cantidad unit string Unidad de medida cost float Coste subproducts: los productos usados de los componentes de los que se fabrican. Si los semielaborados se producen (produce_subproducts es 1), no aparecen aquí: en su lugar, el consumo de sus componentes entra en materials y resources. Campo Tipo Descripción id int ID del producto sku string SKU name string Nombre storage_id int Almacén del que se descontó el producto amount float Cantidad unit string Unidad de medida cost float Coste resources: los recursos usados. Campo Tipo Descripción id int ID del recurso name string Nombre type string Tipo de cálculo: «rate» tarifa fija, «percent» porcentaje, «amortized» amortización amount float Cantidad unit string Unidad de medida cost float Coste El array products se puede enviar a v1/production/edit sin cambios. El consumo no se cambia por la API: se calcula a partir de los componentes del producto. Ejemplo de solicitud { "production_id": 39978 } Ejemplo de respuesta { "success": true, "production": { "id": 39978, "num": 152, "name": "Lote de mesas", "date": "2026-10-06", "status": 1, "order_id": 0, "produce_subproducts": 0, "materials_storage_id": 3998, "materials_storage_name": "Principal", "products_storage_id": 4001, "products_storage_name": "Productos terminados", "subproducts_storage_id": 3998, "subproducts_storage_name": "Principal", "cost": 61540, "price": 130000, "amount": 10, "lines": 1, "notes": "", "products": [ { "id": 512, "sku": "P-TABLE-01", "name": "Mesa de comedor", "amount": 10, "unit": "ud", "cost": 61540, "price": 130000, "notes": "Dos capas de aceite" } ], "materials": [ { "id": 2051, "sku": "M010", "name": "Tablón de roble", "storage_id": 3998, "amount": 0.4, "unit": "m3", "cost": 54000 } ], "subproducts": [ { "id": 530, "sku": "P-LEG-01", "name": "Pata de mesa", "storage_id": 3998, "amount": 40, "unit": "ud", "cost": 6000 } ], "resources": [ { "id": 77, "name": "Trabajo del carpintero", "type": "rate", "amount": 20, "unit": "h", "cost": 1540 } ] } } Errores Error Motivo No production_id in input Falta production_id Production not found or access denied Producción no encontrada o eliminada