inventree-print-demand/README.md

InvenTree 3D Print Demand Plugin

Dashboard plugin for InvenTree that shows aggregated demand for 3D printed parts across all open build orders and sales orders.

Features

• Dashboard panel showing all parts from a configured category
• Aggregates stock, allocations, and demand from build and sales orders
• Colour-coded deficit column (red = shortage, green = surplus)
• Configurable part category with optional subcategory inclusion

Installation

cd Projects/02-engineering/inventree/inventree-print-demand
pip install -e .

Then restart InvenTree and enable the plugin in Admin > Plugins.

Configuration

In plugin settings, set:

• Part Category - select the category containing your 3D printed parts
• Include Subcategories - whether to include parts from subcategories (default: true)

API

GET /plugin/print-demand/api/demand/ returns a JSON array of parts sorted by deficit:

[
  {
    "pk": 123,
    "name": "Housing Top",
    "IPN": "MP-001",
    "in_stock": 50,
    "allocated_build": 30,
    "allocated_sales": 10,
    "available": 10,
    "required_build": 45,
    "required_sales": 15,
    "deficit": -10
  }
]