Device repair

Device repair is for phone, laptop, TV and electronics repair shops. You take a device in at the counter with its IMEI or serial number, the passcode (kept encrypted for your technicians), the accessories left with it and its condition, and print a receipt and a tag with a QR code the customer uses to follow the repair online. You build an estimate of parts and labour, text it to the customer to approve or decline, reserve or order the parts, move the job through the bench with a technician and a time target for each stage, take the balance on an invoice or at the till, and hand the device back against the customer's signature. Repairs carry a warranty, and devices left behind are reminded and flagged for disposal.

Everything is in the Device repair group of the left menu: Repair tickets, Uncollected devices and Repair reports.

Note: device_repair.view lets someone see tickets, print receipts and tags, and see the uncollected devices and reports. device_repair.manage is needed to take devices in, change tickets, build and send estimates, record the customer's answer, reserve and order parts, move tickets, take payments, hand devices back and text reminders. device_repair.technician is needed to see a device's passcode. Owners and admins have all three; the member role has device_repair.view. Set permissions under Settings → Roles (see Roles and permissions).

Switch it on

Device repair is a marketplace app. It needs the Contacts and Sales apps. To take the balance it uses Invoicing or Point of Sale. Inventory lets you reserve spare parts from stock, Purchases lets you order parts from your supplier, and Marketing with an SMS provider sends the texts to customers (see SMS providers).

  1. Open Settings → Marketplace and type Device repair in the Search add-ons… box (marker 1).
  2. On the Device repair card (marker 2), click Start free trial (or Add to subscription) and confirm. The Device repair group appears in the menu.
Marketplace with the add-on search box and the Device repair card marked
Marketplace with the add-on search box and the Device repair card marked

If the card says Not available for purchase yet, ask NaliSuite support to switch it on. See Billing and marketplace.

Settings

Open Settings → Preferences and click the Device repair tab (marker 1). Click Save preferences when you are done.

Preferences on the Device repair tab with the tab, Diagnosis fee, Repair warranty, Take the balance, the texts switch and the condition checklist marked
Preferences on the Device repair tab with the tab, Diagnosis fee, Repair warranty, Take the balance, the texts switch and the condition checklist marked
Setting What it does
Diagnosis fee (marker 2) Charged when the customer declines the estimate. It is filled in on each new ticket, and you can change it there. Leave it at 0 for no fee.
Also charge the diagnosis fee when a device cannot be repaired On by default. When off, a device you could not repair is handed back at no charge.
Repair warranty (days) (marker 3) Counted from the day the customer collects. A device brought back within this time opens a warranty job at no charge. Default 90; enter 0 for no warranty.
Take the balance (marker 4) On an invoice (needs Invoicing) or As a sale at the till (needs Point of Sale). When the app chosen is off, the other one is used; when both are off, payments are only recorded on the ticket.
Charge the default tax on repairs Puts your default sales tax on parts, labour and the diagnosis fee. Off by default. Whether prices include the tax follows your invoicing preference.
The customer must sign on collection On by default. The device cannot be handed back without a signature.
Text customers the estimate, and when the device is ready (marker 5) On by default. Needs SMS set up in Marketing. Reminders you send by hand go out even when this is off.
Technician commission on labour (%) Shown in the reports. Enter 0 if you do not pay commission.
Condition checklist at intake (marker 6) The damage you tick at the counter, such as Screen cracked or Water damage indicator tripped. Type an item and press Enter to add it, click × to remove one. Printed on the receipt.

Further down the tab:

The rest of the Device repair tab with the time targets, reminder days, disposal days and the uncollected devices policy marked
The rest of the Device repair tab with the time targets, reminder days, disposal days and the uncollected devices policy marked
Setting What it does
Time target for each stage (hours) (marker 1) How long a ticket may stay in Received (2), Diagnosing (24), Waiting for approval (48), Waiting for parts (120), Repairing (48) and Testing (8) before it counts as overdue. Enter 0 for no target on a stage.
Remind uncollected devices every (days) (marker 2) How often a reminder text goes to customers who have not collected. Default 7.
Flag for disposal after (days) (marker 3) Counted from the day the device was ready. Default 90.
Uncollected devices policy (marker 4) Printed on the receipt. Leave it empty for the standard wording: Devices not collected within 90 days of being ready may be disposed of or sold to cover the cost of the repair.

Repair tickets

