Intro to Production Orders

The Rackbeat Production Management API handles manufacturing operations, from setting up Bills of Materials to executing production orders and tracking manufacturing progress. This domain bridges production management and inventory operations.

Core Production Concepts

Bills of Materials (Lots)

Bills of Materials define what components are needed to manufacture a product. In Rackbeat's terminology, these are called "Lots" in the API endpoints, but they function as traditional BOMs.

Key Endpoints:

GET /lots - List bills of materials with filtering
POST /lots - Create new bill of materials
GET /lots/{number} - Get specific BOM details
PUT /lots/{number} - Update BOM configuration
DELETE /lots/{number} - Remove BOM
POST /lots/{lot_number}/copy - Duplicate existing BOM
POST /lots/bulk/barred - Mark multiple BOMs as inactive
POST /lots/bulk/delete - Delete multiple BOMs

What you get: Complete BOM definitions including component lists, quantities, locations, costs, and production settings. Each BOM contains detailed line items with materials, quantities per unit, and location requirements.

BOM Management:

GET /lots/{lot_number}/lines - List BOM components
POST /lots/{lot_number}/add-stock - Add finished goods to inventory

Production Orders

Production orders represent actual manufacturing jobs based on Bills of Materials. They track the execution of manufacturing processes from start to finish.

Key Endpoints:

GET /production-orders - List production orders with status filtering
POST /production-orders - Create new production order
GET /production-orders/{id} - Get detailed production order information
PUT /production-orders/{id} - Update production order
DELETE /production-orders/{id} - Remove production order
POST /production-orders/{productionOrder_number}/copy - Duplicate production order

What you get: Production order tracking with employee assignments, BOM references, production quantities, status tracking (started, finished, cancelled), progress monitoring, and material consumption records.

Filtering Available:

Status filtering (is_finished, is_started, is_cancelled)
Employee assignment (current_employee)
General search (search)

Production Order Lifecycle

Workflow Control:

POST /production-orders/{productionOrder_number}/start - Begin production
POST /production-orders/{productionOrder_number}/cancel - Cancel production order
POST /production-orders/{productionOrder_number}/reopen - Reactivate cancelled order
GET /production-orders/{productionOrder_number}/missing-products - Check material availability

Production Tracking:

POST /production-orders/{productionOrder_number}/registrations - Record production progress
PUT /production-orders/{productionOrder_number}/lots/{productionOrderLot_id} - Update lot quantities
PUT /production-orders/{productionOrder_number}/lots/{productionOrderLot_id}/lines/{productionOrderLotLine_id} - Update individual line items
PUT /production-orders/{productionOrderLotLine_id}/comment - Add production notes

BOM Financial Management

Budgeting and Costing:

GET /lots/{lot_number}/budgets - List BOM budgets
POST /lots/{lot_number}/budgets - Create budget for BOM
POST /lots/{lot_number}/budgets/bulk-create - Create multiple budgets
DELETE /lots/{lot_number}/budgets/delete-all - Remove all budgets
GET /lots/{lot_number}/prices - List BOM pricing by currency
PUT /lots/{lot_number}/prices/{currency} - Update BOM pricing

What you get: Detailed cost breakdowns, budget tracking, and pricing management for manufactured products across multiple currencies.

Location and Inventory Integration

Location Management:

GET /lots/{lot_number}/locations - List BOM locations
GET /lots/{lot_number}/location-settings - Get location-specific BOM settings
PUT /lots/{lot_number}/location-settings/{location} - Update BOM location configuration

What you get: Location-specific production settings, stock requirements, and manufacturing configurations per warehouse or production area.

Production Documentation

Document Generation:

GET /production-orders/{productionOrder_number}/simple-pdf - Generate basic production document
GET /production-orders/{productionOrder_number}/detailed-pdf - Generate comprehensive production document
GET /lots/{lot}/pdf - Generate BOM documentation
POST /lots/{lot}/pdf - Create custom BOM document

What you get: Production documentation for shop floor use, quality control, and record keeping.

Customization and Localization

Custom Fields:

GET /lots/{lot_number}/fields - List custom fields for BOM

Translations:

GET /lots/{lot_number}/translations - List BOM translations
PUT /lots/{lot_number}/translations/{locale} - Update BOM translations

Units of Measure:

GET /lots/{lot_number}/units - List units for BOM
POST /lots/{lot_number}/units - Add unit configuration
PUT /lots/{lot_number}/units/{itemUnit_id} - Update unit settings

Advanced Operations

Bulk Operations:

POST /production-orders/bulk/merge - Merge multiple production orders
POST /lots/bulk/barred - Bulk deactivate BOMs
POST /lots/bulk/delete - Bulk delete BOMs

Media Management:

GET /lots/{lot}/image - Get BOM image
POST /lots/{lot}/image - Upload BOM image
DELETE /lots/{lot}/image - Remove BOM image

Common Response Patterns

Production Order Structure

{
  "number": 1003,
  "employee": {
    "number": 1003,
    "name": "Karsten Produktion",
    "initials": "KP"
  },
  "lots": [
    {
      "id": 3,
      "quantity": 4,
      "produced_quantity": 0,
      "remaining_quantity": 4,
      "lines": [
        {
          "id": 19,
          "single_quantity": 100,
          "total_quantity": 400,
          "total_remaining_quantity": 400,
          "item": {...},
          "location": {...}
        }
      ]
    }
  ],
  "is_started": false,
  "is_finished": false,
  "is_cancelled": false,
  "expected_finished_at": null
}

BOM Line Structure

{
  "lines": [
    {
      "id": 19,
      "single_quantity": 100,
      "total_quantity": 400,
      "total_remaining_quantity": 400,
      "is_flexible": false,
      "comment": "",
      "item": {
        "number": "10003",
        "name": "Raw Material A"
      },
      "location": {
        "number": 1031,
        "name": "Production Area"
      }
    }
  ]
}

Status Tracking

{
  "is_started": true,
  "is_finished": false,
  "is_cancelled": false,
  "started_at": "2024-01-15T08:00:00Z",
  "finished_at": null,
  "cancelled_at": null,
  "expected_finished_at": "2024-01-20T17:00:00Z"
}

Practical Workflows

Setting Up Manufacturing

Create Bills of Materials defining component requirements
Configure location settings for each BOM
Set up budgets and pricing for manufactured products
Import BOM lines for complex assemblies
Generate BOM documentation for production planning

Production Order Process

Create production order from existing BOM
Check missing products before starting production
Start production order to begin manufacturing
Record production registrations to track progress
Update individual lot lines as materials are consumed
Generate production documentation for compliance
Finish or cancel production order based on outcomes

Cost Management Workflow

Create budgets for each BOM to track expected costs
Update pricing by currency for international operations
Monitor actual costs against budgets during production
Use bulk budget operations for seasonal planning
Generate detailed PDFs for cost analysis

Multi-Location Manufacturing

Configure location-specific BOM settings
Set up location requirements for each component
Track production across multiple facilities
Manage inventory consumption by location
Generate location-specific production reports

Integration Considerations

BOM Dependencies: Bills of Materials must be properly configured before creating production orders. The system validates component availability and location settings during production.

Inventory Integration: Production orders directly impact inventory levels through material consumption and finished goods production. Monitor stock levels before starting production.

Employee Assignment: Production orders require employee assignment for tracking and responsibility. Ensure employee records exist before creating production orders.

Location Requirements: Both BOMs and production orders depend heavily on location configuration. Set up warehouse locations and production areas before creating manufacturing definitions.

Document Generation: PDF generation for production documentation requires proper layout configuration in the account management system.