← All guides

Want this as a document?

Download the Administrator Guide to print or share.

Download .docx

Simple Asset Tracker

Administrator Guide

Setting up and running your asset register

Version 1.2.5 · 09 October 2026

About this guide

This guide is for the person who administers Simple Asset Tracker: the holder of the built-in master administrator account. It walks through every section of the application and every setting you can configure.

Screenshots are marked with numbered red badges. Each badge corresponds to a numbered step in the text directly beneath it, so one picture usually covers several steps.

Who can do what

Simple Asset Tracker has five roles. The master administrator — the account named simpleadmin — is an Administrator with a few extra powers that no other account has, noted throughout this guide.

RoleWhat it is for
AdministratorFull run of the application: assets, users, events, imports, settings.
Physical VerifierWalks the floor during a verification event and records what they find.
Asset Tag OwnerPrints asset labels and confirms they have been stuck on.
Issue TrackerIssues assets to people and records their return.
ViewerRead-only access to the dashboard and events.
Note  The three field roles — Physical Verifier, Asset Tag Owner and Issue Tracker — are covered in the companion User Guide. Hand that document to your staff.

Signing in for the first time

The sign-in screen
Figure 1 — The sign-in screen
  1. 1.Type the username. The built-in administrator account is simpleadmin.
  2. 2.Type the password. On a new installation this is simpleadmin@123.
  3. 3.Click Sign In.
Important  Change this password immediately. Go to Users, find simpleadmin, and click Reset. The default password is printed in the installation guide, so anyone who can reach the application can try it.

If you forget the master password

There is a recovery screen at /reset-master-password. It asks for your licence key as proof of identity and then lets you set a new master password. Attempts are rate limited, so if you mistype the key several times you will be asked to wait before trying again.

Finding your way around

The ten sections available to the master administrator
Figure 2 — The ten sections available to the master administrator

The sidebar is the main way you move around the application.

#SectionWhat you do there
1DashboardOverview of the register: totals, value, verification and label progress.
2AssetsThe register itself — search, filter, edit, print labels, export.
3Issue TrackerIssue assets to people and record their return.
4Import CSVBring assets in from a spreadsheet.
5IntegrationsConnect SAP, Oracle Fusion or Zoho Books. Master administrator only.
6UsersCreate accounts and assign roles.
7EventsPlan and run physical verification rounds.
8Audit TrailEvery change made in the system. Master administrator only.
9Login TrailWho signed in, when, and from where.
10SettingsLicence, branding, backups, network and remote access.

Your account name and role are shown at the bottom of the sidebar, with Sign out beneath. The bar across the top carries the page title and a currency selector.

Dashboard

The dashboard at a glance
Figure 3 — The dashboard at a glance
  1. 1.The verification event strip shows the event currently running and how far through it is.
  2. 2.Filters narrow everything below them — set a category or location and the totals follow.
  3. 3.Summary tiles show the number of assets, their combined purchase value, and how many are nearing end of life.
  4. 4.Customise chooses which panels appear and in what order.
  5. 5.Refresh re-reads the figures from the server.

Choosing what appears

Choosing which widgets appear
Figure 4 — Choosing which widgets appear

Turn panels on or off, then drag them into the order you want. The layout is remembered for your account, so each administrator can have their own arrangement.

Assets

This is the register itself, and where you will spend most of your time.

The asset register
Figure 5 — The asset register
  1. 1.Search by asset name.
  2. 2.More filters opens the rest of the filter set — department, vendor, cost centre, company code, ERP ID, serial and tag numbers, label status and source.
  3. 3.Columns chooses which columns are shown; Reset Columns puts them back.
  4. 4.Export CSV downloads the whole register as a CSV with the same column headings as the import template, so it can be edited in a spreadsheet and imported back. Download Report produces a formatted Excel workbook of the full register, adding verification results and label print counts.
  5. 5.Each row is one asset. Scroll right for the Actions column, which holds Edit.

