Empezar por un producto: envases para un producto
POST /pack-first planifica envases para un producto, o para varios en un embalaje mixto, como hace
Archivo › Empezar por un producto de ParametrIQ (Empezar por un producto): cada forma en que los
productos pueden ir en una caja, de pie o tumbados, cada una con el accesorio interior y la caja exterior que sugieren
las reglas de la biblioteca (o una bandeja con film retráctil), hechos a las medidas que necesita, con su coste y su
encaje en palé, de mejor a peor; y, si se pide, el dibujo de uno de ellos y archivos exportados de él. No se envía
ninguna plantilla: los diseños son los de la propia biblioteca.
La petición
| Campo | Significado |
|---|---|
product |
El producto: shape (Round o Boxed), sus medidas en mm (diameter, o length y width; height), su material (Glass, Pet, Can, Carton u Other), cuántos van en una caja (count) y, si se sabe, lo que pesa uno (weight, kg). |
products |
En lugar de product, un embalaje mixto: una lista de productos como el anterior, cada uno con su propio count. Van en las celdas agrupados, en orden, cada producto en filas (o columnas) enteras, cada celda de la medida de su producto cuando el accesorio interior lo admite (embalajes mixtos). |
play |
Se añade alrededor de cada producto: el interior de una celda es el producto más esto (2 mm si se omite). |
clearance |
Entre el exterior del accesorio interior y el interior de la caja exterior (3 mm si se omite). |
rankBy |
Cheapest (por defecto), LeastBoard o BestPalletFit. |
twoLayers |
Si se ofrecen capas con una plancha separadora entre ellas: dos cuando el número es par, de pie; de dos a cuatro tumbados (true si se omite). |
orientation |
Upright (por defecto), Lying (los productos van tumbados, su altura a lo largo de la caja o a lo ancho) o Either (ambas, ordenadas juntas). Un material que las reglas nunca tumban sigue de pie. |
style |
Case (por defecto) o ShrinkTray: una bandeja baja con los productos dentro y film retráctil alrededor de todo. |
trayWallHeight |
La altura de la pared de una bandeja con film retráctil, en mm (una cuarta parte de la altura del producto, al menos 25, si se omite). |
make |
La posición de un plan en la lista (desde 0): también se devuelve su dibujo. |
exports |
Archivos del dibujo que se devuelven (el de ese plan, o el del primero si se omite make): cada uno un format de /formats y, para un formato que escribe una sola página, una page (véase Exportaciones). |
options |
Cómo se hacen las exportaciones, como las options de /export (margen, colores directos, apariencia…). |
La respuesta
plans, de mejor a peor: cada disposición (celdas a lo largo, a lo ancho y capas, el interior de la celda, lying:
None, AlongLength o AlongWidth), su accesorio interior (null: ninguno; su quantity: uno en cada capa) y los demás que sirven (entre ellos
"None"), su caja exterior y las demás, la plancha separadora (y su quantity: una entre cada dos capas), el diseño
de cada parte, los valores con que se hizo, su exterior, cartón, área (m²) y coste (de uno); lo que contiene la caja exterior,
su interior y su exterior (mm), el área y el coste del cartón en total, si todos los cartones tienen precio en la lista
de precios, y las cajas por capa en un palé de 1200 × 800 (EUR) y de 1200 × 1000 (UK); products, el nombre y el
número de cada producto. Las celdas de un embalaje mixto dimensionadas por producto dan además cellLengths y
cellWidths (el interior de la celda de cada columna y de cada fila, mm; null cuando todas son las de la celda) y
byColumns (los productos colocados columna a columna). Una bandeja con film retráctil tiene además trayWall (la altura de sus paredes, mm) y
film: su area (m², el exterior del envase y un 10 % para el solape), su cost (al precio por m² de Film: shrink
en la lista de precios, incluido en el coste del plan) y si tiene precio (priced). Con make (o exports), drawing
es el dibujo de ese plan como texto de dibujo de ParametrIQ (una página por parte, el montaje, una hoja y la página 3D)
y title su título.
Un producto sin sus medidas, un make que no es la posición de un plan, un formato que no existe o una página que el
dibujo no tiene se rechazan (400).
Exportaciones
Cada elemento de exports se devuelve en exports, en el orden pedido, con su format, la page de la que es, su
tipo de medio (contentType), un fileName, el propio archivo (content, en base64) y sus warnings:
| Formato | Qué escribe |
|---|---|
pdf |
Todas las páginas salvo la página 3D, una página PDF cada una (o solo page, si se indica). |
glb, usdz, step |
La página 3D: la caja exterior plegada alrededor del accesorio interior y los productos, como la hace la vista 3D. |
Cualquier otro (dxf, svg, cf2, dielinepdf…) |
Una página: page (Outer, Fitment, Pad, Assembly, Sheet 1), la de la caja exterior si se omite. |
Ejemplo
POST /pack-first
X-API-KEY: your-api-key
Content-Type: application/json
{
"product": { "shape": "Round", "diameter": 65, "height": 250, "material": "Glass", "count": 6 },
"rankBy": "Cheapest",
"make": 0
}
{
"plans": [
{
"arrangement": "3 × 2", "across": 3, "down": 2, "layers": 1, "turned": false, "lying": "None",
"cell": { "length": 67, "width": 67, "height": 252 },
"fitment": { "design": "Bottle shipper partitions", "values": { "L": 67, "W": 67, "D": 250, "CELLSL": 3, "CELLSW": 2 },
"outside": { "length": 207, "width": 137, "height": 250 }, "board": "B flute (3 mm)",
"boardArea": 0.149, "cost": 0.07, "priced": true, "printed": [ "Long partitions: 1 of 207 × 250; …" ],
"quantity": 1 },
"fitments": [ "Bottle shipper partitions", "Bottle platform insert with hole grid", "Case insert grid", "None" ],
"outer": { "design": "FEFCO 0201 Regular slotted container", "values": { "L": 210, "W": 140, "D": 255 }, "…": "…" },
"outers": [ "FEFCO 0201 Regular slotted container", "Shipping case with carry handle", "…" ],
"pad": null,
"contents": { "length": 207, "width": 137, "height": 252 },
"inside": { "length": 210, "width": 140, "height": 255 },
"outside": { "length": 216, "width": 146, "height": 267 },
"boardArea": 0.414, "cost": 0.19, "priced": true,
"pallets": [ { "pallet": "EUR", "length": 1200, "width": 800, "perLayer": 29, "layers": 6, "total": 174 }, "…" ],
"weight": null, "problems": [], "film": null, "trayWall": null,
"products": [ { "name": "", "count": 6 } ]
}
],
"drawing": "//Product// ParametrIQ …",
"title": "6 × Bottle in a FEFCO 0201 Regular slotted container",
"exports": []
}
Ejemplo: un embalaje mixto, con film retráctil, con sus archivos
POST /pack-first
X-API-KEY: your-api-key
Content-Type: application/json
{
"products": [
{ "name": "Tomatoes", "shape": "Round", "diameter": 73, "height": 110, "material": "Can", "count": 4 },
{ "name": "Beans", "shape": "Round", "diameter": 66, "height": 115, "material": "Can", "count": 2 }
],
"style": "ShrinkTray",
"trayWallHeight": 30,
"exports": [ { "format": "pdf" }, { "format": "dxf", "page": "Outer" }, { "format": "glb" } ]
}
{
"plans": [
{
"arrangement": "3 × 2", "lying": "None", "cell": { "length": 75, "width": 75, "height": 117 },
"fitment": null, "fitments": [ "None" ],
"outer": { "design": "Tray with glued corners", "values": { "L": 228, "W": 153, "D": 30 }, "…": "…" },
"trayWall": 30,
"film": { "area": 0.218, "cost": 0.02, "priced": true },
"products": [ { "name": "Tomatoes", "count": 4 }, { "name": "Beans", "count": 2 } ],
"…": "…"
}
],
"drawing": "//Product// ParametrIQ …",
"title": "6 × Tomatoes + Beans in a Tray with glued corners",
"exports": [
{ "format": "Pdf", "page": null, "contentType": "application/pdf", "fileName": "pack.pdf", "content": "JVBERi0xLjc…", "warnings": [] },
{ "format": "Dxf", "page": "Outer", "contentType": "image/vnd.dxf", "fileName": "pack-outer.dxf", "content": "…", "warnings": [] },
{ "format": "Glb", "page": "3D", "contentType": "model/gltf-binary", "fileName": "pack-3d.glb", "content": "Z2xURg…", "warnings": [] }
]
}
Véase también: API, Exportar, Formatos, Empezar por un producto.