Commission Agents Guide
If your business works with sales representatives, field agents, or commission-based staff, EzDukkan has a dedicated agent management system. It automatically tracks how much commission each agent earns on every sale and helps you manage payouts accurately.
A Commission Agent is any person who brings customers to your business or facilitates sales on your behalf, and earns a percentage of each sale as their income. This could be:
- A field sales representative who visits customers and takes orders
- A shop floor staff member who earns incentives based on what they sell
- An independent distributor who places bulk orders for your products
- A referral partner who sends customers to you
EzDukkan tracks agent commission at the per-product, per-invoice level — meaning you can see exactly how much each agent earned on each specific product in each sale. This level of detail makes commission disputes rare and payouts transparent.
Go to Commissions or Agents from the sidebar. Click "Add Agent".
Fill in:
- Agent Name — The agent's full name
- Phone Number — Their contact number (also used for WhatsApp communications)
- Email — Optional, for sending commission statements
- Commission Type — Set a default commission type for this agent:
- Percentage of Profit — Agent earns X% of the profit on each sale
- Flat Per Unit — Agent earns a fixed rupee amount per unit sold
Note: Each product in your catalogue also has its own commission rate set in the product editor. When an agent is assigned to an invoice, the system uses the product-level commission rate, not the agent-level default. The agent-level default is a fallback for products that don't have a specific commission rate set.
For the agent commission system to work accurately, each product needs a commission rate set in its product record.
Go to Products → Edit Product. In the pricing section, find:
- Commission Rate % — The percentage of profit the agent earns when this product is sold (e.g.,
20means the agent gets 20% of the profit per unit) - Commission Value (₹) — Alternatively, a flat rupee commission per unit sold (e.g.,
5means ₹5 per unit regardless of profit)
Choose one mode: percentage of profit is more common and automatically adjusts with different selling prices. Flat value is simpler and more predictable.
For products without a commission rate set, EzDukkan will use 0% commission (the agent earns nothing on that product unless you override it on the invoice).
When creating an invoice:
- Find the Agent dropdown field on the invoice form (usually in the header section alongside invoice date and counter).
- Select the agent who made or referred this sale.
- A Commission Panel appears on the right side of the invoice builder.
The Commission Panel shows:
- Each product on the invoice with its calculated commission
- The total commission amount for the entire invoice
- Per-item commission breakdown with a live slider for adjustments
The Commission Panel has a unique feature: the Payout Dial — a slider for each line item that lets you adjust how much commission the agent actually receives on that specific product for this specific invoice.
Why would you need to adjust?
- You gave the customer a discount. The profit was reduced. Paying the full commission would eat into your margin.
- The sale price was negotiated below minimum profit. EzDukkan automatically caps the commission to protect your minimum profit floor.
- You want to give the agent a bonus on a specific product (increase above default).
How the Payout Dial works:
- Slide left → Reduce the commission payout (down to ₹0)
- Slide right → Increase up to the maximum allowed commission
- The Business Net figure updates in real time — showing exactly how much profit YOUR business keeps after paying the agent
The Minimum Profit Safeguard: If the invoice price for an item is below the minimum profit threshold you set on that product, EzDukkan automatically caps the commission to prevent the business from taking a loss. You can override this safeguard (with a warning) if you choose to.
Go to Commissions from the sidebar to see the full agent management dashboard.
For each agent, you can see:
- Total Sales Value — The total invoice value generated by this agent
- Total Commission Earned — Gross commission across all their invoices
- Paid Commission — How much you've already paid out
- Unpaid Commission — What you still owe the agent
- Commission by Product — Which products generate the most commission for this agent
- Sales Timeline — A graph of their sales activity over time
The Top Agents ranking shows you which agents are driving the most revenue and which are underperforming — valuable for performance reviews and incentive design.
When you pay an agent their commission (weekly, monthly, or per-invoice depending on your agreement):
- Go to Commissions → Agent Name.
- View their unpaid commission balance.
- Click "Record Payment" or "Mark as Paid".
- Enter the amount paid and the payment date.
- Add a payment reference (e.g., UPI transaction ID, bank transfer reference).
- Save.
EzDukkan updates the agent's khata — their unpaid balance decreases by the amount you recorded. You can generate a Commission Statement (a printable/PDF summary of all invoices and commission amounts) to share with the agent for their records.
Can an agent see their own commissions? Not in the current version — the Commissions section is visible only to account owners and admin users. You can share a Commission Statement PDF with an agent to show them their earnings.
Can a single invoice have two different agents? No. Each invoice is assigned to one agent. If two agents collaborated on a sale, you would need to split the commission manually outside of EzDukkan, or assign the invoice to one agent and record the other's share separately.
What if a customer returns the product? Is the commission reversed? If you create a return/credit note against an invoice, the corresponding commission is also reversed in the agent's khata.
Can I set different commission rates for the same product for different agents? Currently, commission rates are set at the product level (one rate for everyone). Per-agent per-product rates are not yet supported. Use the Payout Dial on the invoice to manually adjust if you have special arrangements.
Can agents access EzDukkan themselves to see their sales? Not currently. Agent access (a read-only agent portal) is on the product roadmap.
What is the difference between "Commission Amount" on an invoice and "Commission Paid" in the agent section? "Commission Amount" on the invoice is what the agent earned on that specific sale. "Commission Paid" in the agent section is what you've actually disbursed to them. The difference is the unpaid outstanding balance.