Working on several assets at once

Bulk actions appear once rows are ticked
Figure 6 — Bulk actions appear once rows are ticked
  1. 1.Tick the assets you want. The tick box in the header selects the whole page.
  2. 2.Print Labels opens a print window containing a label for every selected asset.
  3. 3.Assign Asset Tag Owner hands the selected assets to a member of staff for labelling.
  4. 4.Delete Selected removes them. This cannot be undone.
  5. 5.Clear drops the selection.
Important  Deletion is permanent and removes the asset's verification and custody history with it. Take a backup first if you are clearing out a large batch.

Label size and layout

Label and paper sizing
Figure 7 — Label and paper sizing

Label Settings controls the printed label: paper size and margins, label width and height, the gap between labels, and whether faint cut lines are drawn. The preview updates as you change the numbers. Set this up once, before you print your first sheet.

Each label shows the QR code, the asset name, its category, the tag number and the ERP ID. Location is not printed, because assets move and the label would then disagree with the register. Under Printed on labels you can add your company name to the top of every label; it applies to everyone who prints labels.

Editing an asset

Editing an asset record
Figure 8 — Editing an asset record

Click Edit on any row. The form is divided into four sections:

  1. 1.Core Identification — name, category, status, serial and tag numbers, ERP ID and company code.
  2. 2.Financial — purchase value, net book value, salvage value, accumulated depreciation, and the currency those amounts are recorded in (a three-letter code such as INR or USD).
  3. 3.Depreciation — method, annual rate and useful life.
  4. 4.Organisational — location, department, cost centre, assigned staff and vendor.
Note  Tag numbers must be unique. If you enter one that is already in use, the save is refused and the asset holding it is named in the message.

Status is one of Active, Inactive, Under Maintenance, Disposed, Sold Off or Written Off. When an import or an ERP sync brings in one of the last three, an alert is raised in the Issue Tracker so any staff member still holding the asset can be followed up. When an asset has its own currency, its detail page shows amounts in that currency instead of the currency chosen in the top bar.

Importing assets from a spreadsheet

Importing assets from a spreadsheet
Figure 9 — Importing assets from a spreadsheet
  1. 1.Download Template gives you a CSV with every importable column and one example row. Start here if you are building the file from scratch.
  2. 2.Drag your CSV onto the panel, or click it to browse. CSV only, up to 10 MB.

The template's columns are: Company Code, Asset Name, Category, Status, ERP ID, Serial Number, Tag Number, Purchase Value, Net Book Value, Salvage Value, Accumulated Depreciation, Currency, Depreciation Method, Depreciation Rate (%), Useful Life (Years), Purchase Date, Location, Department, Cost Centre, Assigned To, Assigned Verifier, Vendor and Quantity.

Columns are matched to asset fields automatically
Figure 10 — Columns are matched to asset fields automatically
  1. 1.Your column headings do not have to match ours. Each heading is matched to the closest asset field, with a confidence score. Correct anything guessed wrongly, or choose Skip this column.
  2. 2.Where is this file from? Leave this as Manual / spreadsheet unless the file is an extract from SAP, Oracle Fusion or Zoho Books. In that case, choose the ERP so the assets are recorded under it (see below).
  3. 3.Confirm & Import. A summary then shows how many assets were created and updated, any rows that could not be imported, and any values that were skipped.

Re-importing and updating

Importing a file again updates the assets it already created instead of duplicating them. Each row is matched to an existing asset by ERP ID first, then serial number, then tag number, and finally by name for assets that have none of these. A matched asset keeps its QR code, label status and print counts.

Importing an ERP extract

You can import a register exported straight from SAP, Oracle Fusion or Zoho Books. Their own column headings are recognised — for example SAP's Asset, Capitalized on, Acquis.val., Accum.dep., Book val. and Inventory number; Oracle's Asset Number, Date Placed in Service, Cost, Depreciation Reserve and Life in Months; and Zoho's Asset Cost, Current Asset Value, Fixed Asset Type and Serial No. ERP columns with no matching asset field, such as SAP's Subnumber or Oracle's Units, are left unmapped.

