Feature: Backend scaffolding for Repair Orders (#12064)

src/backend/InvenTree/InvenTree/api_version.py

@@ -1,11 +1,14 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 499
+INVENTREE_API_VERSION = 500
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v500 -> 2026-06-04 : https://github.com/inventree/InvenTree/pull/12072
+    - Adds RepairOrder models and API endpoints
+
 v499 -> 2026-06-01 : https://github.com/inventree/InvenTree/pull/12057
     - Fixes search field issues on the BarcodeScanHistory API endpoint
 

src/backend/InvenTree/generic/states/tests.py

@@ -232,8 +232,8 @@ def test_all_states(self):
         """Test the API endpoint for listing all status models."""
         response = self.get(reverse('api-status-all'))
 
-        # 11 built-in state classes, plus the added GeneralState class
-        self.assertEqual(len(response.data), 12)
+        # 12 built-in state classes, plus the added GeneralState class
+        self.assertEqual(len(response.data), 13)
 
         # Test the BuildStatus model
         build_status = response.data['BuildStatus']
@@ -273,7 +273,7 @@ def test_all_states(self):
         )
         response = self.get(reverse('api-status-all'))
 
-        self.assertEqual(len(response.data), 12)
+        self.assertEqual(len(response.data), 13)
 
         stock_status_cstm = response.data['StockStatus']
         self.assertEqual(stock_status_cstm['status_class'], 'StockStatus')

src/backend/InvenTree/order/admin.py

@@ -208,3 +208,34 @@ class TransferOrderAdmin(admin.ModelAdmin):
         'project_code',
         'responsible',
     ]
+
+
+@admin.register(models.RepairOrder)
+class RepairOrderAdmin(admin.ModelAdmin):
+    """Admin class for the RepairOrder model."""
+
+    list_display = ['reference', 'customer', 'status', 'description']
+
+    search_fields = ['reference', 'customer__name', 'description']
+
+    autocomplete_fields = ['customer']
+
+
+@admin.register(models.RepairOrderLineItem)
+class RepairOrderLineItemAdmin(admin.ModelAdmin):
+    """Admin class for RepairOrderLineItem model."""
+
+    list_display = ['order', 'part', 'quantity']
+
+    search_fields = ['order__reference', 'part__name', 'part__IPN']
+
+    autocomplete_fields = ['order', 'part']
+
+
+@admin.register(models.RepairOrderAllocation)
+class RepairOrderAllocationAdmin(admin.ModelAdmin):
+    """Admin class for RepairOrderAllocation model."""
+
+    list_display = ['line', 'item', 'quantity']
+
+    autocomplete_fields = ['line', 'item']

src/backend/InvenTree/order/api.py

@@ -2513,6 +2513,89 @@ def item_link(self, item):
         return construct_absolute_url(item.get_absolute_url())
 
 
+class RepairOrderList(ListCreateAPI):
+    """API endpoint for accessing a list of RepairOrder objects."""
+
+    queryset = models.RepairOrder.objects.all()
+    serializer_class = serializers.RepairOrderSerializer
+
+
+class RepairOrderDetail(RetrieveUpdateDestroyAPI):
+    """API endpoint for detail view of a single RepairOrder object."""
+
+    queryset = models.RepairOrder.objects.all()
+    serializer_class = serializers.RepairOrderSerializer
+
+
+class RepairOrderLineItemList(ListCreateAPI):
+    """API endpoint for accessing a list of RepairOrderLineItem objects."""
+
+    queryset = models.RepairOrderLineItem.objects.all()
+    serializer_class = serializers.RepairOrderLineItemSerializer
+
+
+class RepairOrderLineItemDetail(RetrieveUpdateDestroyAPI):
+    """API endpoint for detail view of a single RepairOrderLineItem object."""
+
+    queryset = models.RepairOrderLineItem.objects.all()
+    serializer_class = serializers.RepairOrderLineItemSerializer
+
+
+class RepairOrderAllocationList(ListCreateAPI):
+    """API endpoint for accessing a list of RepairOrderAllocation objects."""
+
+    queryset = models.RepairOrderAllocation.objects.all()
+    serializer_class = serializers.RepairOrderAllocationSerializer
+
+
+class RepairOrderAllocationDetail(RetrieveUpdateDestroyAPI):
+    """API endpoint for detail view of a single RepairOrderAllocation object."""
+
+    queryset = models.RepairOrderAllocation.objects.all()
+    serializer_class = serializers.RepairOrderAllocationSerializer
+
+
+repair_order_api_urls = [
+    path(
+        '<int:pk>/',
+        include([
+            path('', RepairOrderDetail.as_view(), name='api-repair-order-detail')
+        ]),
+    ),
+    path('', RepairOrderList.as_view(), name='api-repair-order-list'),
+]
+
+repair_order_line_api_urls = [
+    path(
+        '<int:pk>/',
+        include([
+            path(
+                '',
+                RepairOrderLineItemDetail.as_view(),
+                name='api-repair-order-line-detail',
+            )
+        ]),
+    ),
+    path('', RepairOrderLineItemList.as_view(), name='api-repair-order-line-list'),
+]
+
+repair_order_allocation_api_urls = [
+    path(
+        '<int:pk>/',
+        include([
+            path(
+                '',
+                RepairOrderAllocationDetail.as_view(),
+                name='api-repair-order-allocation-detail',
+            )
+        ]),
+    ),
+    path(
+        '', RepairOrderAllocationList.as_view(), name='api-repair-order-allocation-list'
+    ),
+]
+
+
 order_api_urls = [
     # API endpoints for purchase orders
     path(
@@ -2901,4 +2984,8 @@ def item_link(self, item):
         OrderCalendarExport(),
         name='api-po-so-calendar',
     ),
+    # Repair Order endpoints
+    path('repair/', include(repair_order_api_urls)),
+    path('repair-line/', include(repair_order_line_api_urls)),
+    path('repair-allocation/', include(repair_order_allocation_api_urls)),
 ]

