Integración ERP y MES

Esta página es para el ingeniero de integración que conecta Scalarcut a un ERP, MES o controlador de mesa de corte.

El documento Factory MBOM llega a tus sistemas de dos maneras:

• Exportación del planificador: un usuario Enterprise planifica en el planificador y pulsa el botón Factory MBOM para descargar el JSON y el CSV.
• API HTTP: tu middleware obtiene el mismo documento a través del endpoint con clave.

Ambos producen el mismo esquema scalarcut.factory_bom.v1.1; el mapeo de abajo se aplica a ambos.

Elige JSON o CSV

• JSON es el documento completo: cabecera, piezas, recetas, consumibles, totales y geometry opcional. Úsalo cuando tu middleware pueda consumir JSON estructurado.
• CSV es solo la lista de piezas: las columnas planas que puedes soltar directamente en una mesa de corte o una importación de hoja de cálculo. Embalaje, ids, tarifas y totales no están en el CSV.

Ambos describen la misma lista de cortes; el CSV es una proyección con pérdida de las piezas del JSON.

Mapeo de campos

Campo Factory MBOM	Destino típico ERP / MES
schema	Bloqueo de versión de contrato (fija a scalarcut.factory_bom.v1.1)
scene_id / project_id	Clave de orden de producción / orden de trabajo
surface_id	Zona o línea (wall-a…wall-d, floor)
group_id	Clave de enrutamiento estable para un grupo de corte
letter	Leyenda legible de la lista de cortes para el taller
sku	Maestro de materiales / número de artículo
w_mm / h_mm	Dimensiones de corte para la mesa de corte
cut_type	Estrategia de corte / centro de trabajo
qty	Cantidad de pedido para el grupo
fragile	Retención de calidad / indicador de manipulación manual
cre_recycled / cre_parent	Trazabilidad de reciclaje hasta la baldosa de origen
is_l_cut	Enrutamiento de corte en L
rates	Constantes de fórmula de consumibles
totals.cut_qty	Auditoría contra la cabecera de la lista de cortes del plano
totals.boxes_to_order	Cajas a comprar

Obtenciones idempotentes

El endpoint es un GET con ETag. Sondea con If-None-Match para que una nueva solicitud sin cambios devuelva 304 en lugar de reprocesar el documento. Trata la combinación de scene_id/project_id + ETag como tu clave de idempotencia al ingerir en una cola.

Obtener, no empujar

Hay dos vías de entrega. Un usuario puede exportar el documento con el botón de la cabecera del planificador (descarga JSON + CSV). Para la automatización, tu middleware puede obtener el documento a través de la API HTTP bajo demanda: en este release no hay push por webhook. Programa tu sondeo a tu propio ritmo y apóyate en el ETag.

Cortes frágiles

Un corte por debajo del umbral de fragilidad de 50 mm se marca fragile: true. Envíalo a manipulación manual en lugar de a una máquina que lo rompería. Sliver Guard ya intenta reanclar las distribuciones para evitarlos; el indicador es la red de seguridad final.

Consumibles

El adhesivo, la lechada y la imprimación siempre están presentes en los rates y totals de Factory MBOM: es lo contrario del carrito del Online Store Widget, donde los consumibles son una línea opcional del carrito. Mapea rates a tus constantes de fórmula una vez; el documento lleva los kg/L calculados para que no tengas que recalcularlos.

Auditoría

totals.cut_qty debe ser igual a la suma de las qty de las piezas. Al ingerir un documento, concilia totals.cut_qty contra la cabecera de la lista de cortes del plano de la misma escena. Cualquier desviación significa que la distribución cambió entre la exportación y la ingesta: vuelve a obtener antes de liberar a producción.

Recuperar un proyecto por id

Tu middleware obtiene un proyecto por su scene_id (o project_id) junto con tu Enterprise Key. La solicitud está limitada a tu empresa, así que solo recuperas tus propios proyectos. El fixture del garaje es una muestra pública para pruebas de integradores y el panel Try MBOM API, no el único documento que sirve el endpoint.