Manage vendors on the POS | Quickvee Help Center

🚧 Draft article — the source Jira ticket MM-459 (POS - Inventory - Vendor) is still in progress. Content here may be updated once the source documentation is finalized.

The Vendors module on the Quickvee POS Android app lets cashiers and managers manage the merchant's list of suppliers directly from the register tablet. Vendor records sync with the Web Backend — vendors created on either platform appear on both.

Each vendor record stores contact info (name, email, phone), a physical address, and an Enable/Disable status. The POS Vendor module also displays a per-vendor PO summary (Purchase Order count, dates, total spend) and provides access to Vendor Transaction History.

Access path: POS Home → Inventory → Vendors tab

Opening the Vendors module

From the POS home screen, tap Inventory, then tap the Vendors tab at the top of the Inventory screen (between Purchase Order and Brands). Inventory has 10 tabs across the top: Category · Products · Attribute · Variant · Purchase Order · Vendors · Brands · Tags · Stocktake · Lottery. The active tab is highlighted in orange/red with an underline.

📷 Add screenshot: Vendors tab in Inventory

Vendors list screen

Header controls

Control	Purpose
← (back arrow) (top-left)	Returns to the POS home screen
Search Vendor (top-center)	Search vendors by name
Scanner icon (top-right)	Activates barcode scanner

Vendor table columns

Column	Description
Vendor	Vendor name
#	Number of Purchase Orders created for this vendor
Dates	Most recent PO date (or `—`)
Total	Total dollar amount across all POs (or `—`)
› (chevron)	Tap to open Edit Vendor modal

A green floating + button at the bottom-right opens the Add Vendor modal.

📷 Add screenshot: Vendor list table

Adding a new vendor

Tap the green + button at the bottom-right. The Add Vendor modal opens with these fields:

Field	Required	Format
Name	Yes	Free text vendor name
Phone Number	Yes	10 digits (e.g. `8888888888`)
Email Address	No	Valid email format
Street Address	Optional	Free text
City	Optional	Free text
State	Optional	Dropdown (US states)
Zip Code	Optional	5-digit US ZIP

Tap Save (blue) to save and close, or Cancel (white outline) to discard.

Email is optional on the POS. If entered, it must be a valid format.

Phone Number must be 10 digits. Format auto-applies during entry.

Zip Code is limited to 5 digits.

Name field rejects special characters. Only letters, numbers, and spaces are accepted.

Save button protection. After tapping Save, the button is briefly disabled to prevent duplicate vendor creation.

Editing a vendor

Tap the › chevron at the right end of any vendor row. The Edit Vendor modal opens, pre-populated with current values. Same fields as Add Vendor.

Button	Action
Update (blue)	Saves the changes and closes the modal
Disable (red outline)	Disables the vendor (or `Enable` if currently disabled)
Cancel (white outline)	Discards changes and closes the modal

Disable is a separate action that instantly disables the vendor. Disabled vendors disappear from active dropdowns but the record is preserved. Button label switches to Enable for re-activating.

The Edit modal cannot be used to delete a vendor. Vendor records cannot be permanently deleted — only enabled or disabled.

Vendor Transaction History

Tap a vendor name (or the row body, not the chevron) to open the Vendor Transaction History screen. This lists all Vendor Payouts made to this vendor through the POS register's Vendor Payout flow.

The header displays Vendor name - (phone) (e.g. Donga - (888) 888-8888).

Date range filter

Option	What it shows
Today (default)	Transactions from today
Yesterday	Transactions from yesterday
Last 7 days	Past 7 days
This month	Current calendar month
Custom	Opens a custom date range picker

Transactions show: Amount, Transaction Date, Remark. Empty state shows "No Data Found." A circular blue printer icon at the bottom-right prints the filtered list.

Vendor Transaction History on the POS is read-only.

How vendors are used elsewhere

Module	How vendor is used
Inventory → Purchase Order	Vendor selection dropdown. Only enabled vendors appear, sorted alphabetically.
Inventory → Products	Each product can be tagged with a Preferred Vendor for restocking
Register → More → Vendor Payout	Vendor selected from this list when recording cash paid out. Logged in Vendor Transaction History.
Search	The Search Vendor field matches by name

Important notes

Newly created vendors are immediately available across the POS without needing to relaunch the app.

Vendor names are sorted alphabetically (A–Z) in dropdowns across the POS.

Duplicate vendor names are blocked.

Web ↔ POS sync. Vendors created on the Web Backend appear on the POS, and vice versa. Sync delay is typically under a minute.

Disabled vendors remain in the list with a visual indicator (greyed out). Re-enable from the Edit Vendor modal at any time.

Internal reference

Source ticket: MM-459 — POS - Inventory - Vendor (In Progress)