Source chosenERP ID format a later live sync will recognise
SAP S/4HANACompanyCode-Asset-Subnumber, e.g. 1010-10001234-0
Oracle FusionBOOK:AssetNumber, e.g. US CORP:100245
Zoho BooksZoho's internal fixed asset ID (not the FA-00001 asset number)
Tip  If you will also connect the same ERP under Integrations, either use these ERP ID formats in the file or rely on the live sync alone. Otherwise the sync cannot tell that an imported asset is the same one and will add it again. Import a handful of rows first and check the result before loading the whole register.

Issue Tracker

The Issue Tracker as an administrator sees it
Figure 11 — The Issue Tracker as an administrator sees it

The Issue Tracker records who is physically holding an asset. Administrators see the same screen as the Issue Tracker role, plus the settings that control it.

  1. 1.All — every asset enrolled in the tracker.
  2. 2.Issued — assets currently out with someone.
  3. 3.Available — enrolled and on the shelf.
  4. 4.Disposal Alerts — assets an ERP sync or CSV import has marked as disposed, sold off or written off while somebody still holds them.

As an administrator you also control which details are compulsory when an asset is issued — employee ID, employee email, serial number — through the tracker's settings. The day-to-day issuing and recovery workflow is described in the User Guide.

Users

Managing user accounts
Figure 12 — Managing user accounts
  1. 1.Add User creates a single account.
  2. 2.Bulk Upload creates many at once from a CSV of email, password and role.
  3. 3.Each row shows the account, its role, and the actions available on it.
Creating an account and choosing its role
Figure 13 — Creating an account and choosing its role

Give the person an email address, a starting password, and the role they need.

Note  Passwords are stored one-way and cannot be read back — not by you, not by anyone. The password column shows dots and a Reset button. If someone forgets their password you set a new one and tell them; there is no way to look up the old one.

Rules that protect the master account

Verification events

An event is one round of physical checking — a quarterly count, an audit, a move. You create the event, decide who checks what, and watch the results arrive.

Verification events
Figure 14 — Verification events

Each event is either Open or Closed. Verifiers only see assets from an Open event, so an event that is still being prepared will not appear on anyone's phone until you open it.

Inside an event: assignments and progress
Figure 15 — Inside an event: assignments and progress

Inside an event you can:

Tip  Assign every asset before you open the event. A verifier sees nothing until assets are assigned to them by name.

Integrations

Note  This section is visible to the master administrator only.
Connecting an ERP system
Figure 16 — Connecting an ERP system

Simple Asset Tracker can pull asset records from SAP S/4HANA, Oracle Fusion and Zoho Books. Each provider card shows whether it is configured, how many assets came from it, and when it last synchronised.

  1. 1.Open the provider you want and enter its credentials.
  2. 2.Use Test Connection to confirm the details before relying on them.
  3. 3.Run a sync. Imported assets are tagged with that provider as their source.

A sync is safe to repeat: assets it has brought in before are updated, never duplicated. Values the ERP supplies are refreshed on every sync, because the ERP is the system of record. Fields the ERP does not supply, such as Location for a Zoho asset, are left as you set them. Each asset's company code and currency are filled in from the ERP.

SystemWhat a sync fills in
SAP S/4HANAName, asset class (as category), status, serial and inventory (tag) numbers, company code, currency, salvage value, depreciation key and useful life, capitalisation date, location or plant, cost centre, department and vendor.
Oracle FusionEverything your extract report provides: cost, net book value, accumulated depreciation, salvage value, method, rate, life, date placed in service, location, department, cost centre, assignee, vendor, serial and tag numbers, retirement status and the book's currency.
Zoho BooksName, fixed asset type (as category), status, serial number, cost, current value, accumulated depreciation, salvage value, method, rate, useful life, purchase date and the organisation's currency. Zoho has no location, department or vendor fields on fixed assets.
Important  Credentials are encrypted using your installation's JWT_SECRET. If you move the application to a new machine with a different secret, the stored credentials will not decrypt and must be entered again.

