The manual for the New ION Experience has been released.

Check it out! Documentation Index

For the complete documentation index, see llms.txt. This page is also available as Markdown.

The Kit Items Importer

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.