Skip to main content

Prerequisites

Before installing the Stock Request module, ensure your environment meets these requirements:

Odoo Version

Odoo 18.0 or compatible version

Required Modules

The stock module must be installed (comes standard with Odoo)

User Permissions

Administrator access to install modules

Git Access

Access to OCA repositories (for source installation)

Installation Methods

Module Installation

Core Module Installation

1

Access the Apps menu

Log in to Odoo with administrator privileges and navigate to Apps.
2

Search for Stock Request

Remove the “Apps” filter and search for “Stock Request”.
You should see multiple modules:
  • Stock Request (core)
  • Stock Request Purchase
  • Stock Request MRP
  • Stock Request Tier Validation
  • And others…
3

Install the core module

Click Install on the “Stock Request” module.The module will install with the following components:
  • Stock Request model (stock.request)
  • Stock Request Order model (stock.request.order)
  • Security groups and access rules
  • Menu items and views
  • Sequence for request numbering
4

Verify installation

After installation completes:
  1. Refresh your browser
  2. Look for the Stock Requests menu in the main menu bar
  3. You should see submenu items: Stock Requests, Stock Request Orders (if enabled)

Optional Modules

Depending on your business needs, install additional modules:

Stock Request Purchase

Enables automatic purchase order creation when stock is not available.
# Module: stock_request_purchase
  • Automatic PO creation from stock requests
  • Link between stock requests and purchase order lines
  • Purchase request tracking
  • Supplier selection based on product configuration

Stock Request MRP

Integrates with Manufacturing to create production orders.
# Module: stock_request_mrp
  • Automatic MO creation for manufactured products
  • Bill of Materials integration
  • Component availability checking
  • Production request tracking

Stock Request Tier Validation

Adds multi-level approval workflows.
# Module: stock_request_tier_validation
# Depends on: base_tier_validation
  • Multi-tier approval configuration
  • Approval status tracking
  • Email notifications for approvers
  • Rejection with comments

Stock Request Kanban

Enhances order management with better organization.
# Module: stock_request_kanban
  • Stock Request Order model always enabled
  • Kanban view for orders
  • Bulk operations on requests
  • Order-level tracking

Post-Installation Configuration

Activate Developer Mode

To access advanced settings:
# Method 1: URL parameter
# Add ?debug=1 to your URL
http://localhost:8069/web?debug=1

Update Module List

After adding the module to your addons path:
1

Activate Developer Mode

Settings → Activate Developer Mode
2

Update Apps List

Apps → Update Apps List
3

Search and Install

Search for “Stock Request” and install

Database Initialization

The module automatically creates:

Sequences

  • Stock Request sequence: SR/XXXXX
  • Stock Request Order sequence: SRO/XXXXX

Security Groups

  • Stock Request / User: Basic user access
  • Stock Request / Manager: Full management access
  • Stock Request Order: Hidden group for order functionality

Record Rules

  • Users can only see their own requests (unless granted access)
  • Managers can see all requests
  • Multi-company rules applied automatically

Verification

Check Installation Status

# Connect to Odoo shell
odoo-bin shell -c /path/to/odoo.conf -d your_database

# Check if module is installed
module = env['ir.module.module'].search([('name', '=', 'stock_request')])
print(f"Module state: {module.state}")
# Expected output: Module state: installed

Test Basic Functionality

1

Navigate to Stock Requests

Main menu → Stock Requests → Stock Requests
2

Create a test request

Click New and fill in:
  • Product: Any stockable product
  • Quantity: 1.0
  • Location: Any internal location
3

Save the request

Click Save - the request should receive a sequence number (e.g., SR/00001)
4

Check state

The request should be in Draft state

Troubleshooting

Solution:
  1. Ensure the module path is correctly added to odoo.conf
  2. Restart the Odoo service
  3. Update the Apps list (Developer Mode required)
  4. Remove the “Apps” filter when searching
Solution:
  1. Ensure the stock module is installed
  2. Check your Odoo version matches the module branch
  3. Update to the latest commit:
    cd stock-logistics-request
    git pull origin 18.0
    
Solution:
  1. Clear your browser cache
  2. Log out and log back in
  3. Check user permissions: Settings → Users & Companies → Users
  4. Ensure the user is assigned to “Stock Request / User” or “Stock Request / Manager” group
Solution:
  1. Go to Settings → Users & Companies → Users
  2. Edit the user
  3. Under “Inventory” tab, add “Stock Request / User” group
  4. Save and refresh

Upgrade Notes

Migrating from Previous Versions

Always backup your database before upgrading modules!
1

Backup your database

pg_dump your_database > backup_$(date +%Y%m%d).sql
2

Update the repository

cd stock-logistics-request
git fetch origin
git checkout 18.0
git pull
3

Upgrade the module

odoo-bin -c /path/to/odoo.conf -d your_database -u stock_request
4

Test the upgrade

  1. Check existing stock requests still load
  2. Create a new test request
  3. Confirm a request and verify procurement works

Next Steps

Configuration

Configure routes, warehouses, and user permissions

Quick Start

Create your first stock request

Build docs developers (and LLMs) love