Overview
DBR (Demand-Based Replenishment) Sessions allow you to create and manage store replenishment orders based on calculated demand. Unlike route-based sessions, DBR sessions focus on individual store locations and use demand algorithms to suggest optimal order quantities.This feature is part of the Restock module’s demand-based ordering system. Sessions are saved to the backend and can be loaded, modified, and submitted at any time.
Creating a DBR Session
To create a new DBR session:Select Stores
Choose the stores to include in this session. Stores are grouped by their delivery schedule for easier selection:
- By Delivery Schedule: Monday, Tuesday, Wednesday, etc.
- By Customer: Grouped by customer name
Managing Sessions
Loading an Existing Session
To continue working on a previously saved session:- Click Session Manager in the toolbar
- Browse the list of saved sessions
- Each session card displays:
- Session name
- Status (Draft, In Progress, Completed, Cancelled)
- Creation and last updated dates
- Number of stores included
- Click Load on the session you want to open
Session Status
DBR sessions have the following statuses:| Status | Description |
|---|---|
| Draft | Session created but no quantities entered yet |
| In Progress | Session has quantities being entered or modified |
| Completed | Session finalized and orders submitted to ERP |
| Cancelled | Session cancelled and no longer active |
| Deleted | Session removed from the system |
Session Actions
From the Session Manager, you can perform these actions:Load Session
Opens the session in the orders grid for editing or review.Complete Session
Marks the session as complete and locks it from further edits. Use this when orders have been finalized and submitted.Cancel Session
Cancels the session without submitting orders. The session is preserved for reference but cannot be edited.Delete Session
Permanently removes the session from the system. This action cannot be undone.Export Session
Exports session data to CSV or Excel format for reporting or external processing.Working with Order Items
The Orders Grid
Once a session is loaded, the orders grid displays:- Store Columns: One column per selected store showing order quantities
- Item Details: Product information including item name, description, and attributes
- Demand Metrics: Calculated demand, achievable quantities, and recommendations
- Availability: Current inventory levels and constraints
Quantity Override Options
The orders grid provides several ways to adjust order quantities: Quick Quantity Actions (toolbar menu):- Set to Demand: Sets all selected items to their calculated demand quantity
- Set to Achievable: Sets quantities based on available inventory
- Add Quantity: Increases quantities by a specified amount
- Subtract Quantity: Decreases quantities by a specified amount
- Replace Quantity: Sets a specific quantity value
- Click any quantity cell and enter a value directly
- Press Enter or Tab to move to the next cell
- Changes are saved automatically
Reserve and Allocate
For items with limited inventory, you can set reserve and allocate percentages to ensure fair distribution across stores:- Select the items to configure
- Click Reserve/Allocate in the toolbar
- Set percentage rules by:
- Category: Reserve a percentage for specific item categories
- Product Group: Reserve for specific product groups
- Store: Allocate specific percentages to priority stores
Submitting Orders
When your session is ready to submit:Review Summary
Check the submission summary showing:
- Number of stores receiving orders
- Total order quantity
- Total cart count
After submission, the session status changes to “Completed” and the grid becomes read-only. You can still view and export the session for records.
Advanced Features
Round to Cart
Enable Round to Cart in the toolbar to automatically round order quantities to full cart increments based on container configurations. This helps optimize loading and shipping logistics.Undo Changes
The orders grid maintains an undo history. Click Undo in the toolbar to revert recent quantity changes.Metrics Sidebar
Open the metrics sidebar (panel icon in toolbar) to view real-time session metrics:- Total order quantity across all stores
- Total cart count
- Items with orders vs. total items
- Average order size per store
Best Practices
Session Naming
Use clear, descriptive session names that include:- Frequency (Weekly, Daily, Monthly)
- Date or week identifier
- Purpose (Store Restock, Promo Orders, Special Event)
- “Weekly Restock - Week of Feb 15”
- “Valentine’s Day Promo Orders”
- “Emergency Restock - Storm Recovery”
Store Selection
Consider grouping stores by delivery schedule to:- Match order timing with truck schedules
- Align with store receiving hours
- Optimize driver routes
Quantity Management
- Start with demand-based quantities as a baseline
- Adjust for store-specific factors (promotions, events, historical variance)
- Check reserve rules for high-demand items
- Verify total cart counts fit truck capacity
Session Organization
- Create separate sessions for different delivery dates
- Keep sessions focused on specific store groups or delivery schedules
- Complete or cancel old sessions to keep the list manageable
Troubleshooting
Session Won’t Load
Possible Causes:- Session was deleted by another user
- Backend connection issue
- Browser cache problem
- Refresh the page and try again
- Check with team members if session still exists
- Clear browser cache and reload
Stores Not Appearing in Selector
Possible Causes:- No station assignment for your user account
- Stores not configured in your assigned stations
- Store settings missing delivery schedule assignment
- Verify station assignments with supervisor
- Check store configuration in Data Management → Locations
- Ensure stores have delivery schedules assigned
Cannot Submit Orders
Possible Causes:- No quantities entered (all zero)
- Session already submitted
- Over-allocation on some items (exceeds availability)
- Verify at least some items have non-zero quantities
- Check session status - if “Completed” it cannot be resubmitted
- Review grid for red-highlighted cells indicating over-allocation