Open Device repair → Repair tickets. The line under the title (marker 1) counts the tickets on the bench, waiting for approval, waiting for parts, past the time target and waiting to be collected.

Repair tickets with the counts, Take in a device, Customer tracking page, the tabs, a warranty job and an overdue stage marked
Repair tickets with the counts, Take in a device, Customer tracking page, the tabs, a warranty job and an overdue stage marked

Each row shows the ticket number with the day it came in, or Warranty job (marker 5), the customer and phone, the device with its IMEI or serial, the stage with the technician, Stage due and the Charge with what has been paid. A stage past its time target shows its due time in red (marker 6) and a red badge.

Search finds a ticket by its number, the customer's name or phone, or the brand, model or serial. The filters are Status (several at once), Technician, Device and Past the time target. Click ⋮ at the end of a row for Edit and the same actions as the ticket's Actions button.

Take in a device

  1. Click Take in a device.
  2. Under Customer, choose the Customer (marker 1). Search by name or phone, or click + to add a new customer with a name, mobile and email.
  3. Check Phone for texts and tracking (marker 2). It is filled from the customer's mobile; the customer finds the repair online with this number and the ticket number.
  4. Choose the Technician (marker 3) if you know who will do the job.
  5. Under Device, choose the Type (marker 4): phone, tablet, laptop, desktop computer, TV, games console, smartwatch, speaker or headphones, or other. Enter the Brand, Model, IMEI or serial number (marker 5) and Colour.
New repair ticket with Customer, Phone for texts and tracking, Technician, Type and IMEI or serial number marked
New repair ticket with Customer, Phone for texts and tracking, Technician, Type and IMEI or serial number marked
  1. Under Lock, choose the Screen lock (marker 1): No lock, PIN, Password or Pattern. For a lock, type the Passcode (marker 2); for a pattern, the dots 1 to 9 in order, such as 1-4-7-8-9. Click the eye to check what you typed.
  2. Under Left with the device, tick the Accessories (marker 3): charger, cable, case or cover, SIM card, memory card, battery, stylus, remote control, box or bag. Type anything else in Anything else.
  3. Under Condition on arrival, tick what you find in Found on the device (marker 4), add Condition notes, and add up to 10 Photos (marker 5) of the damage, 8 MB each.
Lock, Left with the device and Condition on arrival with Screen lock, Passcode, Accessories, Found on the device and Photos marked
Lock, Left with the device and Condition on arrival with Screen lock, Passcode, Accessories, Found on the device and Photos marked
  1. Under Fault, write the Fault reported by the customer (marker 1) and, if you agree a date, Promised by (marker 2).
  2. Check the Diagnosis fee if declined (marker 3), filled in from your settings.
  3. Add any Notes and click Create (marker 4).
The Fault section with Fault reported by the customer, Promised by, Diagnosis fee if declined and Create marked
The Fault section with Fault reported by the customer, Promised by, Diagnosis fee if declined and Create marked

The ticket is numbered, such as DR-2026-00012, and starts in Received. A message Ticket DR-2026-00012 taken in offers Print receipt and Print tag.

The device's type, brand, model, serial, colour, accessories and condition cannot be changed after intake. You can still change the phone, technician, fault, Diagnosis notes, condition notes, photos, promised date and notes on the ticket, then click Save changes.

Important: The passcode is stored encrypted and is never shown on the ticket, the receipt or the tracking page. See Passcodes.

Both are under Actions on the ticket (or ⋮ in the list) and open as PDFs in a new tab.

Warranty returns

When the customer brings back a device you repaired and collected, and its warranty has not run out:

  1. Click Take in a device and type the device's IMEI or serial number (marker 1). Spaces, dashes and capitals do not matter.
  2. NaliSuite shows This device was repaired on DR-… and is under warranty until … (marker 2).
  3. Leave Open a warranty job at no charge on (marker 3) if the same fault has come back. Turn it off to charge for a new fault as usual.
  4. Fill in the rest and click Create.
The Device section with the IMEI or serial number, the warranty message and Open a warranty job at no charge marked
The Device section with the IMEI or serial number, the warranty message and Open a warranty job at no charge marked

The warranty job is linked to the first repair, approved straight away at no charge, and shows Warranty job in the list. You can still add the parts and labour you use, at a price of nothing, so stock is updated. It is collected like any repair, and keeps the warranty end date of the first repair.

The estimate