What has to be set up in the ERP first

Pasting credentials into the Integrations page is only half the job. The other half happens inside the ERP itself, and usually needs your ERP administrator or finance systems team rather than you. Take this section to them before you start.

Note  Simple Asset Tracker only ever reads. It never writes back, so the account you are given needs read access alone — ask for nothing more than that.

Per system

SystemSign-in methodWhat must exist in the ERP before you can connect
SAP S/4HANAOAuth2, Basic, or API Key — see belowThe OData V4 service API_FIXEDASSET activated and exposed via a Communication Arrangement, and a user or OAuth client with read authorisation on Fixed Asset master data and the depreciation-area valuation entities. The company code and depreciation area whose values you want.
Oracle FusionUsername and password, plus an Asset BookA BI Publisher report (.xdo) your Oracle admin builds and publishes, since Oracle Fusion has no plain REST list endpoint for fixed assets. A service account holding the Financials Assets REST and BI Publisher report-execution duty roles.
Zoho BooksOAuth 2.0The Fixed Assets module enabled in Zoho Books. A Server-based Application registered at the Zoho API Console for your data centre, and a refresh token generated from it with the scopes ZohoBooks.fixedasset.READ and ZohoBooks.settings.READ (requested with access_type=offline).

SAP: choosing an authentication mode

SAP is the one provider with a choice to make. Pick the mode that matches how your tenant is set up — the fields on the Integrations page change depending on which you select.

ModeWhen to use itFields it asks for
OAuth2 Client CredentialsRecommended. Required for S/4HANA Cloud production tenants.OAuth Client ID, OAuth Client Secret, OAuth Token URL
Basic (username & password)On-premise systems only.Username, Password
API KeySAP Business Accelerator Hub sandbox only — will not authenticate against a real production tenant.API Key
Note  Your Basis team activates API_FIXEDASSET through Communication Arrangement SAP_COM_0A93 for OAuth2, or the older SAP_COM_0563 scenario if Basic or API-key auth is the only option on an on-premise system.
Important  Acquisition cost, net book value and accumulated depreciation are not exposed by API_FIXEDASSET at all, so a plain SAP sync leaves them blank. Either have your Basis/FI-AA team expose them through a custom CDS view, or export the asset register from SAP (report AR01 or S_ALR_87011990) and bring the values in with Import CSV — see Importing an ERP extract.

Zoho: the scopes matter

Important  Test Connection for Zoho only proves that the refresh token works. A token generated without ZohoBooks.fixedasset.READ passes the test and then fails on every sync. A token without ZohoBooks.settings.READ syncs, but leaves the currency blank. If either happens, generate a new refresh token with both scopes.

Where each value comes from

The left column is the box on the Integrations page; the right is where your ERP team finds it.

