# Suppliers

<p class="doc-lead">Suppliers are vendor master records used on every purchase transaction, payment, and supplier report. Maintain accurate supplier details here before creating quotations, orders, and invoices.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/purchase/suppliers?id=overview">Overview</a>
<a href="#/purchase/suppliers?id=fields">Fields</a>
<a href="#/purchase/suppliers?id=contacts">Contacts</a>
<a href="#/purchase/suppliers?id=how-it-works">How It Works</a>
<a href="#/purchase/suppliers?id=actions">Actions</a>
<a href="#/purchase/suppliers?id=faq">FAQ</a>
<a href="#/purchase/suppliers?id=related">Related</a>
</div>
</div>
</div>

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

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Purchase → Suppliers</b> from the left menu.

The supplier list shows all vendors with search and filter options. From here you create profiles, update contact and tax details, suspend inactive suppliers, and export the list for analysis.

Master data screen — edit suppliers directly from the list or view. There is no Master Update workflow on suppliers.

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Supplier record ID. |
| Supplier Code | Short code that identifies the supplier. |
| Name | Supplier or company name. |
| Supplier group | <a href="#/purchase/supplier-groups">Supplier Group</a> classification. |
| GSTN | GST registration number (India). |
| TRN | Tax registration number (UAE/GCC). |
| Phone | Primary phone. |
| Email | Primary email. |
| Created on | Date the supplier was created. |
| Status | Active or Suspended. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Active | Active suppliers (default). |
| Suspended | Suspended suppliers. |

<b>Advanced filters</b>

| **Filter** | **Description** |
|------------|-----------------|
| Id | Filter by record ID. |
| Name | Search by supplier name. |
| Supplier Code | Search by code. |
| Phone | Search by phone. |
| Supplier group | Filter by group. |
| Status | Active or Suspended. |
| Branch | Filter by branch when multi-branch is enabled. |
| Description | Search in description. |
| Created Date | Date the supplier was created. |

<b>List widgets</b>

| **Widget** | **Description** |
|------------|-----------------|
| Quick search | Fast text search across the supplier list. |

<b>List header actions</b>

| **Action** | **Description** |
|------------|-----------------|
| New | Opens the new supplier form. |
| Export | Download the supplier list to Excel. |

<b>List row actions</b>

| **Action** | **Description** |
|------------|-----------------|
| View | Opens read-only supplier details. |
| Edit | Opens the supplier edit form (full page). |
| Delete | Removes the supplier when no linked transactions. |
| Suspend | Deactivates the supplier. |
| Activate | Re-enables a suspended supplier. |
| Clone | Creates a copy of the supplier profile. |
| Print | Prints the supplier view. |

<b>Supplier List</b>

<img src="purchase/images/supplier1.webp" alt="Supplier list" loading="lazy">

<b>Create New Supplier</b>

<img src="purchase/images/supplier-new.webp" alt="New supplier form" loading="lazy">

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

<h2 id="fields">Fields</h2>

<h3>Basic Details</h3>

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Supplier or company name. Must be unique. |
| Native Name | Name in local script or language. |
| Email | Primary email. May be mandatory when configured in Purchase Settings. |
| Phone | Primary phone. May be mandatory when configured in Purchase Settings. |
| Secondary Phone | Alternate contact number. |
| Supplier code | Short code that identifies the supplier. Must be unique when filled. |
| Supplier group | <a href="#/purchase/supplier-groups">Supplier Group</a> classification. May be mandatory in Purchase Settings. |
| Branch | Default branch when multi-branch is enabled. |
| Description | Free-text notes about the supplier. |

<h3>Legal &amp; Compliance</h3>

Country-specific tax and registration fields (shown based on company country and settings):

