Solavel Docs
English

Suppliers

Last updated

Suppliers are the businesses you buy from. Purchase orders, bills, expenses, debit notes, supplier refunds and bill payments all reference a supplier, and each supplier's page shows their payable history, statement and actions such as New Bill and Make Payment.

#Where to find it

AP (Purchases) (left rail) → Suppliers group:

Item URL
All Suppliers /suppliers
Add Supplier /suppliers/create
Categories /suppliers/categories
Add Category /suppliers/categories/create

#The supplier list

Header buttons (top right): Bulk Upload, Excel, Add Supplier.

Filters (one row, shared list layout): search ("Search suppliers..."), All statuses (the list opens on Active; choose Archived to see archived suppliers), All Categories, All supplier types (Local, Import), All balances (Owes money, Settled, In credit), All activity (With transactions, No transactions), and Sort by (Name (A-Z) by default, Highest balance, Most billed, Recently added). The list updates as you pick a filter; Filter applies typed text and Clear resets everything.

Columns:

Column What it shows
(tick box) Select rows for bulk Excel export.
Name The supplier name as a link; the company name underneath when it differs from the name.
Categories Category chips, or a dash.
Contact Phone (left to right) with the email underneath.
Currency The supplier's default currency code, if one is set.
Balance payable (with your base currency, for example AED, under the heading) What you owe the supplier in base currency, from the posted accounts-payable ledger. Positive means you owe them; a credit balance (they owe you) is shown in a different style with a minus sign.
Status Active or Archived.
(menu) Row actions.

The balance is the same figure as AP Balance on the supplier profile and the closing balance of the Supplier Statement: bills, expenses and supplier refunds increase it; payments, applied advances and debit notes decrease it. Total billed and total paid are no longer list columns; they are on the profile as AP increases and AP decreases.

Row menu (the three dots at the end of the row): View, Statement (PDF), Edit, and Archive supplier or Restore supplier. Tick rows (or Select visible records) for bulk export and archive. Excel downloads the list with the filters you have set; ticked rows export alone.

#Create a supplier

  1. Click Add Supplier.
  2. Fill in the form:
Section Field Notes
— Name * Required.
Company Name Legal/trading name.
Supplier code Optional short code, unique in the organization (ignoring case and spaces, archived suppliers included). Searchable in bill and purchase-order selectors.
Parent Supplier Optional. Search by name or code to make this supplier a branch of another active supplier. Identity only: it never moves bills or balances. Remove parent supplier unlinks it.
Second name Optional. The supplier's name in a second language (for example Arabic); the field follows the direction of what you type.
Legal Name Optional. "Registered legal name, as it should appear on tax invoices. Leave empty to use the display name."
Phone, Email Optional; email must be valid.
Categories Optional. "Use categories for supplier reporting and filtering; you can leave this blank and classify the supplier later." New Category creates one inline.
Supplier type Import / Overseas supplier "Check if supplier is located outside your country (import). Uncheck for local suppliers." Imports drive reverse-charge/import VAT handling on bills.
VAT registered "Supplier is registered for VAT."
Tax Number (TRN) "Optional for overseas suppliers."
Contact Person Name, Title / Post
Address Address Line 1/2, City, Country
Locations Add Location — label, address, coordinates Optional, several allowed
Bank Info Bank Name, Branch, Account Name, Account Number
Cliq Info Cliq Name, Cliq Type, Cliq Alias/Number Shown only when the supplier's Country is Jordan, or when the supplier already has CliQ details.
Custom fields If defined for suppliers
  1. Click Add Supplier at the bottom. If saving fails nothing is created: "Unable to create supplier. No changes were saved."

You can also create a supplier from a bill or expense: the Supplier field is a searchable selector with an add option (requires supplier manage permission).

#The supplier profile page

Open a supplier from the list (/suppliers/{id}).

  • Date range from → to with Apply.
  • Actions: New Bill, Make Payment (active suppliers), Edit Supplier, PDF statement, Print.
  • More Actions: New Purchase Order, Excel, Relationship Map, Use also as customer, Review Stock party (SolaStock-connected orgs), Archive Supplier / Restore Supplier.

