Stock Request (Core) - Stock Request

The stock_request module is the core foundation of the Stock Request framework, enabling users to create internal requests for stock transfers within the Odoo warehouse management system.

Overview

Module Name: stock_request
Version: 18.0.1.1.3
License: LGPL-3
Dependencies: stock
Author: ForgeFlow, OCA
Maintainers: @LoisRForgeFlow, @etobella

This module allows users to request products that are frequently stocked by the company to be transferred to their chosen location.

Key Features

Stock Request Management

Create and manage internal stock requests
Specify product, quantity, and destination location
Track request states: Draft, In Progress, Done, Cancelled
View related stock moves and pickings
Monitor quantity in progress, done, and cancelled

Procurement Integration

Automatic evaluation using procurement rules
Integration with warehouse routes
Support for make-to-order and make-to-stock strategies
Automatic stock move creation upon confirmation

Stock Request Orders

Group multiple stock requests into orders
Manage requests collectively
Order-level tracking and reporting

Permission System

Stock Request User Permissions

Can see their own stock requests
Can view requests they’re granted permission to follow
Can create and update only their own requests
Limited access to other users’ requests

Stock Request Manager Permissions

Full access to all stock requests
Can manage any user’s requests
Can configure system settings
Complete administrative control

Installation

Install Module

Navigate to Apps and search for “Stock Request”. Click Install.

Assign User Groups

Go to Settings > Users & Companies > Users and assign users to:

Stock Request / User group
Stock Request / Manager group

Configure Settings

Navigate to Stock Requests > Settings to configure default options.

Configuration

User Groups

Assign users to the appropriate security groups:

# Security groups defined in stock_request_security.xml
stock_request_group_user
stock_request_group_manager

System Settings

Access stock request settings at Stock Requests > Settings:

Default warehouse configuration
Procurement rule settings
Sequence configuration for request numbering

The module creates automatic sequences for stock request numbering using the format SR/XXXXX.

Usage

Creating a Stock Request

Navigate to Stock Requests

Go to Stock Requests > Stock Requests and click Create.

Fill in Request Details

Product: Select the product to request
Quantity: Enter the quantity needed
Location: Choose the destination location
Expected Date: When you need the products
Requested By: Auto-filled with current user

Confirm the Request

Click Confirm to process the request through procurement rules.

Track Progress

View created transfers via the Transfers button
Monitor quantities: In Progress, Done, Cancelled
Check related stock moves

Stock Request States

State	Description	Actions Available
Draft	Initial state when created	Edit, Confirm, Cancel
In Progress	Confirmed and being fulfilled	View transfers, Cancel
Done	Fully completed	View only
Cancelled	Cancelled by user	Archive

Cancelling Requests

When you cancel a stock request, all related pending stock moves are automatically cancelled.

To cancel a request:

Open the stock request
Click Cancel
Confirm the cancellation
Related stock moves will be cancelled automatically

Data Models

Stock Request (`stock.request`)

Core fields in the stock request model:

# Key fields from stock_request.py
name: Char                    # Request reference number
state: Selection              # Draft, Open, Done, Cancel
product_id: Many2one          # Product being requested
product_qty: Float            # Quantity requested
product_uom_id: Many2one      # Unit of measure
location_id: Many2one         # Destination location
expected_date: Datetime       # Expected delivery date
requested_by: Many2one        # User who created request
order_id: Many2one            # Related stock request order
move_ids: One2many            # Related stock moves
picking_ids: One2many         # Related pickings
qty_in_progress: Float        # Computed quantity
qty_done: Float               # Completed quantity
qty_cancelled: Float          # Cancelled quantity

Stock Request Order (`stock.request.order`)

Groups multiple stock requests:

name: Char                    # Order reference
state: Selection              # Order state
stock_request_ids: One2many   # Related stock requests
expected_date: Datetime       # Expected date for all requests
warehouse_id: Many2one        # Default warehouse

Stock Request Allocation (`stock.request.allocation`)

Tracks how stock requests are allocated to stock moves:

stock_request_id: Many2one    # Related stock request
stock_move_id: Many2one       # Allocated stock move
requested_product_uom_qty: Float  # Allocated quantity

Views and Menus

Stock Requests
├── Stock Requests
│   ├── Stock Requests (All)
│   ├── My Stock Requests
│   └── Stock Request Orders
├── Configuration
│   └── Settings
└── Reporting
    └── Stock Request Analysis

Available Views

Tree View: List of all stock requests with key information
Form View: Detailed request form with related transfers
Kanban View: Visual board grouped by state
Pivot View: Analysis and reporting
Graph View: Request statistics and trends

Integration Points

Procurement Rules

Stock requests integrate with Odoo’s procurement engine:

Evaluated against location-specific procurement rules
Can trigger purchase orders (with stock_request_purchase)
Can trigger manufacturing orders (with stock_request_mrp)
Respects warehouse routing configuration

Stock Moves

Each confirmed request creates stock moves:

Moves linked via stock.request.allocation
Origin field references stock request
Automatic state synchronization
Cancellation cascades to moves

Stock Pickings

Generated transfers are accessible:

Smart button shows picking count
Direct navigation to related pickings
Picking completion updates request quantities