| **Field** | **Description** |
|-----------|-----------------|
| GSTN | GST registration number (India). Includes validate action when enabled. Purchase documents and Tax Reg. No columns use this number when the document date falls in the GST date window. |
| GST Registration Date | Start of validity for the supplier GSTN. Leave blank for no start date. |
| GST Reg. Cancelled Date | End of validity for the supplier GSTN. Leave blank if still active. After this date, purchase documents do not print this GSTN. |
| PAN, TIN, CST, TRN, CRN, VAT | Other regional tax identifiers |
| Udyam Number | MSME registration (India) |
| Trade License Number | Must be unique when filled. |
| Trade License Expiry | |

<h3>Commercial Terms</h3>

| **Field** | **Description** |
|-----------|-----------------|
| Default Payment Term | Default terms on new purchase documents. |
| Currency | Default currency when multi-currency is enabled. |
| Is subcontractor ? | Flags supplier as a subcontractor for subcontracting purchase orders. |
| Supplier Center | Linked supplier center when center tracking is enabled. |

<h3>Addresses</h3>

Multiple addresses per supplier. Each address line includes:

| **Field** | **Description** |
|-----------|-----------------|
| Label | e.g. Head Office, Warehouse |
| Address Line 1, Address Line 2 | |
| Country | May be mandatory in Purchase Settings. |
| State/Province | May be mandatory in Purchase Settings. |
| District/Region, Area | |
| Pin Code | |

<p>In the <b>Select address</b> modal (opened from purchase documents and supplier screens), each address card has a <b>⋮</b> menu with <b>Suspend</b> and <b>Activate</b>. Suspended addresses show a <b>Suspended</b> tag, appear greyed out, and cannot be selected. <b>Set Primary</b> is not available on suspended addresses.</p>

<h3 id="contacts">Contact Details</h3>

Multiple contacts per supplier:

| **Field** | **Description** |
|-----------|-----------------|
| First Name, Last Name | |
| Phone, Email | |
| Title, Department | |

<p>On the supplier <b>view</b>, each contact card has a <b>⋮</b> menu with <b>Suspend</b> and <b>Activate</b>. Confirm the action. Suspended contacts stay on the supplier with a <b>Suspended</b> tag and a muted card. They are hidden from the <b>Contact person</b> picker on new purchase documents. <b>Activate</b> makes the contact available again.</p>

<p>Removing a contact row on supplier <b>edit</b> still deletes that contact. Use suspend from view when the person should no longer be used on new bills but the record must stay (for example, they are already linked on a purchase invoice).</p>

> Mandatory fields on save can include Supplier Group, Phone, Email, State, and Country when selected under <b>Supplier mandatory fields</b> in <a href="#/purchase/purchase-settings-config">Purchase Settings</a>.

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

<h2 id="how-it-works">How It Works</h2>

<h3>On purchase transactions</h3>

When a supplier is selected on a purchase quotation, order, invoice, or related document:

<ul>
<li><b>Addresses</b> — supplier addresses default on the bill header.</li>
<li><b>Payment Term &amp; Currency</b> — default commercial terms from the supplier master pre-fill header fields.</li>
<li><b>Supplier Group</b> — drives <a href="#/purchase/pricing-rules">Pricing Rule</a> matching and supplier group prices on <a href="#/purchase/basic-pricing">Basic Pricing</a>.</li>
<li><b>Previous supplier price</b> — last rate for this supplier + item + unit when enabled in <a href="#/purchase/purchase-settings-config">Purchase Settings</a>.</li>
<li><b>Subcontractor flag</b> — when <b>Is subcontractor ?</b> is on, the supplier appears in subcontracting purchase order and <a href="#/purchase/reports/subcontracting-inventory-summary">Subcontracting Inventory Summary</a> flows.</li>
</ul>

<h3>Payments &amp; outstanding</h3>

<p>Supplier master links to <b>Payment Out</b> vouchers and payables tracking. Outstanding balances on purchase bills roll up to supplier-level totals in payment and ageing reports.</p>

<h3>Supplier Summary widget</h3>

<p>On purchase bill entry screens, <b>Supplier Info.</b> opens <a href="#/purchase/reports/supplier-summary">Supplier Summary</a> — recent purchases, outstanding balance, and activity for the selected supplier without leaving the document.</p>

