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.

Modules Users & Security, Settings Access needed Owner or Admin (most tabs) or the specific "Manage Users" / "Access Settings" permission Time ~16 minutes

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.

1

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.

Users & Security · Users

Business Users — email + password, uses a seat

NameEmailRoleService ModulesLast LoginStatus
Ankit Sutariaankit@harborfresh.comOwnerAll modules31/07/2026 09:14Active
Priya Nairpriya@harborfresh.comAdminAccounting, Reports30/07/2026 16:02Active

POS Users — 6-digit PIN, no seat used

NameUsernameRoleOffice AccessWarehouse AccessStatus
Sam Fletcher (you)sfletcherPOS CashierBNE only—Active
Wei ZhangwzhangWarehouse OperatorUnrestrictedMain DCActive
No email invite — there's no "send an invitation" step for either kind — you set the password (Business User) or PIN (POS User) directly when creating the account. A brand-new POS user is forced through a "Set Your PIN" screen on first login, with no way to skip it.
2

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.

+ Add Business User
Priya Nair
priya@harborfresh.com
••••••••
Admin

📦 Service Modules — quick template: Finance Officer

Accounting ✓Reports ✓CRMWarehouse eCommercePOSTMSDashboard ✓
+ Create UserCancel
Quick templates — instead of ticking modules one at a time, a template dropdown (CRM/Sales, Finance Officer, Warehouse Supervisor, eCommerce Manager, POS Manager, Logistics Coordinator, Operations Manager, or Full Access) fills in a sensible starting set, which you can still hand-adjust afterward. There's also a standalone "🧾 Expense claims only" toggle for a login restricted purely to the mobile expense portal.
3

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.

Permission Overrides · Finance Officer

Finance

General Ledger & Accounting
Post Manual Journal Entries
View & Record AP Payments
View & Record AR Receipts

Administration

Access Settings / Admin Panel
Manage Users & Roles
View Audit Log
Manage Office Profiles
↺ Re-apply from role & modules💾 Save Changes
Rechecked live, not just at login — a sensitive action like approving a CGT disposal or posting a manual journal isn't just hidden in the menu for the wrong role — the server checks the exact permission flag on the user's record fresh on every single request, so revoking it here takes effect immediately, even on a device that's already logged in.
4

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.

Audit Log
🔍 Search user, action, details…All Actions
TimeUserActionDetails
31/07/2026 09:02Priya NairUNLOCKUnlocked account: Sam Fletcher
30/07/2026 17:45Ankit SutariaPERMISSION_CHANGEGranted canPostJournals to Priya Nair
⬇ Export CSV
No user is ever silently deleted — the toggle here is Enable/Disable, not delete — a disabled account keeps its full audit history and can be re-enabled later without losing anything.

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.

1

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.

Settings · Office Profile
Harbor Fresh — Brisbane
Australia
51 824 753 556
10%

☑ Set as Primary/Head Office

+ Add OfficeSave
1a

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.

SettingWhereWhat it does
Which offices a person may useUsers & Security · Business User · OfficesTick 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 prefixOffices · edit office · Document Number Prefix1–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) officeOffice Profile · Set as Primary/Head OfficeRecords 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.

Journals follow the document. A sale, payment, payment reversal, discount or return takes the office of its invoice (the letters in its number), and a stock receipt takes the office its tag was made in. The office P&L and Balance Sheet always add up to the whole-business figures.
BAS is business-wide. The BAS summary is for the one ABN, so it is not split by office.
2

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.

Save Loyalty SettingsSave Pricing Tiers Save WMS SettingsSave POS Settings
Office/Sync tab — also worth knowing about: it shows which office and warehouse you're currently working in, lets you switch to another office you're allowed to use (the top-bar office badge does the same), and has a 🔄 Force Sync Now button plus the POS Terminal and Warehouse registries (+ Add Terminal / + Add Warehouse) for multi-device setups.
3

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.

Settings · ERP Controls
Approval ThresholdLimit
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

Weighted Average
Enabled

☑ Post COGS on sale

4

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.

Settings · License
Plan
Growth
Status
Active
User Seats
4 / 10
TerminalDeviceActivatedStatusActions
POS-01Counter iPad THIS DEVICE02/01/2025ActiveDeactivate
POS-02Back Office PC14/03/2025ActiveDeactivate
Freed a seat by mistake? — deactivating a terminal here doesn't touch any User account or its permissions — it only revokes that specific device's activation, so a replaced till can be swapped in without recreating any users.
5

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

  1. Sign in to NiyuSuite in a browser and go to Settings › Mobile App.
  2. On your phone or tablet, tap Download for Android. On a computer, scan the QR code with the phone's camera instead.
  3. 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

  1. Open niyusuite-staff.apk from your browser's downloads, or from the My Files app on a Samsung phone.
  2. If Android asks, allow your browser or My Files to install apps, then tap Install.
  3. Open NiyuSuite and sign in with your usual details.
Installing a new version — follow the same steps and install over the top. There's no need to uninstall first. Most NiyuSuite updates reach the app by themselves, so you only need to do this when you're told a new version is available.
Only install from NiyuSuite — get the file from Settings › Mobile App after signing in. Never install a NiyuSuite file sent by email, text or chat, even if it looks like it came from someone you know.
6

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 seeWhat 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.

  1. Open Settings › Security and privacy › Auto Blocker.
  2. Turn it off, confirming if asked.
  3. Install the app using the steps above.
  4. Go back to Auto Blocker and turn it on again.
Installing a new version later — Samsung says an app from outside the official stores can't be updated while Auto Blocker is on, so turn it off again for that update, then back on.
Work phones — if your phone is managed by your employer, these settings may be locked. Ask whoever looks after your phones. Keep Google Play Protect turned on: you don't need to turn it off to install NiyuSuite.
7

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)

  1. Add your Stripe keys in the online store settings. The same keys are used for online orders and Tap to Pay.
  2. Give each office its full street address, suburb, state and postcode in Settings › Offices. Stripe needs it.
  3. In Settings › Mobile App, tick Take card payments with Tap to Pay on the staff app.

What the phone needs

NeedsWhy it matters
Android 13 or later, with NFC and the Google Play StoreOlder phones don't show the Tap to Pay button.
A security update from the last 12 months, not rootedStripe refuses phones that fail its security check.
Developer options off; no screen recording or apps drawing over the screenThe most common reason a payment is refused on a phone that otherwise works.
NFC and location turned on, and an internet connectionThe first time, Android asks to allow location and nearby devices. Allow both. Tap to Pay is not offered offline.

Taking a payment

  1. 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.
  2. 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.
  3. 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 seeWhat to do
Paid, no sale savedThe 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 savedThe 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 confirmedStripe hasn't answered yet. Check again in a few minutes.
In Stripe, not from a tillA payment taken in the Stripe Dashboard or another app. Shown for your information.
Fees and payouts — Stripe charges its card fees plus a fee for each Tap to Pay payment, and pays the money, less fees, into your bank a few days later. Record the fees when you reconcile the Stripe payout in your bank feed, as you do for terminal settlements.
Phone tills that stop — if the app closes during a payment, open it again and check the day's list before charging the customer again. The till also warns when it opens if a payment on it has no sale.