Open a ticket. The line under the title (marker 1) shows the stage, the technician, when the stage is due, the estimate status and amount, what is left to pay once it is ready, and whether a passcode is kept.

A ticket waiting for approval with the summary line, and the Actions menu with Show passcode, Send the estimate, Record approval and Record decline marked
A ticket waiting for approval with the summary line, and the Actions menu with Show passcode, Send the estimate, Record approval and Record decline marked

Build the estimate in the Estimate and parts tab under the form:

  1. Click Add a part or labour (marker 1).
  2. Choose the Line: Part or Labour.
  3. For a part, choose the Part from the product list to fill in the description and selling price. With Inventory on, the field shows how many are Free to reserve. For a product kept by serial or lot number, choose the Serial or lot number, or leave it empty to use the one expiring first, else the oldest.
  4. Check the Description, Quantity and Price, and click Submit.
The Estimate and parts tab with Add a part or labour, a part line and Edit marked
The Estimate and parts tab with Add a part or labour, a part line and Edit marked

Each line shows its Total and, for parts, its status in Part: Reserved, To order, On order, Used or Released. Use Edit (marker 3) or Remove to change a line. Lines can be changed until the customer approves or declines; after that they are locked. A serial number is one unit, so add a line for each serial number.

Send the estimate and get an answer

Under Actions (marker 1 in the ticket screenshot above):

The customer can also answer on the tracking page; see The customer's tracking page. The history shows who decided and how: by the link in the text, on the tracking page, or recorded by staff.

Parts

When the customer approves, each part on the estimate is set aside:

To order the missing parts, click Actions → Order parts (with Purchases on). Choose a Supplier, or leave it empty to order each part from its product's preferred vendor, and click Submit. NaliSuite drafts one purchase order per supplier, with the note Parts for repair DR-…, and the parts show On order (marker 1). The ticket moves to Waiting for parts. Send and receive the purchase order as usual in Purchases (see Purchases and bills); when the delivery is received, the parts are reserved for the repair and the history says All parts are in.

The Estimate and parts tab with a part On order marked
The Estimate and parts tab with a part On order marked

If stock arrives another way, click Actions → Reserve parts to try again. When the ticket is moved to Ready, the reserved parts leave stock at their cost (the serial or lot chosen, else the one expiring first), and the cost is kept for the parts margin report. When a repair does not go ahead, its parts are released.

Move a ticket through the bench

Click Actions → Move to a stage:

  1. Choose the Stage (marker 2). Only the stages the ticket can go to next are offered.
  2. Change the Technician (marker 3) if someone else takes it over.
  3. Add a Note (marker 4), and click Submit.
Move to a stage with the description, Stage, Technician and Note marked
Move to a stage with the description, Stage, Technician and Note marked
From Can move to
Received Diagnosing, Repairing, Not repairable
Diagnosing Repairing, Waiting for parts, Not repairable
Waiting for approval Diagnosing, Not repairable
Waiting for parts Repairing, Not repairable
Repairing Testing, Waiting for parts, Ready, Not repairable
Testing Ready, Repairing
Ready Repairing

Waiting for parts, Repairing, Testing and Ready need the customer's approval first (a warranty job is approved already). Moving from Waiting for parts to Repairing is refused while a part is still to order or on its way.

Each move restarts the stage's time target. When a ticket passes its target, its technician gets an alert in NaliSuite (or the people who manage repairs, when nobody has the ticket), once per stage. NaliSuite checks every 30 minutes.

When a ticket reaches Ready or Not repairable, the customer gets a text, for example Hello Achieng, your Tecno Camon 20 (DR-2026-00004) is repaired and ready to collect at Acme Traders. To pay: KES 5,200.00. Details: …

Passcodes

Only people with device_repair.technician see Actions → Show passcode. Confirm the message Every look at a passcode is recorded in the ticket history, and the code shows in a message that stays until you close it. The history records who looked and when (not the code). The passcode is erased when the device is collected, and the ticket then shows Passcode erased.

Take payment and hand the device back

Payments are taken once the device is Ready or Not repairable. What is charged:

To take money before collection, click Actions → Take payment, check the Amount, choose Paid by (cash, mobile money, card, bank transfer or other), add a Reference and click Submit. Depending on Take the balance:

The Payments tab on the ticket lists every payment, how it was paid, where it was recorded and who took it.