<h3>Mandatory fields from settings</h3>

<p><b>Supplier mandatory fields</b> in <a href="#/purchase/purchase-settings-config">Purchase Settings</a> can require Supplier Group, Phone, Email, State, and Country on save. Missing fields block create and update with a validation message.</p>

<h3>Connected reports</h3>

<ul>
<li><a href="#/purchase/reports/supplier-outstanding">Supplier Outstanding</a></li>
<li><a href="#/purchase/reports/supplier-statement">Supplier Statement</a></li>
<li><a href="#/purchase/reports/supplier-aging-report">Supplier Aging Report</a></li>
<li><a href="#/purchase/reports/top-suppliers">Top Suppliers</a></li>
<li><a href="#/purchase/reports/supplier-summary">Supplier Summary</a></li>
</ul>

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

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

<b>List header:</b> <b>New</b>

See <a href="#/purchase/suppliers?id=overview">List header and row actions</a> for Export, Edit, Delete, Suspend, Activate, Clone, and Print.

<b>Form buttons:</b> <b>Update</b>, <b>Reset</b>, <b>Cancel</b>

See <a href="#/purchase/suppliers?id=overview">Overview &amp; List View</a> for columns, filters, widgets, and row actions.

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

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

<b>Can existing supplier data be migrated?</b><br>
Yes. Provide supplier details in the migration Excel template shared by the implementation team. Migration can include supplier master data and opening balances.

<b>Which fields are mandatory?</b><br>
<b>Name</b> is always required. Additional fields depend on <b>Supplier mandatory fields</b> in Purchase Settings.

<b>Can I delete a supplier with purchase history?</b><br>
No. Suspend the supplier instead to prevent use on new documents while keeping history.

<b>What is Supplier code used for?</b><br>
Used for quick identification in lists and reports.

<b>How is opening balance recorded?</b><br>
Use <a href="#/purchase/opening-balance">Supplier Opening Balance</a> for payables at go-live, not the supplier form directly.

<b>How is Supplier code assigned?</b><br>
If auto-generate is turned on for suppliers in Number Settings, the system generates the <b>Supplier code</b> automatically from the numbering sequence. If it is off, enter the code manually.

<b>Why can't I delete a supplier?</b><br>
Suppliers with a closing balance in accounts cannot be deleted. Set the supplier to inactive or suspended instead.

<b>Which extra fields are mandatory?</b><br>
Beyond <b>Name</b>, required fields depend on <b>Supplier mandatory fields</b> in <a href="#/purchase/purchase-settings-config">Purchase Settings</a> — for example group, phone, email, state, or country.

<b>How does multi-branch affect new suppliers?</b><br>
When multi-branch is enabled, new suppliers may receive a default branch from your user settings.

<b>Can I record opening balance from the supplier screen?</b><br>
Some workflows allow quick opening balance entry when adding a supplier. For full control with reference bills, use <a href="#/purchase/opening-balance">Supplier Opening Balance</a>.

<b>How do I suspend a contact person?</b><br>
Open the supplier view, open the <b>⋮</b> menu on the contact card, and choose <b>Suspend</b>. Confirm. The contact stays on the supplier with a Suspended tag. Use <b>Activate</b> on the same menu to restore it. You need contact suspend / activate access.

<b>Does suspending a contact remove them from old purchase invoices?</b><br>
No. Existing documents keep the contact that was saved on them. Suspend only stops the contact from being selected on new transactions.

<h2 id="related">Related Topics &amp; Videos</h2>

<ul>
<li><a href="#/purchase/supplier-groups">Supplier Groups</a></li>
<li><a href="#/purchase/opening-balance">Supplier Opening Balance</a></li>
<li><a href="#/purchase/purchase-settings-config">Purchase Settings</a></li>
<li><a href="#/purchase/reports/supplier-outstanding">Supplier Outstanding</a></li>
</ul>

<b>Video — Suppliers overview</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/15filPhD1Oo?si=iiBwt8MQxWBbgn6c" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
