Import parts
Parts are the portable, singular geometry units for use within the Stella Connect ecosystem.
You'll need these if you want to perform a Nest, for example. If you use a file that has multiple parts (separate closed contours) we will attempt to extract all of the individual parts contained within that file.
File types supported:
- DXF
- DWG
x-api-keymultipart/form-dataField | Type | Required |
|---|---|---|
| files[] | file[] | Yes |
Status | When |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 413 | The upload exceeded the maximum request body size. |
| 500 | Server Error |
Field | Type | Required | Description |
|---|---|---|---|
| parts[] | object[] | No | Collection of parts included in the nest |
| parts[]. | uuid | No | Unique identifier for the part |
| parts[]. | string | No | Name of the part |
| parts[]. | string | No | Unit of measurement for the part's dimensions |
| parts[]. | boolean | No | Whether the part geometry was scaled to match the measurement unit |
| parts[]. | boolean | No | Whether grain direction was enforced during nesting |
| parts[]. | integer | No | Quantity of this part requested |
| sheets[] | object[] | No | Collection of sheets with their rendered layout images |
| sheets[]. | object | No | Sheet layout details including dimensions and weight information |
| sheets[]. | uuid | No | Unique identifier for the sheet |
| sheets[]. | string | No | Product identifier for the sheet in the material catalog |
| sheets[]. | string | No | Product variant identifier |
| sheets[]. | string | No | Display name of the sheet material |
| sheets[]. | string | No | Material classification (e.g., "Steel", "Aluminum") |
| sheets[]. | string | No | Weight category classification of the material |
| sheets[]. | boolean | No | Whether the remnant is retained after cutting |
| sheets[]. | string | No | How the remnant is cropped (e.g., "VerticalCrop", "HorizontalCrop") |
| sheets[]. | boolean | No | Whether the source material is a coil |
| sheets[]. | string | No | Unit of measure for all length values |
| sheets[]. | string | No | Unit of measure for all weight values |
| sheets[]. | number | No | Total length of the sheet |
| sheets[]. | number | No | Length of the sheet consumed by the nested parts |
| sheets[]. | number | No | Total width of the sheet |
| sheets[]. | number | No | Width of the sheet consumed by the nested parts |
| sheets[]. | number | No | Sheet thickness |
| sheets[]. | number | No | Total weight of the sheet |
| sheets[]. | number | No | True weight of one piece of the nested part |
| sheets[]. | number | No | Nested weight of one piece (accounts for orientation and grain) |
| sheets[]. | number | No | Bounding-box weight of one piece of the nested part |
| sheets[]. | number | No | True weight of all nested parts combined |
| sheets[]. | number | No | Bounding-box weight of all nested parts combined |
| sheets[]. | integer | No | Number of complete full sheets used |
| sheets[]. | integer | No | Number of parts nested on a single sheet |
| sheets[]. | integer | No | Total number of part units successfully nested |
| sheets[]. | integer | No | Total number of sheets required (rounded up) |
| sheets[]. | number | No | Fractional total number of sheets consumed |
| sheets[]. | number | No | Total weight of all sheets consumed |
| sheets[]. | string[] | No | Base64-encoded PNG images of the nested layout on this sheet |
| sheets[]. | string | No | MIME type and encoding of the images (e.g., "image/png;base64") |
| cutLength | number | No | Total cut length across all nested parts |
| measurementUnit | string | No | Unit of measurement for the cut length |
{
"parts": [
{
"partId": "08fcc2e5-7760-493b-b8f1-1ad26fcb0a9e",
"partName": "string",
"measurementUnit": "string",
"scaleToMeasurementUnit": true,
"grain": true,
"quantity": 0
}
],
"sheets": [
{
"sheet": {
"sheetId": "1c65aa74-73fc-4fac-b8af-41acabfc39cc",
"productId": "string",
"variantId": "string",
"name": "string",
"materialType": "string",
"weightCategory": "string",
"keepRemnant": true,
"remnantCropType": "string",
"isCoil": true,
"lengthUnit": "string",
"weightUnit": "string",
"length": 0.1,
"lengthUsed": 0.1,
"width": 0.1,
"widthUsed": 0.1,
"thickness": 0.1,
"weight": 0.1,
"unitPartWeight": 0.1,
"unitNestedWeight": 0.1,
"unitRectangularWeight": 0.1,
"totalPartWeight": 0.1,
"totalRectangularWeight": 0.1,
"numberOfFullSheets": 0,
"numberOfUnitsPerSheet": 0,
"numberOfUnitsNested": 0,
"numberOfSheetsRequired": 0,
"totalNumberOfSheets": 0.1,
"totalSheetWeight": 0.1
},
"images": [
"string"
],
"imageFormat": "string"
}
],
"cutLength": 0.1,
"measurementUnit": "string"
}