NutriQR Agent User Manual v1.0
Nutri
QR

Agent User Manual

Version 1.0

Last Updated: December 2025

For NutriQR Plugin Plus Agents

Table of Contents

1. Introduction

What is the Agent Role?

As a NutriQR Agent, you play a crucial role in managing territories and driving product distribution. The Agent role provides:

  • Territory Management: Oversee specific geographic regions for product distribution
  • Commission Tracking: Earn commissions based on product scans in your territory
  • Performance Monitoring: Track sales metrics and territory performance
  • Reference Code System: Generate and manage distributor reference codes
  • Analytics Dashboard: Access detailed reports on territory activities

Key Responsibilities

  1. Territory Coverage: Ensure adequate product distribution within assigned areas
  2. Distributor Management: Coordinate with distributors using reference codes
  3. Performance Optimization: Monitor and improve scan rates in your territory
  4. Reporting: Review performance metrics and identify growth opportunities

2. Authentication Process

Accessing the Agent Dashboard

The agent dashboard uses secure OTP-based authentication to ensure only authorized personnel can access sensitive territory data.

Authentication Steps:

  1. Navigate to the Agent Dashboard URL
  2. Enter your registered mobile number or email address
  3. Click "Send OTP"
  4. Enter the 6-digit code received via SMS/Email (valid for 5 minutes)
  5. Access granted to your personalized dashboard

Security Note:

Each OTP is single-use and expires after 5 minutes. Maximum 3 verification attempts are allowed before requiring a new code.

3. Agent Dashboard Overview

Dashboard Components

Commission Overview

  • Total Scans: All product verifications in your territories
  • Claimable Commission: Current amount available for withdrawal
  • Total Earned: Lifetime commission earnings
  • Conversion Rate: Points to currency conversion (configurable by admin)

Territory Statistics

  • Active Territories: Number of assigned geographic regions
  • Territory Coverage: Geographic area under management
  • Active Distributors: Number of distributors in your territories
  • Products Assigned: Product SKUs available in your territories

Performance Metrics

  • Scan Rate: Average scans per day/week/month
  • Top Performing Products: Best-selling items in your territory
  • Territory Ranking: Performance compared to other agents
  • Growth Trends: Month-over-month performance analysis

Key Performance Indicators (KPIs)

Total Scans (Territory)

Live counter updated real-time

Commission Available

Calculated based on scan count

4. Territory Management

Understanding Territory Assignments

Territories define the geographic boundaries within which you earn commissions from product scans.

Territory Parameters:

  • Territory Name: Descriptive identifier (e.g., "Dhaka Central", "Chittagong North")
  • Geographic Coordinates: Latitude/Longitude defining center point
  • Radius: Coverage area in kilometers from center point
  • Product Assignments: Specific products authorized for territory

Territory Performance

Monitor how each territory contributes to your overall performance:

  • Scan Breakdown: View scans per territory
  • Heat Maps: Visual representation of scan density
  • Top Locations: Highest performing areas within territories
  • Growth Tracking: Historical performance trends

Geo-Fencing Protection:

Customer scans outside your territory boundaries will not count toward your commission. This ensures fair distribution among agents and prevents territory overlap issues.

5. Claiming Your Commission

Commission Calculation

Commission Formula

Total Scans × Conversion Rate = Claimable Commission

(Default: 1 Scan = Configured Rate in Taka)

Claim Process

  1. Review Dashboard: Check your current claimable commission amount
  2. Click "Claim Commission": Button appears when amount > 0
  3. Verify Details: Review scan breakdown and commission calculation
  4. Confirm Claim: Submit claim request
  5. Receive Confirmation: SMS notification with claim details
  6. Processing: Finance team processes payment according to company schedule

After Claiming:

  • All unclaimed scans marked as "claimed"
  • Claimable commission resets to 0
  • Claim record added to history
  • New scans accumulate toward next claim

Claim History

Access your complete commission history showing:

  • Claim date and time
  • Number of scans included
  • Commission amount
  • Payment status
  • Detailed breakdown by territory and product

6. Performance & Analytics

Scan Analytics

Comprehensive analytics to help you understand and optimize territory performance:

Time-Based Analytics

  • Daily scan patterns
  • Weekly performance trends
  • Monthly growth metrics
  • Peak scanning hours
  • Seasonal variations

Geographic Analytics

  • Scans by territory
  • Location heat maps
  • Coverage gaps
  • High-density areas
  • Expansion opportunities

Product Performance

Track which products perform best in your territories:

  • Top Products: Best-selling items by scan count
  • Product Rankings: Comparative performance across SKUs
  • Brand Analysis: Performance by brand
  • Scan-to-Sale Ratio: Verification rate insights

Distributor Performance:

View performance metrics for distributors using your reference codes, including scan counts, territory coverage, and effectiveness ratings.

7. Reference Code System

What are Reference Codes?

Reference codes allow you to track and manage distributors within your territory. Each code links distributor activities to your agent account.

Reference Code Features:

  • Unique Identifiers: Each distributor gets a unique code (e.g., AGT-DH-001)
  • Activity Tracking: Monitor all scans associated with each code
  • Performance Metrics: View individual distributor performance
  • Commission Attribution: All scans linked to reference codes count toward your commission

Managing Reference Codes

  1. Generate Codes: Create new reference codes for distributors
  2. Assign Territories: Link codes to specific territories
  3. Track Usage: Monitor active vs inactive codes
  4. Performance Review: Analyze effectiveness of each distributor
  5. Code Management: Deactivate or reassign codes as needed

Best Practices:

  • Use descriptive naming conventions (territory-based)
  • Regularly review code performance
  • Deactivate unused codes to maintain data clarity
  • Provide clear instructions to distributors on code usage

8. Frequently Asked Questions

Q: How often can I claim my commission?

A: You can claim anytime when your claimable amount is greater than 0. There's no minimum threshold unless specified by your organization.

Q: What happens if a scan occurs outside my territory?

A: Scans outside your territory boundaries will not count toward your commission. The system uses geo-fencing to ensure accurate territory attribution.

Q: Can I manage multiple territories?

A: Yes, agents can be assigned multiple territories. Your dashboard will show combined metrics with breakdown by individual territory.

Q: How are duplicate scans handled?

A: Only the first scan of each unique product code counts toward commission. Duplicate scans are logged but don't generate additional commission.

Q: What if I don't receive my OTP?

A: Check spam folders, wait 2-3 minutes for network delays, or use the "Resend OTP" option. Contact technical support if issues persist.

Q: Can I see historical performance data?

A: Yes, the dashboard provides access to historical scan data, claim records, and performance trends for any date range.

Q: How are reference codes assigned to distributors?

A: You generate reference codes through your dashboard and provide them to distributors. The system automatically tracks all scans associated with each code.

End of Document — NutriQR Agent User Manual v1.0

© 2025 Nutricaa. All rights reserved.