SystemField in the appWhere it comes from
SAPBase URLRoot URL of your S/4HANA Gateway/BTP tenant, e.g. https://my123456.s4hana.ondemand.com — no trailing slash.
SAPCompany CodeThe company code to pull, e.g. 1000. Defaults to 1000 if left blank — confirm with your SAP FI team if unsure.
SAPDepreciation AreaWhich depreciation area's values to read. Default '01' is the standard book/local-GAAP area on most tenants — confirm with your FI-AA team if your chart of depreciation differs.
SAP (OAuth2 mode)OAuth Client ID / Secret / Token URLIssued when your Basis team creates the OAuth client under Communication Arrangement SAP_COM_0A93. The Token URL is that arrangement's token endpoint.
SAP (Basic mode)Username / PasswordThe read-only SAP dialog user created for this purpose. On-premise systems only.
SAP (API Key mode)API KeyFrom the SAP API Business Accelerator Hub sandbox (sandbox.api.sap.com) — not valid against a real production tenant.
OracleInstance URLRoot URL of the Oracle Cloud instance, no trailing slash.
OracleUsername / PasswordA service account with fixed-assets read access (see prerequisites above).
OracleAsset BookRequired — Oracle assets are book-scoped, so cost, NBV and depreciation all differ per book. Find valid values under Setup and Maintenance → Manage Asset Books.
OracleBI Publisher Report PathCatalog path to the asset extract report your Oracle admin publishes. Optional — falls back to a default path if left blank.
OracleReport Output Formatcsv or xml — must match the report's configured output layout. Default: csv.
OracleReport Book Parameter NameThe parameter name your report uses for book scoping. Default: P_BOOK_TYPE_CODE.
OracleExtra Report ParametersOptional additional parameters your report requires, semicolon-separated as NAME=VALUE.
ZohoClient IDZoho API Console, from the registered application
ZohoClient SecretZoho API Console, alongside the Client ID
ZohoRefresh TokenProduced by the one-time OAuth authorisation flow, with scopes ZohoBooks.fixedasset.READ and ZohoBooks.settings.READ
ZohoOrganization IDZoho Books, under Settings → Organization Profile — a numeric ID. It is also recorded as the company code of every Zoho asset.
ZohoAccounts URLYour data centre: .com, .eu, .in, .com.au, .jp or .ca

Network access

Syncs are made outbound from the machine running Simple Asset Tracker. If that server sits behind a firewall or proxy, these destinations need to be reachable over HTTPS on port 443.

SystemDestination
SAPYour own S/4HANA host (the Base URL above), plus — in OAuth2 mode — the OAuth Token URL host issued with your Communication Arrangement.
OracleYour own Oracle Cloud instance (the Instance URL above)
Zohoaccounts.zoho.com and www.zohoapis.com, or your data centre's equivalents (e.g. accounts.zoho.in and www.zohoapis.in)
Note  If your ERP restricts access by source address, the firewall team will also need the public IP that this server presents when it makes outbound calls.

Keeping the connection alive

Tip  Use Test Connection after any change at the ERP end. It is the quickest way to tell a credential problem from a network one.

Audit Trail and Login Trail

Two separate records answer two different questions: what was changed, and who came in. Between them they cover most of what an auditor will ask for.

Audit Trail

Note  This section is visible to the master administrator only.
The system audit trail
Figure 17 — The system audit trail

Every change is recorded here: what was changed, by whom, when, and the old and new values. Filter by action, entity or date range, and export the result to Excel or CSV when an auditor asks for it.

Login Trail

Who signed in, when, and from where
Figure 18 — Who signed in, when, and from where

Every successful sign-in is recorded with the time, the account, the IP address and the kind of device. Where the browser has been allowed to share it, the location is recorded too and linked through to a map. The list exports to Excel.

Settings

Every settings section on one page
Figure 19 — Every settings section on one page

Settings is a stack of cards. Click a card's title to open it.

  1. 1.License — your licence key and the plan it grants.
  2. 2.Branding & Appearance — your organisation's logo and the application's colour.
  3. 3.Inactivity Timeout — how long before idle users are signed out.
  4. 4.Backup & Restore — manual backups, a schedule, and cloud storage.
  5. 5.Live QR Scanning — whether the live camera viewfinder is available.
  6. 6.Network Access — the links to give your field staff.

Two further cards — Network & Ports, and Remote Access — appear for the master administrator only, below the ones listed above.

License

The licence key and current plan
Figure 20 — The licence key and current plan

Without a licence the application runs in demo mode, limited to 30 assets. Paste your key here and activate it to lift that limit. The card shows the plan, the asset allowance, how many assets you are using, and when the key was last checked.

Note  A key is tied to one installation. Activating it on a second machine will be refused.

Branding & Appearance