Cards: Supplier Profile, Contact (Company Name, email, phone, contact person), type and VAT registration, address, Locations, Bank Info, Cliq Info, Financial summary (AP increases, AP decreases, Total Credits, Total Refunded, AP Balance, plus Remaining opening credit when the supplier still has an unused opening credit from data migration), Purchase Documents, Payments, Email History, Recent Activity, and Journal Entries & Balance Changes — the supplier's Accounts Payable sub-ledger with running balance. Sidebar: Quick Stats (purchase orders, bills, payments, debit notes) and custom fields.

Make Payment opens a bill payment with the supplier preselected. See Payments.

#How the Financial summary is calculated

Since October 2026 the figures come from the posted accounts-payable ledger in base currency up to the end of the date range you apply, not from adding up document totals. That keeps the profile equal to the supplier statement and the aging reports (Payables reports).

Figure Meaning
AP increases Everything that raised the payable: posted bills, posted unpaid expenses, supplier refunds received.
AP decreases Everything that lowered it: payments, applied supplier advances, applied or posted debit notes.
Total Credits The part of the decreases that came from debit notes.
Total Refunded Supplier refunds received in cash against debit notes.
AP Balance AP increases minus AP decreases. Red when you owe the supplier, green when it is zero or a credit.

Drafts, voided documents and entries dated after the range end are not included. A foreign-currency document counts at its posted base-currency value, so the profile may differ from the document total shown in its own currency.

#Items supplied and purchase history

Below the payments, the profile has two more sections when your role has Supplier item terms: View and your plan includes the Suppliers feature:

  • Items supplied lists every item this supplier has saved terms for (supplier SKU, status, current price, minimum order, lead time), with Search, a Status filter (All statuses, Approved, Blocked, Historical), Export CSV and, with manage permission, Import pricelist. Items whose terms SolaStock keeps are marked Managed in SolaStock. Click an item to edit its terms on the item page.
  • Purchase history (needs Supplier purchase history: View) shows the posted bill lines from this supplier with, per item, the last cost, lowest, highest and weighted-average base unit cost, total quantity, total value and number of bills. Only bills whose journal is posted and not reversed are included; unit cost is after discounts and before tax.

Example. {Supplier 2 name}'s Items supplied shows A4 Copy Paper 80gsm (Approved, Preferred, supplier SKU EPT-80-5R, current price AED 95.000 from 10, minimum order 10 Box, lead time 4 days) and A3 Copy Paper (Historical). Its Purchase history, By item, shows the A4 paper with last cost AED 18.22 (5 Oct), lowest 18.22, highest 19.00, weighted average 18.57 over 225 reams in 2 bills.

Every column and rule is explained in Supplier item terms; the CSV format is in Vendor pricelists.

#Supplier categories

AP (Purchases) → Categories lists categories; Add Category creates one (name must be unique: "A category with this name already exists."). Use them to filter the list and in purchase reports.

#Bulk import suppliers

  1. On All Suppliers, click Bulk Upload (/suppliers/bulk-upload).
  2. Type rows or download Template (Excel) / CSV and Upload File.
  3. Columns: Name, Contact, Tax / VAT (TRN, VAT reg, Overseas), Categories (comma-separated; + add category), Contact Person, Address, Bank, CliQ, Custom Fields. The downloadable template has the CliQ columns only for organizations in Jordan.
  4. Rows are validated: "A supplier with the same normalized name already exists.", "A supplier with this phone already exists.", "A supplier with this email already exists.", plus duplicate checks within the file.
  5. Click Import N suppliers (the count of valid rows). You return with "Imported N supplier(s). Skipped M row(s)."

#Merge duplicate suppliers

If the same supplier was entered twice, open the duplicate you want to retire and choose Merge into… from the ⋮ menu on its page (needs permission to manage suppliers). Search the Record to keep by name, code or email. A preview then lists what will move (for example "Moves 3 bills, 2 purchase orders and 1 attachment to Gulf Timber Supplies."). Tick I understand and want to merge and click Merge.

The duplicate is archived with a note "Merged into #id (name) on date"; posted amounts and document numbers do not change, and the merge cannot be undone. The merge is blocked, with the reason shown, when the two suppliers have different currencies, either is archived, a SolaStock link or sync is open, a change is waiting for approval, or both have bills with the same number (bill numbers must stay unique per supplier).

