InvenTree
Last updated on May 21, 2026
The InvenTree integration writes TofuPilot test data into your InvenTree instance, so build outputs, stock items, and test reports stay in sync with what happens on the factory floor.
Connect InvenTree
You connect InvenTree once per instance using an API token that inherits the permissions of the user that generated it.
In InvenTree, generate an API token under your user profile. The token inherits the user's permissions, so pick a user that can write to the models the workflow touches.
In TofuPilot, open Settings > Integrations > InvenTree and add a connection with the InvenTree base URL and the API token.
Click Test connection to confirm TofuPilot can reach the instance.
Actions
The integration exposes five actions that cover the most common workflow patterns for production data.
| Action | Effect |
|---|---|
| Upload test result | Push a phase or run outcome onto a stock item's test report. |
| Update stock status | Change the status of a stock item (OK, ATTENTION, DAMAGED, etc.). |
| Transfer stock | Move a stock item between locations. |
| Complete build output | Mark a build output as complete. |
| Print label | Trigger a label print via InvenTree. |
Upload test result
Pick a Test name that matches the InvenTree test template on the part, then pull the stock item by serial number from the trigger variables. The action records the test result with a timestamp, the outcome, and any optional attachments.
Update stock status
Pick a stock item by ID or serial number and set the new status. The action writes the new status straight onto the stock item record.
Transfer stock
Pick a stock item by ID or serial number and select the destination location to move it there.
Complete build output
Provide a build ID, and the action marks the matching output complete on that build.
Print label
Provide a label template ID and a stock item ID, and the action triggers a print on a configured InvenTree label printer.
Limits
The InvenTree action inherits TofuPilot's HTTP caps and the per-token throttles your InvenTree instance applies.
- InvenTree's own per-token rate limits apply.
- Action runtime and retries match the HTTP action.
How is this guide?