API de nesting para trazado de marcadas
Sí — existe una API para el trazado de marcadas. Colocar las piezas de patrón sobre un rollo de tela, piel o textil técnico de modo que la marcada sea lo más corta posible es un problema de nesting por forma real con una dimensión libre, y la CutOptim Engine API lo resuelve por HTTP en POST /v1/optimize/nest. Su PLM, ERP o software de fabricación bajo pedido envía los contornos de las piezas y el ancho del rollo en JSON y recibe una marcada: la posición de cada pieza y la longitud que necesita — para confección, tapicería, marroquinería y textiles técnicos.
Esto funciona hoy como el modo marker del endpoint de nesting: una fila de material con roll: true y sin h. El mismo motor de forma real que anida chapas anida las piezas; solo cambia el material, de una plancha de tamaño fijo a un rollo de ancho fijo y longitud libre.
Todos los formatos, motores, límites y ejemplos de código para desarrolladores: API de nesting de CutOptim
{
"parts": [
{ "name": "front",
"polygon": [[0,0],[560,0],[560,700],[420,760],[140,760],[0,700]],
"qty": 2, "allowedRotations": [0,180] },
{ "name": "sleeve",
"polygon": [[0,0],[480,0],[420,560],[60,560]],
"qty": 4, "allowedRotations": [0,180] },
{ "name": "collar",
"polygon": [[0,0],[500,0],[500,80],[0,80]],
"qty": 2, "allowedRotations": [0,180] }
],
"stock": [{ "w": 1585, "roll": true }],
"options": { "minSeparation": 3, "edgeClearance": 5 }
}El nesting no está incluido en la demo pública — ejecuta este ejemplo con una clave de prueba gratuita. Crear una clave de prueba gratuita
- Disponible hoy en
POST /v1/optimize/nest— modo marker, con una fila de material roll (w yroll: true, sin h). - Devuelve UNA plancha cuyo h es la longitud de marcada más corta encontrada, con la distancia al borde — también en
metrics.length. - Piezas de forma real: polígonos (con agujeros), o archivos SVG y DXF mediante
parts[].source. - Hilo y pelo:
allowedRotations[0, 180] por pieza conserva la dirección;options.minSeparationyoptions.edgeClearancefijan las separaciones. stock[].maxLengthlimita la marcada (como máximo 200000); las piezas que no caben van a unplaced, nunca a una segunda plancha.- lbf responde de forma síncrona para el presupuesto; max es asíncrono (202, luego se consulta
GET /v1/jobs/{id}) y solo puede acortar la marcada lbf. - Validación gratuita:
POST /v1/validate/nestcomprueba un trabajo sin clave y sin cuota.
Un rollo no es una plancha
Una plancha tiene dos lados fijos, y la pregunta es cuántas planchas necesita un trabajo. Un rollo tiene un solo lado fijo — el ancho — y la pregunta es cuánta longitud consumen las piezas. Envíe una fila de material con w y roll: true, sin h, y el nesting devuelve UNA plancha de ancho w cuyo h es la longitud más corta encontrada, con la distancia al borde incluida en ambos extremos; la misma cifra está en metrics.length. La longitud del rollo es lo que se compra, así que es el número que necesita un presupuesto.
Qué envía y qué devuelve
Envíe cada pieza de patrón como polígono (con agujeros opcionales), o como SVG o DXF mediante parts[].source, con una cantidad. La respuesta da cada colocación como una transformación rígida (un giro en grados, luego una traslación x/y), la longitud de la marcada y cualquier pieza que no cupo, en unplaced. Cualquier objeto meta — su referencia de modelo, talla u orden de corte — vuelve tal cual en cada copia colocada, de modo que la marcada concilia con su propio sistema.
Hilo, pelo y separaciones
allowedRotations se fija por pieza: [0, 180] conserva la dirección del hilo o del pelo y aun así permite girar la pieza de punta a punta, mientras que una lista más larga o "continuous" sirve para un material sin dirección. options.minSeparation fija la separación entre piezas y options.edgeClearance la separación en los bordes del rollo. Un stock[].maxLength opcional limita la marcada a una longitud que usted elija (como máximo 200000 en su unidad): las piezas que no caben dentro se devuelven en unplaced, y un rollo nunca se convierte en una segunda plancha.
Al instante para el presupuesto, max para la orden de corte
El motor lbf por defecto responde de forma síncrona — determinista y dentro de la petición, lo bastante rápido para presupuestar una marcada mientras el cliente espera. Para la orden de corte, envíe el mismo cuerpo con engine: "max" y consulte GET /v1/jobs/{id}: parte de la marcada lbf y dedica el presupuesto de tiempo que usted fije (options.timeBudgetMs) a una búsqueda por franjas que puede acortarla y nunca la alarga. La respuesta tiene la misma forma en ambos casos, y una línea warnings indica la longitud y, con max, si la búsqueda la acortó.
Un resumen de dos páginas (PDF en inglés): el problema, qué envías y qué recibes, una solicitud y una respuesta, y cómo construir sobre el motor. Listo para imprimir, con un QR que vuelve a esta página.
Preguntas frecuentes
¿Existe una API para el trazado de marcadas?
POST /v1/optimize/nest. Envía cada pieza como polígono (o SVG o DXF) más una fila de material con el ancho del rollo y roll: true, y recibe una marcada: la posición de cada pieza y su longitud. Funciona en producción hoy, para confección, tapicería, piel y textiles técnicos.¿Cómo se decide la longitud de la marcada?
engine: "max" el trabajo se ejecuta de forma asíncrona: parte de esa marcada lbf, dedica options.timeBudgetMs a buscar una franja más corta y nunca devuelve una más larga. La longitud es el h de la única plancha devuelta, con la distancia al borde, y se repite en metrics.length.¿Puedo mantener la dirección del hilo o del pelo?
allowedRotations por pieza: [0, 180] mantiene la pieza sobre el hilo y le permite girar de punta a punta, y un solo ángulo la fija por completo. Las piezas de un material sin dirección pueden llevar una lista de ángulos más larga o "continuous". options.minSeparation y options.edgeClearance fijan la separación entre piezas y en los bordes del rollo.¿Puedo limitar la longitud de la marcada?
stock[].maxLength limita la marcada a una longitud que usted elija, como máximo 200000 en su unidad. Las piezas que no caben dentro se devuelven en unplaced — un rollo nunca se convierte en una segunda plancha — para que vea lo que sobra y decida qué hacer con ello.¿Hace escalado de tallas, casado de cuadros o planificación del tendido?
¿Cuánta tela ahorra?
POST /v1/validate/nest comprueba un trabajo gratis, sin clave y sin cuota.