Saltar al contenido principal
← CutOptim Engine APIEngine API · nesting · disponible hoy

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

POST /v1/optimize/nest
{
  "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 y roll: 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.minSeparation y options.edgeClearance fijan las separaciones.
  • stock[].maxLength limita 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/nest comprueba 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ó.

Recurso descargable
One-pager de la API de nesting para trazado de marcadas

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.

PDF2 páginasGratis
Descargar el PDF

Preguntas frecuentes

¿Existe una API para el trazado de marcadas?
Sí. Colocar las piezas de patrón sobre un rollo para que la marcada sea lo más corta posible es el modo marker del endpoint de nesting de la CutOptim Engine API, 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?
El motor lbf coloca las piezas y devuelve la longitud que necesitan, de forma síncrona y determinista. Con 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?
Sí. Fije 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?
Sí. 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?
No. Anida las piezas que usted envía: no escala un patrón a tallas, no casa cuadros ni rayas y no planifica capas ni tendido. Envíe como parts cada talla y cantidad que quiera en la marcada, con un objeto meta para sus propias referencias, y la respuesta le dice dónde va cada copia.
¿Cuánta tela ahorra?
Depende de las piezas y del ancho del rollo, por eso no damos un porcentaje general. La medida honesta es la longitud de la marcada con las mismas piezas y el mismo ancho: ejecute el trabajo, compare la longitud con su marcada actual y compare lbf con max. max nunca devuelve una marcada más larga que lbf. POST /v1/validate/nest comprueba un trabajo gratis, sin clave y sin cuota.

Caso de uso textil y tapicería (app) · Benchmarks