Vendor Registration
Vendor registration onboards a produce supplier: who they are, what they supply, how they are paid and what commission applies.
Overview
Section titled “Overview”A vendor record is created once and referenced from then on. Because transactions copy their defaults from it, a change here changes the behaviour of every future document — but never a document already posted.
Prerequisites
Section titled “Prerequisites”Before you begin
- The vendor has provided a trade licence and bank details
- The commission structure has been agreed in writing
- The produce categories the vendor supplies are defined in the catalogue
Opening the screen
Section titled “Opening the screen”- Vendors
- Registration
Creating a vendor
Section titled “Creating a vendor”Open the Vendor list
The list shows every vendor record you have access to, newest first. Use the search box to check whether the record already exists before creating a duplicate.
Start a new record
Click New. Vendor opens with the code field already filled from the numbering series.
Complete the required fields
Fill every field marked with a red asterisk. The Save button stays disabled until all of them are valid.
Save the record
Click Save. The record becomes available to transactions immediately — there is no separate approval step.
Expected result
The record is saved, a code is allocated, and the vendor immediately appears in transaction lookups.
Field reference
Section titled “Field reference”| Field | Type | Required | Default | Description | Notes |
|---|---|---|---|---|---|
| Vendor Code | Auto | Read-only | — | Allocated on save. | |
| Vendor Name | Text | Yes | — | Trading name, printed on purchase documents and settlements. | |
| Licence No. | Text | Yes | — | Mandi trade licence number. | Validated against the licence register where configured. |
| Licence Expiry | Date | Yes | — | Purchases are blocked after this date. | A warning appears 30 days before expiry. |
| Categories | Multi-select | Yes | — | Produce categories this vendor is approved to supply. | |
| Commission % | Percent | Yes | — | Deducted from the vendor settlement. | |
| Bank Account | Bank | Yes | — | Account settlements are paid into. | Name must match the vendor name. |
| Supply Window | Grid | No | — | Days and times this vendor delivers to the gate. | |
| Status | Dropdown | No | Active | Inactive vendors cannot be selected on purchases. |
Vendor fields
Important notes
Section titled “Important notes”Common problems
Section titled “Common problems”The Save button is disabled
A required field is empty or invalid. Fields in error are outlined in red with the reason underneath — scroll up, the first error is usually in the header.
You do not have permission to perform this action
Your role is missing the relevant permission for this screen. Ask an administrator to check it against Roles & Permissions.
Frequently asked questions
Section titled “Frequently asked questions”Can I delete a vendor record?
Not once it has been used on a transaction — deleting it would break the audit trail and every document that refers to it. Set Status to Inactive instead, which hides it from new transactions while keeping history intact.
Why does a vendor not appear in the lookup?
Lookups list active records only. Open the record and check that Status is Active, and that its group is one your role is allowed to use.
Can two records share a name?
No. Names must be unique so that reports and lookups are unambiguous. Add a distinguishing suffix, such as a city or branch, if you genuinely have two similar records.