Suppliers
The supplier directory maintains a database of vendors and suppliers that your cafe purchases goods and services from. Each supplier record stores contact details, payment terms and tax information, providing a central reference for managing your vendor relationships.
Suppliers are managed on the Suppliers tab of the Stock page in the main navigation. They previously lived inside Settings.
Supplier Record Fields
Each supplier record contains the following information:
| Field | Description |
|---|---|
name |
The supplier or company name. This is the primary identifier displayed in lists and on stock receipts. |
contact_person |
The name of your primary contact at the supplier (e.g., a sales representative or account manager). |
phone |
The supplier's phone number for placing orders or resolving issues. |
email |
The supplier's email address for order confirmations, invoices, or general communication. |
address |
The supplier's physical address, useful for delivery coordination or site visits. |
payment_term_days |
The number of days allowed for payment after receiving an invoice (e.g., 30 for net-30 terms). This helps track when payments are due. |
tax_authority |
The tax authority or tax office the supplier is registered with, if applicable. |
tax_identity |
The supplier's tax identification number (TIN, VAT number, or equivalent). Required for formal invoicing in many jurisdictions. |
notes |
A free-text field for any additional information about the supplier (e.g., delivery schedules, minimum order quantities, special arrangements). |
Active / Inactive Management
Suppliers have an active flag that controls their visibility:
- Active suppliers appear in the supplier list and are suggested when recording stock receipts.
- Inactive suppliers are hidden from the active list and suggestions but remain in the database. Past receipts that reference the supplier are unaffected.
Deactivating a supplier is useful when you stop ordering from a vendor but want to preserve the purchase history for reporting. You can reactivate a supplier at any time by toggling the flag back.
Linking Suppliers to Stock Receipts
The primary connection between suppliers and the rest of the system is through stock receipts. When you record a delivery on the Stock Receipt tab of the Stock page, you select the supplier from this directory and the receipt stores a direct reference to the supplier record.
Because the link is a real reference rather than free text, receipt history stays attached to the supplier even if the supplier is later renamed.
Supplier Details
Select a supplier on the Suppliers tab to open its detail panel. It has three tabs:
| Tab | Content |
|---|---|
| Overview | The Total spend, Deliveries and Average receipt cards, the Payment section and the tax and address details |
| Deliveries | Every receipt from this supplier with its invoice number, status, date, line count and total. Select a receipt to see its lines |
| Products | The products bought from this supplier |
The footer has Enter goods, which starts a stock receipt for this supplier, Edit and Activate or Deactivate.
Supplier Debt and Payments
HandyCafe keeps track of what you owe each supplier. Every saved receipt adds its total to the supplier's debt. Every payment you record against an invoice reduces it.
Payment section
The Payment section on the Overview tab shows:
| Row | Meaning |
|---|---|
| Last delivery | When the last receipt from this supplier was entered |
| Payment Term (days) | The payment term set on the supplier record |
| Oldest unpaid invoice | The invoice number and date of the oldest invoice that is not fully paid |
| Payment date | The oldest unpaid invoice date plus the payment term, with the days left or the days overdue |
| Pending amount | Every invoice total from this supplier minus every payment recorded against them |
The payment date is counted from the oldest unpaid invoice, not from the last delivery. A supplier that has paid every invoice shows No outstanding debt and no payment date. Without a payment term no payment date is calculated.
In the supplier list the Payment column shows the days left or the days overdue. When one or more suppliers are past their payment date, an alert above the list reads Payment is overdue for followed by the number of suppliers and names them.
Invoice status
On the Deliveries tab each receipt shows a status:
- Paid: nothing is outstanding on the invoice.
- Partly paid: some payment was recorded but part of the total is still owed.
- Unpaid: no payment was recorded yet.
Recording a payment
- Select the supplier and open the Deliveries tab.
- Select the receipt you are paying.
- Click Record payment.
- Enter the Amount. Pay the remainder fills in the outstanding amount of the invoice.
- Choose the Method: Cash, Card, Bank transfer or Other.
- Optionally enter a Reference, such as a cheque number, a transfer reference or the last digits of the card, and a note.
- Click Save.
The dialog shows the Invoice total, the amount Paid so far and the Outstanding amount. You can record several partial payments against the same invoice. A cash payment is deducted from the drawer at shift close. Card and transfer payments are not, since no money leaves the till.
The Payment history list in the same dialog shows each payment with its date, amount, method and reference. Deleting a payment asks for confirmation and the invoice then shows that amount as still owed.
Creating a New Supplier
To add a new supplier:
- Open the Stock page from the sidebar and switch to the Suppliers tab.
- Click the New Supplier button.
- Enter the name (required). This is how the supplier will appear throughout the system.
- Fill in the contact person, phone, email, and address as available.
- Set the payment terms (in days) to track invoice due dates.
- Enter the tax authority and tax identity if required for your accounting.
- Add any notes about the supplier relationship.
- Click Save.
Editing a Supplier
Select a supplier from the list to open the editor. You can update any field at any time. Renaming a supplier does not break receipt history because receipts reference the supplier record directly. Use Activate and Deactivate on the supplier card to control whether the supplier is offered when entering new receipts.
Supplier Use Cases
Tracking Purchase History
By recording every delivery against the right supplier, you can review receipt history per vendor to see:
- All items purchased from a specific vendor.
- Total spending with each supplier over a given period.
- Which products come from which suppliers.
Payment Term Management
The payment_term_days field helps you plan cash flow. HandyCafe adds it to the date of the oldest unpaid invoice to show when the next payment is due and warns you when a supplier is overdue. This is especially useful for cafes that buy on credit from multiple suppliers with different terms.
Tax Compliance
Recording the tax_authority and tax_identity for each supplier ensures you have the necessary information for:
- Generating purchase reports for tax filing.
- Verifying that supplier invoices include valid tax identification numbers.
- Responding to tax authority audits with complete vendor documentation.