Migration

Migrate from InvenTree

Export relevant InvenTree tables as CSV, preserve filtered scope deliberately, and reconcile parts, locations, and stock.

Export from InvenTree

Open each relevant table and select Download, choose CSV and the built-in InvenTree Exporter, then export. InvenTree applies the current filters, search terms and sort order, but includes every matching record rather than only the visible page. Clear filters for a complete dataset and export the relevant part, stock-location and stock-item tables. See the official data export guide.

InvenTree also supports XLSX and TSV plus plugin-defined exporters. The Itemra source preset is validated against representative CSV from the built-in exporter. Files produced by the Stocktake, Parameter or custom exporters can have different columns and must use generic mapping unless the preview recognizes them explicitly.

Do not upload InvenTree's server-level export-records JSON as a competitor-import file. That backup is intended for migration between compatible InvenTree installations and can contain unrelated database and plugin records.

Supported representative inputs

Provide the relevant built-in-exporter CSV files for parts, stock locations and stock items when all three are required. Multi-entity preservation depends on stable part identity, stable location identity and quantity being present across those exports. Preview files in dependency order so stock references only locations and items that will exist.

The preset targets Itemra items, location paths and opening stock. It does not migrate users, permissions, API tokens, plugins, media, build history, order history or arbitrary plugin models.

Preview before commit

Confirm part name, SKU or other stable source identity, base unit, full location path and quantity. Check parent-child location relationships, variants, serial or lot fields and any plugin-added columns. The preset preserves unknown values as migration metadata and surfaces warnings for review; it does not expose per-column mapping. When an explicit mapping is required, stop and use the generic import wizard for each target kind. Exclude rather than guess when a column's meaning is uncertain.

Reconcile and cut over

Record the InvenTree version, exporter plugin, export time and active filters. Freeze source writes for the final files. Compare part and location counts plus quantity totals per part and location. Sample nested locations, parts split across locations, zero stock, lots and serial-controlled rows. Investigate every rejection before normal Itemra operations begin.

Recovery and replay

Keep the source files, mapping, rejection report and reconciliation result. There is no general undo for committed rows. Rehearse in a fresh tenant and inspect any interrupted job before retrying; asynchronous imports are at-least-once, and replaying a completed stock phase can add opening quantities twice.

Validation and independence

This adapter is covered by synthetic representative CSV fixtures shaped after the documented built-in exporter. Acceptance against exports generated by an Itemra-controlled InvenTree instance is still pending. InvenTree versions and plugins can change the available columns, so schema differences must be reviewed in preview.

InvenTree is a trademark of its owner. Itemra is an independent project and is not affiliated with, endorsed by or sponsored by InvenTree or its contributors. Product names are used only to identify the source format.