Technical Details

Security

Defined in security/stock_request_security.xml and security/ir.model.access.csv:

Record rules for user-level access
Manager-level full access
Follower-based access control

Data Files

<!-- Sequence configuration -->
data/stock_request_sequence_data.xml

<!-- Security definitions -->
security/stock_request_security.xml
security/ir.model.access.csv

<!-- View definitions -->
views/stock_request_views.xml
views/stock_request_order_views.xml
views/stock_request_allocation_views.xml
views/stock_move_views.xml
views/stock_picking_views.xml
views/product.xml
views/res_config_settings_views.xml
views/stock_request_menu.xml

Model Inheritance

Extends standard Odoo models:

stock.move: Adds stock request allocation tracking
stock.picking: Adds stock request references
product.product: Adds request-related fields
res.config.settings: Adds stock request settings

Known Issues and Roadmap

Archiving Limitation: There is currently no way to archive stock requests and stock request orders. Only cancelled and done requests should be archived in custom implementations.

Active Field Management: The active field needs logical management from orders to individual stock requests.

Common Use Cases

Internal Department Requests

Departments can request stock transfers to their locations:

Production floor requests materials from warehouse
Request confirmed and evaluated
Internal transfer created automatically
Department receives materials

Replenishment Requests

Request stock replenishment when running low:

User notices low stock in their location
Creates stock request for replenishment
Procurement rules determine fulfillment method
Stock transferred or procured as needed

Project-Based Requests

Request materials for specific projects:

Project manager creates stock request
Links request to project location
Materials transferred when confirmed
Project location inventory updated

Best Practices

Expected Dates: Always set realistic expected dates to help warehouse staff prioritize requests.

Location Selection: Choose the most specific destination location to ensure accurate routing and transfers.

Order Grouping: Use Stock Request Orders to group related requests for better organization and processing.

Troubleshooting

Request Stuck in Draft

Problem: Request remains in draft after confirmation.
Solution: Check procurement rules for the destination location. Ensure routes are properly configured.

No Transfers Created

Problem: Request confirmed but no picking generated.
Solution: Verify product has correct routes, check stock availability, ensure procurement rules exist for the location.

Permission Denied

Problem: User cannot see or edit requests.
Solution: Verify user is assigned to Stock Request / User or Stock Request / Manager group.

API Examples

Creating a Stock Request via Code

# Create a stock request programmatically
stock_request = self.env['stock.request'].create({
    'product_id': product.id,
    'product_qty': 10.0,
    'product_uom_id': product.uom_id.id,
    'location_id': location.id,
    'expected_date': fields.Datetime.now(),
    'requested_by': self.env.user.id,
})

# Confirm the request
stock_request.action_confirm()

Querying Stock Requests

# Find all open requests for a product
open_requests = self.env['stock.request'].search([
    ('product_id', '=', product.id),
    ('state', '=', 'open'),
])

# Get requests for current user
my_requests = self.env['stock.request'].search([
    ('requested_by', '=', self.env.user.id),
])

Purchase Integration

Automatically create purchase orders from requests

MRP Integration

Generate manufacturing orders from stock requests

Kanban Cards

Implement lean kanban system for requests

Approval Workflow

Add multi-tier approval process

Get Started

Core Concepts

Modules

Guides

​Overview

​Key Features

​Stock Request Management

​Procurement Integration

​Stock Request Orders

​Permission System

​Installation

​Configuration

​User Groups

​System Settings

​Usage

​Creating a Stock Request

​Stock Request States

​Cancelling Requests

​Data Models

​Stock Request (stock.request)

​Stock Request Order (stock.request.order)

​Stock Request Allocation (stock.request.allocation)

​Views and Menus

​Menu Structure

​Available Views

​Integration Points

​Procurement Rules

​Stock Moves

​Stock Pickings

​Technical Details

​Security

​Data Files

​Model Inheritance

​Known Issues and Roadmap

​Common Use Cases

​Internal Department Requests

​Replenishment Requests

​Project-Based Requests

​Best Practices

​Troubleshooting

​Request Stuck in Draft

​No Transfers Created

​Permission Denied

​API Examples

​Creating a Stock Request via Code

​Querying Stock Requests

​Related Resources

Purchase Integration

MRP Integration

Kanban Cards

Approval Workflow

Build docs developers (and LLMs) love

Overview

Key Features

Stock Request Management

Procurement Integration

Stock Request Orders

Permission System

Installation

Configuration

User Groups

System Settings

Usage

Creating a Stock Request

Stock Request States

Cancelling Requests

Data Models

Stock Request (`stock.request`)

Stock Request Order (`stock.request.order`)

Stock Request Allocation (`stock.request.allocation`)

Views and Menus

Menu Structure

Available Views

Integration Points

Procurement Rules

Stock Moves

Stock Pickings

Technical Details

Security

Data Files

Model Inheritance

Known Issues and Roadmap

Common Use Cases

Internal Department Requests

Replenishment Requests

Project-Based Requests

Best Practices

Troubleshooting

Request Stuck in Draft

No Transfers Created

Permission Denied

API Examples

Creating a Stock Request via Code

Querying Stock Requests

Related Resources