Organisation logo and colour theme
Figure 21 — Organisation logo and colour theme
Note  Master administrator only.

Upload your organisation's logo — PNG, JPG or WebP, up to 5 MB. The background is removed and the image trimmed automatically, so a logo on a white background works well. The logo replaces the product mark in the sidebar and appears on printed output.

Beneath it, the colour theme sets the accent colour used across the application.

Inactivity Timeout

Signs users out automatically after a period without activity. Set it to 0 to disable it. This is worth turning on if the application is used on shared machines.

Backup & Restore

Manual backup, scheduling and cloud storage
Figure 22 — Manual backup, scheduling and cloud storage

The card has three tabs.

Important  A restore is destructive: it clears the existing data before loading the file. Take a fresh backup before restoring an old one.
Note  Backups contain user accounts with their password hashes, and encrypted integration credentials. Store them somewhere access-controlled.

Live QR Scanning

Scanning a QR label with the camera requires a secure connection. When the application is reached over HTTPS, or over localhost, the live viewfinder is available and this card says so. Over plain HTTP on another machine the browser will not release the camera, and staff fall back to taking a photo instead. The card explains how to install the certificate that fixes this.

Network Access

The URLs to share with field users
Figure 23 — The URLs to share with field users

Lists the addresses this installation answers on. Share the appropriate one with your staff; everyone uses the same URL regardless of role, and the application sends each person to the right screen when they sign in.

Network & Ports

Ports and bind address
Figure 24 — Ports and bind address
Note  Master administrator only.

Changes the ports the application listens on and the address it binds to. Ports must be between 1024 and 65535 and must not clash with each other. Saving restarts both parts of the application, so everyone is signed out briefly.

Important  Change this only if a port conflicts with other software on the server. If you set an address the machine does not have, the application may not come back up without editing the configuration file by hand.

Remote Access

Reaching the app from outside the office
Figure 25 — Reaching the app from outside the office
Note  Master administrator only.

Two ways to reach the application from outside your network: over your company VPN, or through a Cloudflare tunnel that the application can start for you. The card walks you through whichever you pick and shows the tunnel's status once it is running.

Important  A tunnel puts your sign-in page on the public internet. Before starting one, change the default master password, and consider turning on the inactivity timeout.

Appendix A — What each role can reach

SectionAdminMaster adminVerifierTag OwnerIssue TrackerViewer
DashboardYesYes———Yes
AssetsYesYes——Yes—
Issue Tracker—Yes——Yes—
Import CSVYesYes————
Integrations—Yes————
UsersYesYes————
EventsYesYes———Yes
Audit Trail—Yes————
Login TrailYesYes————
SettingsYesYes————
VerificationYesYesYes———
My AssetsYesYes—Yes——

Administrators see everything except the master-administrator-only sections: Integrations, Audit Trail, Branding, Network & Ports and Remote Access.

Appendix B — If something goes wrong

SymptomWhat to check
A verifier says they have nothing to checkThe event must be Open, and assets must be assigned to that person by name.
An asset tag owner sees an empty listAssets appear only when their Assigned To field holds that person's email address.
The camera will not startScanning needs a secure connection. See Live QR Scanning in Settings.
Sign-in is refused after several triesSign-in is rate limited after repeated failures. Wait a few minutes and try again.
The demo banner will not go awayThe licence key has not been activated, or could not be validated. Check the License card in Settings.
An import was refusedCheck the file is CSV, under 10 MB, and that Asset Name is mapped.
Imported dates are blankThe summary lists each date it could not read. Rewrite those as YYYY-MM-DD and import the file again — the assets are updated, not duplicated.
An ERP sync duplicated assets that were imported by CSVThe imported ERP IDs did not use the format the sync uses. See Importing an ERP extract.
Zoho Test Connection passes but Sync failsThe refresh token lacks the ZohoBooks.fixedasset.READ scope. Generate a new one with both scopes.
A tag number will not saveTag numbers are unique. The message names the asset already using it.