To hand the device back, click Actions → Collected:

  1. Read the message (marker 1): it says what is still to pay, or Fully paid.
  2. Check Collected by.
  3. If money is owed, enter what is Paid now (marker 2) and how it was Paid by (marker 3), and the Till for Point of Sale.
  4. Only if you agree the customer pays later, turn on Hand over even if not fully paid (marker 4). Otherwise the hand-over is refused while anything is owed.
  5. The customer signs in the Signature box (marker 5) with a finger or the mouse. Clear starts again.
  6. Click Submit.
Collected with the amount still to pay, Paid now, Paid by, Hand over even if not fully paid and the signature box marked
Collected with the amount still to pay, Paid now, Paid by, Hand over even if not fully paid and the signature box marked

A repaired device becomes Collected and its warranty starts; a device not repaired becomes Returned unrepaired. The passcode is erased and the ticket opens read only from then on. With invoices, the invoice is raised now if it was not already. Print the receipt again for the customer's copy.

The customer's tracking page

The customer opens the page from the QR code on the receipt or tag, from the link in a text, or at your workspace address followed by /repair-status (the Customer tracking page button opens it).

To find a repair, the customer enters the Ticket number (marker 1) and the Phone number (marker 2) they gave you, in any format, and taps Find my repair (marker 3).

The Track your repair page on a phone with Ticket number, Phone number and Find my repair marked
The Track your repair page on a phone with Ticket number, Phone number and Find my repair marked

The repair page shows the stage (marker 1), the device, the fault and the diagnosis, the promised date, the estimate (marker 2) with the diagnosis fee, what is left to pay once it is ready, the warranty end date after collection, and the progress so far. While an estimate waits for an answer, the customer types their name, an optional note, and taps Approve the repair (marker 3) or Decline (marker 4). They see a thank-you message and the ticket moves on as if you had recorded it.

A repair page on a phone with the stage, the estimate, Approve the repair and Decline marked
A repair page on a phone with the stage, the estimate, Approve the repair and Decline marked

The progress lists each stage, the estimate's steps, payments, and when parts were ordered and arrived, by date, without your notes. Changes of technician, parts reserved or used, passcode views, reminders and overdue alerts stay inside NaliSuite; you see everything in the History tab of the ticket, where Customer sees it marks what is on the page.

Uncollected devices

Open Device repair → Uncollected devices for every device that is Ready or Not repairable and not yet collected, oldest first. The boxes at the top count the devices and the money owed Up to a week, 8 to 30 days, 31 to 60 days and Over 60 days (marker 1). Your policy is printed under them.

Uncollected devices with the Over 60 days box, Days waiting, a Flagged device and Reminders marked
Uncollected devices with the Over 60 days box, Days waiting, a Flagged device and Reminders marked

Each row shows the ticket, customer, stage, Waiting since, Days waiting (marker 2), the age band, To pay, how many Reminders went out and when (marker 4), and Disposal (marker 3). Filter by Age or Flagged for disposal.

Repair reports

Open Device repair → Repair reports and choose the From and To days (marker 1); the period starts at the beginning of this month.

Repair reports with the period, Jobs by stage, Technicians and Parts margin marked
Repair reports with the period, Jobs by stage, Technicians and Parts margin marked

Good to know

Is a deposit taken at intake? No. Nothing is paid when the device comes in; the customer pays the repair or the diagnosis fee once it is ready. If you want money up front, record it on an invoice in Invoicing yourself.

Are estimates emailed? No. The estimate goes by text with a link to the tracking page, so the customer needs a mobile number and you need SMS set up in Marketing. Without SMS, read the estimate out by phone and use Record approval or Record decline, or send the customer the tracking link yourself.

The customer cannot find the repair online. They need the ticket number on the receipt and the phone number on the ticket (only the last nine digits are compared). Check Phone for texts and tracking on the ticket.

Can I change the estimate after the customer approved it? No, its lines are locked. If more work is needed, take the device in again on a new ticket, or agree the extra with the customer and invoice it separately.

A part is reserved but I used another one. Reserved parts leave stock only when the ticket moves to Ready. Until the customer decides, edit the line and choose the right serial or lot.

Why can't I move a ticket to Repairing? The customer has not approved the estimate yet, or a part is still to order or on its way.

What happens to texts while SMS is not set up? Nothing is sent and nothing is queued. The ready text, estimate texts and reminders only go out through the SMS provider set up in Marketing.

Can I reopen a collected ticket? No. A collected or returned ticket is a record. If the fault comes back under warranty, take it in again as a warranty return.