# Top Suppliers

<p class="doc-lead">Dashboard widget on the Purchase Dashboard — ranks suppliers by purchase value or quantity for the selected period.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-links">
<a href="#/purchase/reports/top-suppliers?id=overview">Overview</a>
<a href="#/purchase/reports/top-suppliers?id=use-cases">Use Cases</a>
<a href="#/purchase/reports/top-suppliers?id=filters">Filters</a>
<a href="#/purchase/reports/top-suppliers?id=columns">Columns</a>
<a href="#/purchase/reports/top-suppliers?id=actions">Actions</a>
<a href="#/purchase/reports/top-suppliers?id=faq">FAQ</a>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

Go to <b>Purchase → Purchase Dashboard</b>. The <b>Top Suppliers</b> widget appears in the dashboard's graphical analysis section.

Widget title in ERP: <b>Top Suppliers</b>

<p><b>What it shows.</b> A ranked list or chart of suppliers with the highest purchase volume during the selected dashboard period. Each entry shows the supplier name and total purchase value (or quantity, depending on configuration).</p>

<p><b>When to use it.</b> Use for a quick snapshot of your largest suppliers — to monitor dependency on key vendors, review spending concentration, and identify top procurement relationships at a glance.</p>

<p><b>How amounts are calculated.</b> Based on approved purchase invoices within the dashboard date range. Suppliers are ranked by total purchase value by default. The widget respects the dashboard's global date range filter.</p>

<hr class="doc-section-divider">

<h2 id="use-cases">Use Cases</h2>

<ul>
<li><b>Vendor dependency review</b> — Identify whether a small number of suppliers account for most of your purchase spend.</li>
<li><b>Monthly procurement review</b> — Check which suppliers received the most orders at the start of each month during dashboard review meetings.</li>
<li><b>Negotiation prioritization</b> — Focus rate renegotiation efforts on the top-ranked suppliers by purchase value.</li>
<li><b>Drill-down analysis</b> — Click a supplier in the widget to open detailed purchase reports for that vendor.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="filters">Filters</h2>

The widget uses the Purchase Dashboard's global <b>Date Range</b> filter. Changing the dashboard date range updates the Top Suppliers ranking automatically. No separate widget-level filters apply.

<hr class="doc-section-divider">

<h2 id="columns">Columns</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Rank | Position in the top suppliers list (1 = highest). |
| Supplier | Supplier name. |
| Purchase Value | Total approved purchase invoice amount in the selected period. |
| Purchase Qty | Total quantity purchased (when quantity ranking is enabled). |
| % of Total | Share of total dashboard purchase value attributed to this supplier. |

> The widget typically shows the top 5–10 suppliers. Exact count depends on dashboard configuration.

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

<ul>
<li><b>Click supplier</b> — drill down to supplier-specific purchase details or reports</li>
<li><b>Change Date Range</b> — update the dashboard date filter to refresh the ranking</li>
<li><b>View full report</b> — navigate to detailed supplier reports from the dashboard link, if available</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>How are Top Suppliers calculated?</b><br>
Suppliers are ranked by total purchase invoice value within the selected dashboard date range. Quantity-based ranking may apply when configured.

<b>Why did a supplier disappear from the list?</b><br>
The ranking is period-specific. A supplier with no invoices in the current date range will not appear.

<b>Does this include purchase orders?</b><br>
No. Only approved purchase invoices count toward the ranking.

<b>Can I change how many suppliers are shown?</b><br>
The display count is set by dashboard configuration. Contact your administrator if you need a different limit.

<b>Which invoice statuses count toward ranking?</b><br>
Approved and closed purchase invoices in the selected period. Draft and cancelled invoices are excluded.

<b>Why is my report empty?</b><br>
No approved purchase invoices exist in the date range, or branch filters exclude all suppliers.

<b>Does this include debit notes or returns?</b><br>
No. Ranking is based on purchase invoice totals. Use return and debit note reports for credit adjustments.

<h2 id="related">Related</h2>

<ul>
<li><a href="#/purchase/purchase-dashboard">Purchase Dashboard</a></li>
<li><a href="#/purchase/reports/supplier-summary">Supplier Summary</a></li>
<li><a href="#/purchase/reports/supplier-statement">Supplier Statement</a></li>
<li><a href="#/purchase/reports/">Purchase Reports</a></li>
</ul>
