Training guide · Users & Settings
Two ways to log in, one system deciding what you can touch
NiyuSuite has two separate account types — a cloud Business User (email + password, uses a licensed seat) and a local POS User (name + PIN, doesn't) — each with its own fixed role list and its own module/permission grid layered on top. Settings is where the rest of the business gets configured: offices, tax, approval thresholds, warehouse names, and the subscription itself. This guide covers both, plus the audit trail that watches what everyone actually does.
Users & Security
Users & Security
Four tabs: 👤 Users, 🔒 Security Roles & Permissions, 🧭 Security Process, and 📋 Audit Log. Everything about who can log in, what they're called, and what they're allowed to touch lives here.
Two account types, not one
Clicking + Add User asks which kind of account you're creating first, because they work differently underneath: a Business User signs in with an email and password from anywhere and consumes one of the tenant's licensed User Seats; a POS User unlocks a till or warehouse screen with a 6-digit PIN, stays local to the workspace, and doesn't use a seat at all. Both get full name, role, and module access — the login method and licensing are what differ.
Business Users — email + password, uses a seat
| Name | Role | Service Modules | Last Login | Status | |
|---|---|---|---|---|---|
| Ankit Sutaria | ankit@harborfresh.com | Owner | All modules | 31/07/2026 09:14 | Active |
| Priya Nair | priya@harborfresh.com | Admin | Accounting, Reports | 30/07/2026 16:02 | Active |
POS Users — 6-digit PIN, no seat used
| Name | Username | Role | Office Access | Warehouse Access | Status |
|---|---|---|---|---|---|
| Sam Fletcher (you) | sfletcher | POS Cashier | BNE only | — | Active |
| Wei Zhang | wzhang | Warehouse Operator | Unrestricted | Main DC | Active |
Roles come from a fixed list, not free text
You pick a role from a dropdown — you can't type a custom title. Business Users choose from just three: Owner, Admin, or Service User ("standard business access — permissions determined by assigned modules"). POS Users choose from ten, built around shop- floor jobs: Admin, Manager, Master Data Editor, POS Cashier, eCommerce Operator, Warehouse Operator, Finance Officer, Production Operator, Reporting & Analytics, and User Administrator.
📦 Service Modules — quick template: Finance Officer
Permission overrides sit underneath the role
Role and module access decide the broad shape of an account; a Permission Overrides panel underneath lets you grant or remove individual actions without changing the role itself — the same nine permission groups apply to both account types (Master Data, Transactional/POS, Finance, Administration, and others). Each role applies a sensible default set of these on creation; a ↺ Re-apply from role & modules button resets any manual overrides back to that default if things drift.
Finance
Administration
Audit Log and unlocking a locked-out account
📋 Audit Log is a searchable record of who did what and when — search by user, action, or details, filter by action type, and ⬇ Export CSV for a compliance request. Up in the header, 🔓 Unlock Account lists anyone currently locked out (too many failed PIN/password attempts) with a one-click 🔓 Unlock — itself logged as its own audit entry.
| Time | User | Action | Details |
|---|---|---|---|
| 31/07/2026 09:02 | Priya Nair | UNLOCK | Unlocked account: Sam Fletcher |
| 30/07/2026 17:45 | Ankit Sutaria | PERMISSION_CHANGE | Granted canPostJournals to Priya Nair |
Settings
Settings
A left-hand tab list covering everything from company details to the subscription itself. The tabs used day to day are Office Profile, Loyalty, Pricing Tiers, Warehouse, POS Batch Tracking, Office/Sync, Import Center, ERP Controls, and License — a couple of specialist tabs (QuickBooks Transition migration, Messaging branding) exist for specific onboarding needs and aren't covered in depth here.
Office Profile: the business itself
Office Profile is where each physical location's legal details live — name, country (AU/US), tax rate, ABN/EIN, address, logo, and an invoice footer message — with one office flagged Set as Primary/Head Office. A separate Default Tax Rate field acts as the AU GST fallback (10%) when an office doesn't override it, and Workspace Branding controls the accent colour and logo shown across the whole app.
☑ Set as Primary/Head Office
Working across offices: access, numbers and switching
A business with more than one office keeps one ledger, one ABN and one chart of accounts. The office is a tag on each record, so every report can be shown for the whole business or for one office. Customers, suppliers and the product catalogue are shared by all offices.
| Setting | Where | What it does |
|---|---|---|
| Which offices a person may use | Users & Security · Business User · Offices | Tick the offices the person may work in. Leave all unticked for every office. The radio dot beside an office marks the one they start in. Owners and admins always see every office. |
| Document number prefix | Offices · edit office · Document Number Prefix | 1–6 letters. The main office keeps plain numbers (invoice 5000123); an office with the prefix MEL issues MEL5000001, sales orders MEL4000001, purchase orders MEL3000001, and returns RMA-MEL-000001, each from its own counter. Once any prefix is set, every other office needs one before it can issue numbers. An office's prefix is locked after it has issued a number. |
| Main (primary) office | Office Profile · Set as Primary/Head Office | Records with no office, including everything created before offices were set up, count as the main office. |
Switching office
Click the office badge in the top bar (Office › Warehouse › POS) and pick another office from the list. The page reloads in that office, so save your work first. The same buttons are on Settings · Office/Sync. Both lists show only the offices your login allows. If you have just one office, the badge opens Settings instead.
Accounting reports have their own office dropdown in the Accounting Center header (All offices or one office). It filters the Trial Balance, P&L and Balance Sheet only; it does not switch the office you work in. A restricted person sees All my offices.
Loyalty, Pricing Tiers, Warehouse, and POS Batch Tracking
Four smaller, single-purpose tabs sit alongside Office Profile: Loyalty Program (points per dollar, points needed per $1 reward, Silver/Gold thresholds), Pricing Tiers (group-level customer discount tiers), Warehouse (WMS) (warehouse name and named receiving/dispatch docks), and POS Batch Tracking (a single toggle that turns on batch/expiry capture at the till). Each has its own Save … button rather than one global save for the whole screen.
ERP Controls: approval thresholds and costing method
This is where the business sets its own guardrails — dollar/percentage limits above which an action needs a second person's approval, and how inventory is costed. Nothing here changes what a role can do (that's Users & Security) — it changes at what size an otherwise-allowed action needs a second look.
| Approval Threshold | Limit |
|---|---|
| Stock adjustments | $250.00 |
| Discount % | 15% |
| Supplier / customer payments | $5,000.00 |
| Credit notes / Debit notes | $500.00 |
| Manual journals | $1,000.00 |
| Bank reconciliation bypass | $50.00 |
Inventory Costing
☑ Post COGS on sale
License: seats and terminal activations
The License tab shows the subscription Plan and Status, how many User Seats are used versus available (this is what a Business User consumes and a POS User doesn't), and every POS terminal that's ever activated against this tenant — each row fingerprinted to a specific device, with the one you're on now flagged THIS DEVICE.
| Terminal | Device | Activated | Status | Actions |
|---|---|---|---|---|
| POS-01 | Counter iPad THIS DEVICE | 02/01/2025 | Active | Deactivate |
| POS-02 | Back Office PC | 14/03/2025 | Active | Deactivate |
Install the Android app
The NiyuSuite app runs on Android 8 or later and adds camera barcode scanning. It isn't on the Google Play Store yet, so you download it from NiyuSuite. On an iPhone or iPad, use NiyuSuite in Safari instead.
Download it
- Sign in to NiyuSuite in a browser and go to Settings › Mobile App.
- On your phone or tablet, tap Download for Android. On a computer, scan the QR code with the phone's camera instead.
- If your browser warns that the file might be harmful, choose to download it anyway, as long as it came from Settings › Mobile App.
Install it
- Open
niyusuite-staff.apkfrom your browser's downloads, or from the My Files app on a Samsung phone. - If Android asks, allow your browser or My Files to install apps, then tap Install.
- Open NiyuSuite and sign in with your usual details.
If Android blocks the install
Android is careful about apps from outside the Play Store, so a warning doesn't mean something is wrong. Find the message you see below. The wording and menu names can differ a little between phones.
| What you see | What to do |
|---|---|
| Your phone isn't allowed to install unknown apps from this source | Tap Settings, turn on Allow from this source, go back and tap Install. |
| Samsung: a pop-up says the app can't be installed, or the setting above is locked | Auto Blocker is on. Follow the Samsung steps below. |
| App Scan Recommended, or Play Protect hasn't seen this app before | Tap Scan app, wait for the result, then carry on installing if it's clear. |
| Send App for Security Check | Tap Send this time, then carry on installing if it's clear. |
| Harmful App Blocked | Stop. Don't try to get around it. Delete the file and contact NiyuSuite support. |
| Anything about unverified developers, or asking you to turn on Developer options | Stop and contact NiyuSuite support. Don't turn on Developer options to install the app. |
| App not installed | Check you have free storage, and download the file again in case it was incomplete. If it still fails, contact NiyuSuite support before uninstalling anything. |
Samsung phones: Auto Blocker
Many newer Galaxy phones have Auto Blocker on, which stops apps from outside the official stores.
- Open Settings › Security and privacy › Auto Blocker.
- Turn it off, confirming if asked.
- Install the app using the steps above.
- Go back to Auto Blocker and turn it on again.
Tap to Pay on the phone
With Tap to Pay, the customer taps their card or phone wallet on the back of a staff phone running the NiyuSuite app, with no EFTPOS terminal. The money goes to your own Stripe account, and the sale records itself as a card sale. EFTPOS terminals keep working as before.
Before you start (owner)
- Add your Stripe keys in the online store settings. The same keys are used for online orders and Tap to Pay.
- Give each office its full street address, suburb, state and postcode in Settings › Offices. Stripe needs it.
- In Settings › Mobile App, tick Take card payments with Tap to Pay on the staff app.
What the phone needs
| Needs | Why it matters |
|---|---|
| Android 13 or later, with NFC and the Google Play Store | Older phones don't show the Tap to Pay button. |
| A security update from the last 12 months, not rooted | Stripe refuses phones that fail its security check. |
| Developer options off; no screen recording or apps drawing over the screen | The most common reason a payment is refused on a phone that otherwise works. |
| NFC and location turned on, and an internet connection | The first time, Android asks to allow location and nearby devices. Allow both. Tap to Pay is not offered offline. |
Taking a payment
- Ring up the sale and tap Pay, then Tap to Pay. In Split Tender, tick Take the EFTPOS part with Tap to Pay on this phone.
- When Stripe's screen appears, the customer taps their card or phone on the back of the staff phone, and enters their PIN on the screen if asked.
- The sale finishes by itself when Stripe confirms the payment. The receipt shows the card and approval details.
Refunds and voids
Refund or void the sale as usual. The card part goes back to the customer's card automatically, and the message says how much went back and to which card, so don't refund it again on a terminal. If Stripe refuses the refund, nothing is saved and the message says why.
Checking the day (owners and managers)
Open Sales History and choose Tap to Pay check, then pick a day and tap Check. Owners, admins and anyone allowed to give refunds see the button. It compares the day's Tap to Pay sales with Stripe, and lists anything that needs a person:
| What you see | What to do |
|---|---|
| Paid, no sale saved | The card was charged but the phone stopped before the sale saved. Either Refund to card, or ring the sale up again another way and Resolve it with a note. |
| Refunded, no refund saved | The money went back to the card but the refund wasn't saved. Trying the refund again uses it. Or enter the refund by hand and Resolve it with a note. |
| Refund not confirmed | Stripe hasn't answered yet. Check again in a few minutes. |
| In Stripe, not from a till | A payment taken in the Stripe Dashboard or another app. Shown for your information. |