Skip to content
Stella ConnectDocs
Parts

Import parts

POST{baseUrl}/v0.1-alpha/parts/import

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
Authx-api-key

multipart/form-data
Field
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[].partIduuidNo

Unique identifier for the part

parts[].partNamestringNo

Name of the part

parts[].measurementUnitstringNo

Unit of measurement for the part's dimensions

parts[].scaleToMeasurementUnitbooleanNo

Whether the part geometry was scaled to match the measurement unit

parts[].grainbooleanNo

Whether grain direction was enforced during nesting

parts[].quantityintegerNo

Quantity of this part requested

sheets[]object[]No

Collection of sheets with their rendered layout images

sheets[].sheetobjectNo

Sheet layout details including dimensions and weight information

sheets[].sheet.sheetIduuidNo

Unique identifier for the sheet

sheets[].sheet.productIdstringNo

Product identifier for the sheet in the material catalog

sheets[].sheet.variantIdstringNo

Product variant identifier

sheets[].sheet.namestringNo

Display name of the sheet material

sheets[].sheet.materialTypestringNo

Material classification (e.g., "Steel", "Aluminum")

sheets[].sheet.weightCategorystringNo

Weight category classification of the material

sheets[].sheet.keepRemnantbooleanNo

Whether the remnant is retained after cutting

sheets[].sheet.remnantCropTypestringNo

How the remnant is cropped (e.g., "VerticalCrop", "HorizontalCrop")

sheets[].sheet.isCoilbooleanNo

Whether the source material is a coil

sheets[].sheet.lengthUnitstringNo

Unit of measure for all length values

sheets[].sheet.weightUnitstringNo

Unit of measure for all weight values

sheets[].sheet.lengthnumberNo

Total length of the sheet

sheets[].sheet.lengthUsednumberNo

Length of the sheet consumed by the nested parts

sheets[].sheet.widthnumberNo

Total width of the sheet

sheets[].sheet.widthUsednumberNo

Width of the sheet consumed by the nested parts

sheets[].sheet.thicknessnumberNo

Sheet thickness

sheets[].sheet.weightnumberNo

Total weight of the sheet

sheets[].sheet.unitPartWeightnumberNo

True weight of one piece of the nested part

sheets[].sheet.unitNestedWeightnumberNo

Nested weight of one piece (accounts for orientation and grain)

sheets[].sheet.unitRectangularWeightnumberNo

Bounding-box weight of one piece of the nested part

sheets[].sheet.totalPartWeightnumberNo

True weight of all nested parts combined

sheets[].sheet.totalRectangularWeightnumberNo

Bounding-box weight of all nested parts combined

sheets[].sheet.numberOfFullSheetsintegerNo

Number of complete full sheets used

sheets[].sheet.numberOfUnitsPerSheetintegerNo

Number of parts nested on a single sheet

sheets[].sheet.numberOfUnitsNestedintegerNo

Total number of part units successfully nested

sheets[].sheet.numberOfSheetsRequiredintegerNo

Total number of sheets required (rounded up)

sheets[].sheet.totalNumberOfSheetsnumberNo

Fractional total number of sheets consumed

sheets[].sheet.totalSheetWeightnumberNo

Total weight of all sheets consumed

sheets[].images[]string[]No

Base64-encoded PNG images of the nested layout on this sheet

sheets[].imageFormatstringNo

MIME type and encoding of the images (e.g., "image/png;base64")

cutLengthnumberNo

Total cut length across all nested parts

measurementUnitstringNo

Unit of measurement for the cut length

Example 200 response
{
  "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"
}