Kit Items

The Kit Items Importer allows you to efficiently add or update kit items in bulk from a spreadsheet, making it ideal when you need to add many items to one or more kits at once, update quantities for existing kit items, or avoid manual, line-by-line edits in the UI. Imports are atomic, so if any row contains an error, nothing is changed.

Importer Behavior

• Existing items: If the kit already has the part (including revision), the quantity is updated. Already kitted inventory will be preserved.
• New items: If the kit does not already have the part, a new Kit Item is created.
• Revisions: If revision is not filled out, it will select the latest revision for that Part Number.
• Duplicates in the same import: Duplicate rows for the same Kit+Part within an import returns an error.
• Atomicity: Any error prevents all updates and creates. All errors collected from an import will be returned upon a failure.
• Kit Id: No new kits are created with this importer. kit_id is a required value, when left blank the importer will return an error.
• ION Actions: Actions with the PARTKITITEM target are triggered during the import. If the Action raises a ValidationError the standard error toast for Actions will be displayed and the data is not imported.

What You’ll See After Import

Following a successful import, a toast will be shown with the number of items imported - including updates and creates - and links to each of the kits affected by the import.

When the importer encounters an error, the changes will be canceled and a table displaying the errors and the rows they occur on will be shown.