src/backend/InvenTree/order/migrations/0120_repairorder_repairorderlineitem_repairorderallocation.py

@@ -0,0 +1,216 @@
+# Generated by Django 5.2.13 on 2026-06-04 02:30
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+import InvenTree.fields
+import InvenTree.models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ('company', '0077_delete_manufacturerpartparameter'),
+        ('order', '0119_transferorderlineitem_line_int'),
+        ('part', '0146_auto_20251203_1241'),
+        ('stock', '0116_alter_stockitem_link'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='RepairOrder',
+            fields=[
+                (
+                    'id',
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name='ID',
+                    ),
+                ),
+                (
+                    'metadata',
+                    models.JSONField(
+                        blank=True,
+                        help_text='JSON metadata field, for use by external plugins',
+                        null=True,
+                        verbose_name='Plugin Metadata',
+                    ),
+                ),
+                (
+                    'notes',
+                    InvenTree.fields.InvenTreeNotesField(
+                        blank=True,
+                        help_text='Markdown notes (optional)',
+                        max_length=50000,
+                        null=True,
+                        verbose_name='Notes',
+                    ),
+                ),
+                (
+                    'reference',
+                    models.CharField(
+                        help_text='Repair Order Reference',
+                        max_length=100,
+                        unique=True,
+                        verbose_name='Reference',
+                    ),
+                ),
+                (
+                    'description',
+                    models.CharField(
+                        help_text='Repair order description',
+                        max_length=250,
+                        verbose_name='Description',
+                    ),
+                ),
+                (
+                    'symptoms',
+                    models.TextField(
+                        blank=True,
+                        help_text='Reported symptoms or issues',
+                        verbose_name='Symptoms',
+                    ),
+                ),
+                (
+                    'status',
+                    models.IntegerField(
+                        choices=[
+                            (10, 'Pending'),
+                            (20, 'In Progress'),
+                            (25, 'On Hold'),
+                            (30, 'Complete'),
+                            (40, 'Cancelled'),
+                        ],
+                        default=10,
+                        help_text='Repair order status',
+                        verbose_name='Status',
+                    ),
+                ),
+                (
+                    'customer',
+                    models.ForeignKey(
+                        blank=True,
+                        help_text='Customer reference',
+                        limit_choices_to={'is_customer': True},
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name='repair_orders',
+                        to='company.company',
+                        verbose_name='Customer',
+                    ),
+                ),
+            ],
+            options={'verbose_name': 'Repair Order'},
+            bases=(
+                InvenTree.models.InvenTreeAttachmentMixin,
+                InvenTree.models.InvenTreePermissionCheckMixin,
+                InvenTree.models.ContentTypeMixin,
+                InvenTree.models.PluginValidationMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name='RepairOrderLineItem',
+            fields=[
+                (
+                    'id',
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name='ID',
+                    ),
+                ),
+                (
+                    'metadata',
+                    models.JSONField(
+                        blank=True,
+                        help_text='JSON metadata field, for use by external plugins',
+                        null=True,
+                        verbose_name='Plugin Metadata',
+                    ),
+                ),
+                (
+                    'order',
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name='lines',
+                        to='order.repairorder',
+                        verbose_name='Repair Order',
+                    ),
+                ),
+                (
+                    'part',
+                    models.ForeignKey(
+                        blank=True,
+                        help_text='Part to be consumed for repair',
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name='repair_order_line_items',
+                        to='part.part',
+                        verbose_name='Part',
+                    ),
+                ),
+                (
+                    'quantity',
+                    models.DecimalField(
+                        decimal_places=5,
+                        default=1,
+                        help_text='Item quantity required for repair',
+                        max_digits=15,
+                        verbose_name='Quantity',
+                    ),
+                ),
+            ],
+            options={'verbose_name': 'Repair Order Line Item'},
+            bases=(
+                InvenTree.models.ContentTypeMixin,
+                InvenTree.models.PluginValidationMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name='RepairOrderAllocation',
+            fields=[
+                (
+                    'id',
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name='ID',
+                    ),
+                ),
+                (
+                    'line',
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name='allocations',
+                        to='order.repairorderlineitem',
+                        verbose_name='Line Item',
+                    ),
+                ),
+                (
+                    'item',
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name='repair_order_allocations',
+                        to='stock.stockitem',
+                        verbose_name='Stock Item',
+                    ),
+                ),
+                (
+                    'quantity',
+                    models.DecimalField(
+                        decimal_places=5,
+                        default=1,
+                        help_text='Allocated stock quantity',
+                        max_digits=15,
+                        verbose_name='Quantity',
+                    ),
+                ),
+            ],
+            options={'verbose_name': 'Repair Order Allocation'},
+        ),
+    ]