Ritzy One • User Manual
Everything every user needs before opening a module — signing in, two-factor authentication, finding your way round the screen, the financial year, how forms, grids, printing and attachments behave — and, for administrators, users, groups and rights, System Settings and the licence.
Open the Ritzy address your administrator gave you. The card reads Welcome back and Sign in to your account.
Your browser remembers the last company and User ID you used, so next time only the password is needed. If your account has two-factor authentication switched on, a second step asks for a code (§2).
After signing in you land on the first module your company has, in this order: Cargo, CRM, Real Estate, Liner, Marine, Shipchandling, Transport, Warehousing, Inventory, Payroll, Accounts. Administrators, and users an administrator has given Dashboards in User Manager (§13), open on that module’s Dashboard. Everyone else opens on a start page: a Welcome card for each module with links to its first screens, which opens straight away because it reads no figures.
| Message | What it means |
|---|---|
| Invalid user ID or password | Check Caps Lock and the company you picked — users are set up per company. |
| Cannot reach the Ritzy server… | The Ritzy service on the server is not running or the network is down. Click Try again; if it persists, tell your IT contact. |
| Maximum concurrent users (N) reached… | All licensed seats are in use. See §16. |
| This browser was idle and another user has taken the licensed seat… | Your computer was idle for more than about 5 minutes and a colleague signed in on the last seat. Sign in again when a seat is free. See §16. |
| Your subscription has expired… / is not active | The company’s licence needs renewing. See §16. |
Two-factor authentication (2FA) asks for a 6-digit code from an authenticator app on your phone as well as your password, so a stolen password alone cannot open your account. It is set up per user, by the user.
After the password, enter the current 6-digit code from the app and click Verify. Codes change every 30 seconds; a phone clock that is a little out is tolerated.
To stop using 2FA, open My Account and click Turn off two-factor authentication.
If the code step sits too long you may see Invalid or expired login session — please sign in again; click Back to sign in and start over.
Tools → Change Password (always the first item under Tools).
Forgotten your password? Only an administrator can reset it, from User Manager (§13).
On the left, one button per module your company is licensed for and you have rights to (Accounts, Cargo, Inventory, Payroll…), with Tools at the end. Click a module and the left menu changes to its screens.
On the right, from left to right:
| Icon | What it does |
|---|---|
| Search menu | Find any screen by name, in any module (below). On a narrow window it shows as a magnifying glass. |
| Ritzy Support | An AI assistant you can ask how to do something, by voice or keyboard. It explains how Ritzy works; it never reads your company’s data. See the Customer Support manual. |
| Raise a support ticket | Report a problem to your own administrators, with screenshots if helpful. |
| Help (?) | Opens the manual at the section for the screen you are on — for example Posting a voucher from a Purchase, or Processing a salary period from Salary Process. A screen with no section of its own opens its module’s manual. Shift+F1 does the same from the keyboard; F1 opens Ritzy Support, even inside a popup window. |
| Bell | Your notifications, with an unread count. My Notifications shows Received and Sent messages; you can also send a message to colleagues from here (a green dot means they are online). |
| User ID / avatar | Opens My Account (§2). |
| Sign out | Ends your session and frees your seat straight away. |
Click Search menu in the top bar, or press Ctrl+K on any screen (⌘+K on a Mac), and type part of the screen’s name.
Each module’s menu starts with links such as Dashboard (for users who see dashboards, §13), Quick View and Reports, then sections — Operations, Sales, Transactions, Masters, Tools — one open at a time. The « button collapses the menu to give the screen more room.
You only see screens you have the View right for (§14). If a colleague can see a screen you cannot, ask your administrator.
The foot of the menu shows the financial year (§5), the licence badge (§16) and the version of Ritzy One you are running, as a number taken from its release date — for example v2026.11.20. Hover over it for the full release name. Quote it when you contact support.
Tools → Knowledge Base holds your company’s own help articles — how-tos, policies and answers your team reuses — for every module. It is there for every signed-in user, whichever modules your company is licensed for.
With CRM, a customer case also suggests matching published articles and can link them; an article linked to a case cannot be deleted until it is unlinked. See Customer cases, SLA & knowledge base.
Full dates show as dd/mm/yyyy everywhere, whatever language your browser or PC is set to: screens, date pickers, printed documents, emails, notifications, CSV exports and the phone apps. A date you type is read the same way. Short labels, such as a chart axis, may show only the day and month, or the month and year.
Money shows to the decimals of your company’s base currency — three places for a BHD company (fils), two for most others — on screens, reports, dashboards, prints and the phone apps. A document in another currency shows its own amounts to that currency’s decimals (a USD invoice in cents). Amount boxes stop at those decimals, and amounts are saved to that smallest unit. The decimals are set on each currency in Accounts → Masters → Currency. Percentages and quantities keep their own formats.
At the foot of the left menu, Financial year shows the year you are working in — marked (current) for the open year or closed for a finished one.
Tools → Year-End Process opens the next financial year so that transactions can be entered in it. Despite the name, it closes nothing. You need the View right on Year-End Process in Accounts, Cargo or Inventory (§14).
Reports, dashboards and the date filter of document lists all choose their dates with the same panel — the one Ritzy 8 users know from every report dialog:
◉ Upto ○ For ○ Today ○ As On November, 2026 ▾ 01/04/2026 → 30/11/2026
| Choice | Dates it gives |
|---|---|
| Upto | From the first day of the financial year to the last day of the month chosen in the list. |
| For | The month chosen in the list, first day to last. |
| Today | Today only. The month list is not used. |
| As On | One date. The box shows a single As On date, today when you pick it; choosing a month moves it to that month’s last day. |
Every entry screen — a voucher, a job, a master — works the same way. A saved record opened from a link or a report opens read-only so nothing changes by accident. Opened from its list with the pencil or a double-click (§7), it opens ready to edit, unless it is locked.
| Mode | Buttons you see |
|---|---|
| View (saved record) | Attachments Print, any screen-specific actions, and Edit. |
| Edit (new or being changed) | AI Paste where offered, Undo and Save. |
Vouchers, invoices, jobs, orders and other transactions have no Delete button. Once saved, a transaction’s number has been issued, so it is withdrawn with Cancel instead — even an unposted draft. Cancelling reverses what the transaction did (its ledger entries, or its stock movement) and reopens anything it had settled, but the record stays in its list with its number, shown in red with a red Cancelled tag. A cancelled record is read-only for good.
Some transactions cannot be cancelled while something else depends on them — a voucher another payment has been allocated against, a Cargo, Liner or Transport job with a live invoice, voucher or other document on it — and the message says what to undo first.
Masters (customers, accounts, products, currencies…) can still be deleted, but only while nothing uses them. A master used by any transaction — a cancelled one included — or set in a setting, such as one of the company default accounts, is refused with a message saying where it is used. Mark it inactive or on hold instead.
Picking a customer, a port, a product… and it isn’t in the list yet? Most master dropdowns have a + button on their right.
The + appears only if you have the New right on that master (§14), and only in edit mode. Without the right the plain dropdown shows, and the server refuses the record even if the request is sent some other way. The right is the same one that lets you add that record on its master screen, so a user who may only pick existing customers never sees the button.
The short form asks for what the record cannot do without. Complete the rest on the master screen when you have a moment. A new item, for example, needs only its description, type (stock or non-stock), code, category, unit, location, tax and accounts: the code takes the next number when your company auto-numbers items, and the accounts start from your Inventory Settings. Selling prices, stock levels, bins and supplier lists are added on the Product master, and opening stock is never asked for, because the document you are entering is what brings the stock in.
Some dropdowns deliberately have no +:
| Field | Why not |
|---|---|
| Chart-of-accounts accounts (income, expense, bank), currencies, tax codes | They decide where postings land and how every amount is worked out, so they are set up from their own masters. Customers and suppliers are the exception. |
| Employees, salesmen, leave types | A personnel record, commission attribution and accrual rules do not fit a short form. |
| Properties and units (Real Estate) | A building comes with its units, furnishing, rents and meters. |
| Pack units and price lists (Inventory) | A pack unit’s conversion factor drives every stock figure, and an empty price list prices nothing. |
| The party and items on a return, and items on a transfer or issue | You can only return or move what is already on record, so these offer existing records only. A stock adjustment can add a new item, for stock found on a count. |
On many entry screens AI Paste fills the form for you from free text.
In the same window, Import CSV loads rows from a file:
To load a whole master list — accounts, customers, suppliers, products, ports, vessels and the other masters — use Tools → Import (CSV) and choose the master, or the Import CSV button on the master screen itself. Ritzy checks every row before saving, lets you skip or update records that already exist, and reports the result row by row. See Importing Masters from CSV.
Print never sends straight to the printer. It opens a print preview in a new window with Print and Close at the top, so you can check the document first. Table headings repeat on every page.
If nothing appears, your browser blocked the pop-up — allow pop-ups for the Ritzy address and click Print again.
A cancelled record still prints, with a large red CANCELLED stamp across each page.
How documents look — your logo, letterhead and layouts — is covered in Printed Documents & Reports.
Keep the paperwork with the record it belongs to. On a saved record click Attachments (the paperclip; the number is how many files are already attached).
Each file can be viewed, downloaded, edited or deleted from the list.
Two people can work in Ritzy at once — including colleagues still on the desktop version. If you save at the very moment a colleague is saving the same record, or something it updates such as an account balance or a stock level, Ritzy waits up to 15 seconds for them to finish. If they are still busy you see:
Numbers are taken when you save, not when you open a new form. If a number shown on a new form is a preview, the saved record may get the next one because a colleague saved first — that is normal and keeps every number unique.
Posting runs — post-dated cheques, recurring vouchers, depreciation, payroll — are protected the same way: if two people post the same thing together, it is posted once and the second person is told or simply sees fewer items posted.
The same goes for every raise, generate or post invoice action: Cargo invoices and cash memos (and their Post), Inland Transport and Ship Chandling Raise Invoice, Marine Generate Invoice, a quotation or purchase order turned into an invoice or purchase, Cost Allocation, Warehousing storage billing and receiving, Real Estate monthly invoices, electricity billing, holiday check-out and collections, and Payroll Generate. If two people (or one double click) do it at once, the second waits for the first and is then refused, so the voucher is made only once.
Tools → User Manager, Users tab. For administrators.
Edit the user and type a new password. Leave the password blank to keep the current one while changing other details.
Rights are given to groups, and users get them by being members. Set rights once for “Accounts Clerks” and every clerk you add later inherits them.
| Right | Allows |
|---|---|
| View | See the screen in the menu and open its records. |
| New | Create records — also controls the + quick-add (§8). |
| Edit | Change saved records. |
| Delete | Delete unused masters, and cancel transactions (§6). |
| Print and preview. | |
| Post | Post, approve or finalise, where the screen has such a step. |
Ticking any right ticks View too; unticking View clears the rest. The box in each column heading ticks the whole column.
On a master screen (Customer, Supplier, Vessel, Port, Currency, Chart of Accounts and the rest), a user without New or Delete does not see those buttons. Without Edit, the pencil becomes an eye: View opens the record read-only, with no Save. On the Currency screen, adding or fetching a rate counts as an edit. The server refuses these actions too, so they cannot be reached any other way. A master that two modules share, such as Vessel in Cargo and Liner, takes the right from either module.
The ADMINISTRATOR group always has every right and cannot be restricted, edited or deleted.
Tools → Preferences → System Settings. Change what you need, then Save; Reset discards unsaved changes.
| Tab | What it holds |
|---|---|
| General | On/off switches for how the company works: Save & Post for Transactions (adds a draft step, see below), multiple currency, salesman master, job costing, auto job number, cost centre, department mandatory for P&L accounts, default tax inclusive, due-days blocking, blocking customers over their credit limit, branches, over-expense and revenue-leak control. Also the Bank Reconciliation mode (Simple or Extended). |
| Company & Tax | Company address and contacts, the report header address, the captions for the two spare customer/supplier fields, the company logo, branch, CR No and VAT No. On your own server, also the Public Address used in customer tracking links (Milestone manual). Saving also sends the company's email, telephone, city, country and base currency to the Ritzy License Server, so Ritzy's record of your company stays current. |
| Bank Accounts | Up to four bank accounts printed on invoices — bank name, account name and number, IBAN and SWIFT. |
| Reports & PDF | Decimal suppression, statement footer, default email body, the company mail (SMTP) server, and PDF font and compression options. |
| Transaction Control | Which accounts each voucher type may use and pre-selects (see the Accounts manual), and Enable Posting, which gives a Shipping billing document type a draft step (see the Cargo manual). This tab has its own Save, on the Settings card. |
| Control Accounts | The accounts Ritzy posts to automatically — for example the Exchange Difference account used when a foreign bill settles at a new rate, and the Depreciation account. |
| Voucher Numbers | Prefixes and next numbers per voucher type. |
| Financial Periods | The financial years and their periods. |
| ZATCA e-Invoicing / Bahrain Customs | Shown only for Saudi companies / when Liner is active. See the ZATCA and Bahrain Manifest manuals. |
Module-specific preferences sit beside it under Preferences — Cargo Settings, Inventory Settings, Real Estate settings — and Report Templates controls printed layouts (Printed Documents & Reports).
Your licence allows a number of people to be signed in at the same time. A seat is counted per browser: several tabs, or signing in twice in the same browser, use one seat.
When every seat is taken, the next person sees Maximum concurrent users (N) reached. Please try again when a colleague signs out, or use a device that is already signed in.
The badge at the foot of the left menu shows the licence state — Licensed normally; hover over it for the plan, seats, expiry date and modules.
| Banner | What to do |
|---|---|
| Your subscription expires in N days… | Shown from 14 days before; contact Ritzy to renew. You can dismiss it. |
| Your subscription expired on … Access continues until … | A grace period — everything still works; renew before the date shown. |
| …expired, suspended or revoked | Contact Ritzy. Sign-in may be refused until it is resolved. |
| This copy of Ritzy is not licensed… | A trial installation. An administrator clicks Activate beside the message and enters the activation code Ritzy sent. Once the trial has ended only administrators can sign in, to activate it. |
If a module tab is missing, the message on its screen says why: not installed for this company (your administrator can add it) or your subscription does not include this module (contact Ritzy).
A new release normally appears the next time you refresh the page. If it still looks wrong, your browser may be holding the previous version: press Ctrl+F5 (or Ctrl+Shift+R) to reload, then try again. The version number at the foot of the left menu (§4) shows which release you have; administrators can see the releases since then under Tools → Check for Updates, which asks for the support password.
Your group lacks the right for that action. Ask your administrator (§14).
Check the financial year (§5) and any filter on the list.
Transactions are cancelled, not deleted; a master can only be deleted while nothing uses it, cancelled transactions included. The message names where it is used (§6).
Allow pop-ups for the Ritzy address (§10).
Press Ctrl+K and type part of its name (§4). If it is not found, you do not have the right to view it, or your company is not licensed for its module — ask your administrator (§14).
Something went wrong while the screen was being drawn. Click Reload. If it happens again, copy the message shown under it (the copy icon beside it) and send it to your administrator or Ritzy support; the menus keep working, so you can carry on elsewhere meanwhile.
The ? in the top bar opens the manual for where you are. All manuals are listed in the documentation index.