Troubleshooting
- Printing
- Signing In
- Selling
- Stock and Purchases
- Missing Pages and Permissions
- Deleting Things
- Customers and Deliveries
- Reports
- The App and the Assistant
Printing
The Print Fails With "Is the printer shared?"
Why: The Print Agent runs on Windows and sends the receipt to the printer through Windows printer sharing. Windows could not find a shared printer with that name. The full message is "Failed to copy to ... Is the printer shared?".
Fix:
- On the Windows computer open the printer's Properties, then the Sharing tab.
- Tick the box to share the printer.
- Make the Share name exactly the same as the printer name.
- Press Test print in Business Settings > Print Management.
When to contact support: If the printer is shared with the right name and the test still fails.
The Receipt Does Not Print After a Web Sale
Why: A receipt goes to an agent only if all of these are true: the agent is active, its location matches the sale's location, and it has a printer with ESC/POS on. The agent's computer must also be on, with the Print Agent running.
Fix:
- Open Administration > Business Settings > Print Management.
- Check the agent shows Online. If Offline, switch the computer on and start the Print Agent.
- Check the agent's location is not "No location". Choose the counter it serves.
- Check the printer shows ESC/POS on and is not Disabled.
- Use Test print.
See Printing Receipts.
When to contact support: If the test slip prints but real receipts do not.
The same cause gives "No receipt printer is set up for this sale's location. Connect a print agent in Business Settings → Print Management." when you press Reprint receipt in Sales.
The Bluetooth Printer Does Not Print From the App
Why: There are several common reasons.
- The printer is not paired in the phone's own Bluetooth settings. The app says "No paired devices. Pair the printer in Android Bluetooth settings first."
- Use built-in printer is still on, so the receipt goes there.
- Bluetooth permission was refused: "Bluetooth permission denied — enable it in app settings."
- The printer is the wrong kind. The app only prints to Bluetooth Low Energy receipt printers such as the P58E. For others you see "No print characteristic found on this printer."
- The printer is off, out of range or out of paper.
Fix: Pair the printer in Android settings. Go to Menu > Settings. Turn Use built-in printer off. Choose the printer under Bluetooth printer and press Test. Allow Bluetooth permission for the app in the phone's settings.
When to contact support: If Test fails with the printer on, near, and paired.
Signing In
I Cannot Sign In After My Subscription Ended
Why: Your business subscription has expired. On the web you reach the Subscription Expired page and nothing else opens. On the app you see "Your account is inactive or the subscription has expired."
Fix: Ask the owner to renew. Contact TradeOne support on +254 711 400 500 (call or WhatsApp) or hello@olin.co.ke. See Subscription.
When to contact support: Right away. Only support can extend the date.
The Credentials Do Not Match, or I Must Wait
Why: You see "These credentials do not match our records." The email, phone number or password is wrong. After 5 wrong tries in a minute, TradeOne makes you wait. Remember a new user's password is 12345 until they change it. Password reset by email works only for accounts that have an email.
Fix: Check your email or phone and password. Try your phone number the way it was saved, for example 0712345678. Wait a minute if you were blocked. Ask your manager to use Reset password in Administration > Admin > Users.
When to contact support: If your manager cannot sign in either.
I Am Stuck on the Security Page
Why: You still have the starting password. TradeOne shows "Choose your own password to continue." and nothing else opens until you change it.
Fix: Type 12345 in Current password, then your new password twice, and press Save. The new password must be at least 4 characters and cannot be 12345.
When to contact support: If Save will not accept 12345 as the current password. A manager can reset it.
Selling
A Product I Have Does Not Show at the Till
Why: The till sells only from the default counter of your branch. If the stock is in a warehouse, or at another location, the till does not show it. You may see "... is out of stock at the counter." when you scan it, or "Only 6 in stock for ..." when you ask for more than the counter holds. A product also does not show if it is deactivated.
Fix: Check Inventory > Inventory Hub > Stock Levels for the item and see which location holds it. Move it to the counter with Transfers. See Inventory. Check the product is Active. Check you are in the right branch.
When to contact support: If the stock is at the counter and the item is active, yet it does not show.
Customer Is Required for Credit or Deposit
Why: Credit and Deposit sales must be attached to a customer. The message is "Customer is required for credit/deposit payments." The mobile app's till has no customer box, so credit sales cannot be completed there.
Fix: Attach a customer on the web till, or choose another payment method.
When to contact support: Only if a customer is attached and you still see it.
My Held Sale Disappeared
Why: Held sales last 2 hours, and then they are removed. You see "That held sale has expired or was already resumed." Also, a held sale is private to the person who held it, and belongs to one till screen and one branch. A sale held on the product till does not show on the Services POS. If you switched branch, it is not listed.
Fix: Re-enter the sale. Next time, resume within two hours. If you cannot find it, check you are the same user, in the same branch and on the same till screen.
When to contact support: Only if it vanished in under two hours while you were the same user in the same place.
The Price Changed After I Received Stock
Why: Price stock by batch is on. Each delivery becomes a batch with its own selling price: its cost times the item's markup, rounded up to a whole shilling. The till uses the price of the oldest batch still in stock. When old stock finished, the next batch's price took over. If the old batch was already empty, the new price applies at once.
Fix: This is working as designed. To check, open the product's edit form and look at Stock batches. To correct one batch's price, use Edit price on that batch. See Products. To stop price changes altogether, switch Price stock by batch off in Business Settings.
When to contact support: If a batch price is wrong and Edit price gives an error you do not understand.
Stock and Purchases
I Cannot Continue or Delete a Draft Purchase Order
Why: A saved draft belongs to the person who saved it. Everyone in the branch can see it (the list shows "By Wanjiku"), but only the author can continue or delete it. You see "Only Wanjiku can change or delete this draft." If you cannot see it at all, you may be in a different branch.
Fix: Ask the author to finish it. Or create a new purchase order yourself.
When to contact support: If the author has left and the draft must go. Support cannot reassign it, so create a new order.
I Cannot Delete or Cancel a Received Purchase
Why: Once received, the stock and the supplier bill depend on it. You see "A received purchase cannot be deleted: its stock and supplier bill depend on it." or "Only a purchase that has not been received can be cancelled."
Fix: Correct the stock with an adjustment. See Inventory. Pay the supplier as agreed. See Purchases and Suppliers.
When to contact support: If a received purchase has a wrong total and you need the supplier balance corrected.
A Service or Job Card Did Not Use Up Its Materials
Why: Materials come from the "Service Consumables" location. If the item is not there, or there is not enough, the sale still completes but that material is not taken out.
Fix: Put stock into "Service Consumables" through a purchase or a transfer. See Services. Adjust the stock by hand for sales already made.
When to contact support: If stock is there and still not used.
Production Says There Is Not Enough Material
Why: Production uses materials at the "Production Floor". The message is "Insufficient material on the production floor for ... Available: 10, required: 15."
Fix: Transfer more of that material to the Production Floor in Inventory > Inventory Hub > Transfers. See Production.
When to contact support: If the stock shows enough but the message stays.
Missing Pages and Permissions
A Menu Item or Tab Is Missing
Why: Either your role does not have the permission, or the module is off. If you open a page by its address without the permission, you see "You do not have permission to access this page." For example:
- Services POS, Services: need the Services module.
- Job Cards: need Services and Job Cards.
- Salesperson POS, Issue to Staff, Return from Staff: need Salesperson POS.
- Transfers, and New location: need Warehouse / multiple stores.
- Production: needs Manufacturing / production.
- Deliveries: needs Deliveries.
- Locations: shows when Warehouse, Services or Manufacturing is on.
Fix: Ask the owner to check Administration > Business Settings > Features, and to check your role in Administration > Admin > Roles. See Users and Roles.
When to contact support: If the module is on, your role has the permission and the item is still missing.
Deleting Things
I Cannot Delete a Category, Location or Product
Why: TradeOne protects data that is in use.
- Category: "Category has 4 product(s); reassign them first."
- Location with stock: "Transfer all stock out before deleting this location."
- Default counter, Service Consumables and Production Floor: "This location cannot be deleted."
- Branch with locations: "Move this branch's locations elsewhere before deleting it."
- Product used in sales, purchases, job cards, production or bundles: "This product cannot be deleted permanently because it is used in sales. It will stay archived." A product must be archived first: "Archive the product before deleting it permanently."
Fix: Do what the message says. For a product, leave it Archived or Deactivate it.
When to contact support: Rarely. These rules are on purpose.
Customers and Deliveries
A Customer's Balance Is Lower Than Expected After a Delivery
Why: When you mark a delivery as delivered from the desk, Cash collected on delivery starts with the full sale total. Whatever amount is left there is recorded as a payment on the customer's account. If the customer had already paid, this counts the payment twice.
Fix: Set the amount to 0 when you close such a delivery. To fix one already saved, record a Refund for that amount on the Customers page, with a note. See Customers.
When to contact support: If many deliveries were closed this way and balances need a clean-up.
This Customer Has No Saved Delivery Location
Why: You see "This customer has no saved delivery location. Add one from the Customers page first." A delivery needs a pin.
Fix: Edit the customer and set the Delivery location. Or text them a link from the mobile app, so they pin it themselves. If a link says "This link has expired or has already been used.", send a new one. Links last 72 hours and work once.
When to contact support: If the map does not load: "Add GOOGLE_MAPS_KEY to show the map". You can still paste coordinates.
The Driver Did Not Get the Notification
Why: The push goes to the phone the driver is signed in to in the app. If the driver is not signed in on any phone, or the phone blocks notifications, there is no buzz. The stop still shows in the app list.
Fix: Ask the driver to sign in to the app and allow notifications. They can open Menu > Deliveries to see the stop.
When to contact support: If a signed-in driver with notifications allowed still gets nothing.
Reports
Two Reports Show Different Totals
Why: Daily Sales adds up each sale's final total (after discount, with tax). Profit and Loss, By Product, By Category and Top Products add up item lines, without the whole-sale discount and without tax. Also check both use the same dates, times and location.
Fix: Compare the same date range, and remember the difference. See Sales Reports.
When to contact support: If the same type of report differs with the same filters.
The App and the Assistant
The App Says Not Enough Stock but the Web Shows Stock
Why: The app sells from the counter chosen in Menu > Settings > Selling location. The web sells from the branch's default counter. They may be different.
Fix: In the app, choose the right branch and Selling location. Check where the stock sits in Inventory.
When to contact support: If both screens use the same counter and still disagree.
The AI Assistant Says I Have Used All My Questions
Why: The business has a daily limit, standard 50. You see "Your business has used all 50 of today's TradeOne AI questions. The count starts again tomorrow."
Fix: Wait until tomorrow, or ask support about a higher limit.
When to contact support: To change the limit.