When the two suppliers are linked to SolaStock, SolaCount merges them in SolaStock first, then moves the SolaStock link to the record you keep. The preview says so ("The two linked parties will also be merged in SolaStock."). If SolaStock cannot complete the merge, nothing is changed and you can try again. A supplier whose link was retired by a merge is not sent to SolaStock again.

#Worked example

{Organization name} adds {Supplier 1 name} (local, VAT registered, TRN 100345678900003, category Stationery). A bill for AED 4,000 + 5% VAT is posted:

Account Debit (AED) Credit (AED)
Office supplies expense 4,000.00
Input VAT 200.00
Accounts payable — {Supplier 1 name} 4,200.00

The profile shows AP increases 4,200.00 and AP Balance 4,200.00 until Make Payment is recorded.

Second example: a credit and a refund. Two weeks later {Supplier 1 name} credits AED 525.00 (AED 500.00 + 25.00 VAT) for damaged cartons, then sends the money back to {Bank 1 name} instead of reducing a bill.

Step Journal (AED) AP increases AP decreases AP Balance
Bill BL-2041 posted Dr Office supplies 4,000 + Dr Input VAT 200 / Cr Accounts payable 4,200 4,200.00 0.00 4,200.00
Debit note DN-0007 posted Dr Accounts payable 525 / Cr Office supplies 500 + Cr Input VAT 25 4,200.00 525.00 3,675.00
Supplier refund SRF-0002 posted Dr Bank 525 / Cr Accounts payable 525 4,725.00 525.00 4,200.00

Total Credits shows 525.00 and Total Refunded 525.00. The supplier still holds AED 4,200.00 of unpaid bill, because the refund returned cash instead of reducing the bill. In the list, Balance payable also reads 4,200.00.

#Worked example: a supplier group with branches

Dune Hardware Trading bills from two branches. Create the parent (Supplier code DHT-000), then two suppliers, DHT-001 (Dubai) and DHT-002 (Sharjah), each with Parent Supplier set to the parent. The Supplier Hierarchy section on the parent page lists both branches with their codes and status.

A bill of AED 2,500 + 5% VAT is posted on the Sharjah branch and AED 4,000 + 5% VAT on Dubai, which is paid in full:

Supplier AP increases AP decreases AP Balance
Dune Hardware Trading (parent) 0.00 0.00 0.00
Dune Hardware Trading - Dubai 4,200.00 4,200.00 0.00
Dune Hardware Trading - Sharjah 2,625.00 0.00 2,625.00

The parent's own balance is not changed: each document belongs to the branch selected on it. To see the whole group, open the parent supplier and click Show group view: Group balance payable (2,625.00 here), the Overdue part, a Breakdown by branch and a Group statement with a Branch column. In Vendor Balance Summary choose Group by parent. The AP Aging reports have no group option yet. Supplier payments are not supported across branches: pay each branch's bills with its own payment. The built-in PDF designs print "Branch of" and the parent's name on a branch supplier's documents. Search the bill's Supplier field by DHT-002 to find the branch by code. See the full walkthrough in A supplier group bills from several branches.

#Rules and permissions

  • suppliers.view to view; suppliers.manage to create, edit, archive, import and quick-create. Supplier categories need supplier_categories.manage.
  • The default Purchasing role (added October 2026) can view and manage suppliers, create and edit draft purchase orders and bills, and prepare draft debit notes. It cannot post, pay or void, and has no general report access (the AP aging reports open for anyone who can view bills). See the role matrix in Team access.
  • Archived suppliers keep their history but are not offered on new documents.
  • New-supplier approval, when enabled, turns saves and imports into proposals — see Workflow approvals.
  • Supplier item terms use their own permissions: Supplier item terms: View and Manage (starting out equal to viewing and managing suppliers), Supplier purchase history: View (equal to viewing bills) and Blocked supplier: Override (equal to managing suppliers). See Supplier item terms.

#Common problems

  • Supplier not in the bill selector — archived; restore it.
  • Import skips rows — name, phone or email already used by another supplier.
  • Wrong VAT on bills — check Import / Overseas supplier and VAT registered.
  • A balance differs from a bill total — the balance is the ledger balance after payments, debit notes, refunds and applied advances. Open the Supplier Statement for the same dates to see each movement.
  • The list shows no archived suppliers — the list opens on Active; change the status filter to Archived or All statuses.