Skip to main content

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:
1

Open Session Manager

Navigate to Restock → Orders and click Session Manager in the toolbar.
2

Start New Session

Click Create Session (+ icon) in the Session Manager dialog.
3

Name Your Session

Enter a descriptive session name (e.g., “Weekly Store Restock - Feb 15”).
4

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
You can select multiple stores at once using checkboxes.
5

Confirm

Click Confirm to create the session with the selected stores.
The store selector displays stores you have access to based on your assigned stations. If you don’t see expected stores, verify your station assignments with your administrator.

Managing Sessions

Loading an Existing Session

To continue working on a previously saved session:
  1. Click Session Manager in the toolbar
  2. Browse the list of saved sessions
  3. Each session card displays:
    • Session name
    • Status (Draft, In Progress, Completed, Cancelled)
    • Creation and last updated dates
    • Number of stores included
  4. Click Load on the session you want to open
The session loads into the orders grid with all your previous work preserved.

Session Status

DBR sessions have the following statuses:
StatusDescription
DraftSession created but no quantities entered yet
In ProgressSession has quantities being entered or modified
CompletedSession finalized and orders submitted to ERP
CancelledSession cancelled and no longer active
DeletedSession 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.
Only delete sessions that are no longer needed for any purpose. Completed and cancelled sessions are useful for historical reference and should generally be kept.

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
Manual Entry:
  • Click any quantity cell and enter a value directly
  • Press Enter or Tab to move to the next cell
  • Changes are saved automatically
Use “Set to Demand” as a starting point, then manually adjust specific items based on store-specific needs or promotions.

Reserve and Allocate

For items with limited inventory, you can set reserve and allocate percentages to ensure fair distribution across stores:
  1. Select the items to configure
  2. Click Reserve/Allocate in the toolbar
  3. 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
Reserve rules help prevent any single store from consuming all available inventory of high-demand items.

Submitting Orders

When your session is ready to submit:
1

Review Order Quantities

Verify all store quantities are correct and no over-allocations exist.
2

Open Submit Dialog

Click Submit Orders in the toolbar.
3

Select Ship Date

Choose the ship date for these orders (defaults to tomorrow).
4

Review Summary

Check the submission summary showing:
  • Number of stores receiving orders
  • Total order quantity
  • Total cart count
5

Submit

Click Submit to send orders to the ERP system.
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)
Examples:
  • “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
Solutions:
  1. Refresh the page and try again
  2. Check with team members if session still exists
  3. 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
Solutions:
  1. Verify station assignments with supervisor
  2. Check store configuration in Data Management → Locations
  3. 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)
Solutions:
  1. Verify at least some items have non-zero quantities
  2. Check session status - if “Completed” it cannot be resubmitted
  3. Review grid for red-highlighted cells indicating over-allocation