Warranty & Guarantee
Warranty cards per serial, when the cover starts, expiry reminders, and dealer claims that end in a replacement serial.
Every serial-tracked hearing aid you sell can carry a warranty card: who bought it, from which dealer, on what date, and until when it is covered. When a unit fails, the dealer raises a claim from the portal, you review it, and the claim ends with a replacement serial that takes over the remaining cover.
Switching it on
Warranty & Guarantee is free, ships with the script and is on after installation (Admin → Addons, Warranty & Guarantee Addons).
Switched off, its screens leave both panels and the invoice editor loses its warranty box.
What it adds
- Admin → Warranty and Admin → Claims & Replacement in the Sales & Service group. The number beside Claims & Replacement counts claims that are pending or in review.
- Dealer portal → Warranty and Dealer portal → Claims under My business.
- A Warranties expiring card on your dashboard and an Active warranties card on the dealer's.
- Start the warranty from this invoice date on the invoice editor, and a Register button beside each serial on an invoice in the dealer portal.
Its settings
Admin → Addons → Warranty & Guarantee Addons → Settings.
| Setting | Default | What it does |
|---|---|---|
| Warranty card prefix | WR | Cards are numbered WR-2026-0001, starting again each year. |
| Claim number prefix | CLM | Claims are numbered CLM-2026-0001. |
| Dealers may register warranty cards themselves | on | Off: the dealer sees their cards but cannot add or edit them. |
| Dealers may raise replacement claims | on | Off: claims are raised by head office only. |
| Start the warranty when stock is invoiced to a dealer | off | The starting position of the invoice editor's warranty box. |
| Warn this many days before a warranty expires | 30 | Used by the dashboard card and the cron reminder. |
| Mark the old serial "replaced" when a claim is completed | on | The faulty serial gets the status Replaced and a note naming the claim. |
Saving also writes the two prefixes into Admin → Settings → Company & invoice, so change them here.
The terms and when the clock starts
The number of months comes from the product: Warranty (months) and Guarantee (months) on Admin → Products (see Brands, products and serial numbers). A warranty claim asks for a repair or a replacement; a guarantee claim asks for a replacement.
You choose when the cover starts. When you invoice stock to a dealer, leave Start the warranty from this invoice date unticked for normal supply: the cover then begins on the day the dealer registers the sale to the end customer, so shelf time is not charged against the customer. Tick it when the dealer buys for immediate use; the serials on that invoice take their dates from the invoice date.
Registering a card
Dealer portal → Warranty → + Register a warranty, or Register beside a serial on one of the dealer's invoices. The dealer picks a serial allocated to them, enters Sold on and the customer's name, phone, e-mail and address, and saves. The terms come from the product record and cannot be changed by the dealer. With the Dealer Customers addon, a retail sale makes the card by itself.
Admin → Warranty → + Register a warranty does the same for head office, with more freedom: Product and Sold by are filled from the serial, the months from the product but editable, and Status can be Active, Expired, Void or Replaced.
Saving a card marks the serial sold and stores its warranty and guarantee end dates on it.
The warranty list
Admin → Warranty counts all cards, the active ones, those expiring within 60 days and the expired ones. Search by card, serial, customer or phone, and filter by dealer and status. Each row shows the days left (amber under 60) with Edit, Claim and ×. The dealer's own list works the same way.
Claims and replacement
- The dealer raises it: Dealer portal → Claims → + Raise a claim (or Claim beside a card), with the Faulty serial number, the Claim type, What is wrong? and a photo or report, then Send the claim. Your bell shows New warranty claim. Head office can raise one too on Admin → Claims & Replacement.
- You move it on. Open the claim. Under Move this claim on press In review, Approve, Reject or Close. Each step tells the dealer.
- You issue the replacement. Under Issue a replacement, pick the Replacement serial (the list offers in-stock and allocated serials of the same product), add a note and press Complete the replacement.
The new serial goes to the dealer as sold with the end dates of the original: the replacement inherits the remaining cover, it does not start a new one. The card moves to the new serial with a note naming the claim, the old serial is marked replaced, the claim becomes Replaced, and the dealer receives Replacement approved with the new serial.
The permissions are View warranty registrations, Register / edit warranties and Approve, replace or reject claims.
Expiry reminders
The dashboard card counts active cards that expire within the days you set. The cron job also puts a Warranty expiring soon notification in the dealer's panel on the day a card is that many days from its end, so the dealer can call the customer in time. The cron line is in Scheduled jobs (cron).
Tips
- Fill in warranty and guarantee months on every product before the first sale; a product with 0 months gives a card with no end date.
- Ask dealers to register the sale on the day: the cover runs from the date on the card.