• Sign In
  • info@taxtami.com
  • +263 772 226 466
  • | |
  • Home
  • Domestic Tax Courses
    • TaRMS Essentials44 lessons
    • Income Tax Courses40 lessons
    • Value Added Tax Courses (VAT)24 lessons
    • ZIMRA Debt Management Courses24 lessons
    • Capital Gains Tax (CGT)22 lessons
    • Mining Taxation7 lessons
    • Withholding Taxes2 lessons
    • Tax in Financial Statements5 lessons
    • Tax Audits & Disputes5 lessons
    • Transfer Pricing5 lessons
    • International Tax & DTAs4 lessons
  • Customs Course
    • Foundations of Customs5 lessons
    • Duty Computation & Reliefs5 lessons
    • Modes of Entry: Imports7 lessons
    • Bonded Movement, Exports & SEZs5 lessons
    • Control & Enforcement5 lessons
    • Risk-Based Compliance & Audit4 lessons
    • Special Persons & Goods4 lessons
    • Regional & International Trade5 lessons
    • Disputes & Recourse2 lessons
    • Professional Standards2 lessons
  • Tax Calculators
    • Salary & Employment4 calculators
    • Business, Corporate & Withholding7 calculators
    • VAT & Transaction Taxes3 calculators
    • Capital, Property & Estate5 calculators
    • Compliance, Penalties & Currency5 calculators
    • Filing & Reconciliation Tools3 calculators
    • All calculators
  • About Us
  • Contact
TaRMS Essentials · Lesson 1.5 Password Management The full credential life-cycle of a portal account, creation through lock-out. flow, and the in-session password change.
Lesson overview
1

Context

Password Lifecycle States Active within 90-day window Expiry warning 7 days before Expired forced change at login Locked 5 failed attempts OTP recovery Forgot Password In-person reset station visit Day 83 Day 90 OK email lost 5x Figure 1.5 …

2

Legislative

1. Cyber and Data Protection Act, Section 7 — data-protection by design Imposes the obligation to apply appropriate technical and organisational measures. Strong-password policies and periodic rotation are textbook section-7 measures.…

3

Conceptual

1. Password rules in force Rule Detail Minimum length 8 characters Composition At least one uppercase, one digit, one special character Expiry 90 days; courtesy email reminder 7 days before Reuse window Cannot reuse the previous 5 passwords…

A. Lesson context B. Legislative framework C. Detailed conceptual explanation D. Real-world applicability E. Case law integration F. Common pitfalls G. Practice Questions H. Key takeaways Tables and diagrams References

Executive Summary

The full credential life-cycle of a portal account, creation through lock-out.

This lesson covers the complete credential life-cycle of a ZIMRA Self-Service Portal (SSP) user account: how the password is first created, how it is routinely changed, how it is recovered when forgotten, and what happens when repeated failed attempts lock the account. The SSP at https://mytaxselfservice.zimra.co.zw is the public front-end of the Tax and Revenue Management System (TaRMS), and the password is the single key to everything a user can do in it — filing returns, making payments, requesting tax clearance, and corresponding with ZIMRA. The relevant portal pages all live in the Getting Started module: SSP Registration, Login to the Portal, Password Reset, SSP User Profile, Changing the Password, and User Inactivity and Logout.

Three operations that beginners habitually conflate are kept rigorously distinct throughout this lesson. Password creation happens once, at sign-up: after ZIMRA verifies the registration data, it emails a password-creation link to the registered address, and the user sets the first password by following it. Password change is the routine, authenticated operation — the user is logged in, navigates to Getting Started → Changing the Password, and enters the current password plus the new password twice. Password reset is the unauthenticated recovery operation — the user clicks Forgot Password on the login page, supplies a username or registered email, and receives an emailed reset link. A fourth state, the account lock, is triggered by repeated incorrect login attempts and is cured by waiting the prescribed period or contacting ZIMRA support — not by hammering the reset button.

No section of the Income Tax Act [Chapter 23:06] says the word "password". The legal weight of credential management is indirect but real: Section 5 (preservation of secrecy, with offences in Section 5(5)/(5a)) is the statutory reason every person has their own login; Sections 53–61 (representative taxpayers and the public officer) and Section 37A(10)–(11) (the self-assessment return is the assessment) mean that what is done under a login is attributed — to the user, and through the user to the taxpayer. And because every filing and payment deadline (P2 by the 10th, VAT 7 by the 25th, QPDs under Section 72, the four-month ITF 12C under Section 37A) is enforced regardless of whether the taxpayer could log in, a recovery delay is never an excuse — which is why this lesson treats password hygiene as a compliance control, not an IT nicety.

The recovery machinery has one critical dependency: the email address and phone number on the SSP user profile. The reset link goes to the registered email; browser verification codes go to the registered phone or email. A stale email address converts a thirty-second self-service reset into a support ticket with ZIMRA — potentially straddling a filing deadline. Keeping the profile current (Getting Started → SSP User Profile) is therefore the first rule of recovery, and the lesson closes with a deadline-day failure drill: every taxpayer should have at least two SSP users with submission rights, so that one locked account never strands a return.

Because the SSP's own online help was not reachable when this lesson was prepared, screen-level specifics (lock thresholds, link validity windows, password-complexity rules) are stated generally and flagged for verification against the live portal.

A. Lesson context: the password as a compliance control

Short of walking into an office, every interaction now runs through this login.

Every interaction a Zimbabwean taxpayer has with ZIMRA — short of a physical visit to a regional office — now runs through the Self-Service Portal (SSP), the public-facing front-end of TaRMS. As established in the lesson on Introduction to TaRMS & the Self-Service Portal (tarmsintroduction), the SSP organises its functions into sixteen modules, and as established in SSP Registration (tarmssspregistration), access begins with a user account: one human being, one login, registered once and used for ever after. The password attached to that account is the only thing standing between the outside world and the taxpayer's returns, balances, bank details, refund applications and correspondence with the Commissioner-General's officers.

This lesson is the dedicated treatment of that password's life-cycle. The login lesson (tarmslogin) introduced the three credential events in outline — reset versus change versus lock — and this lesson now walks each one procedurally, screen by screen, and then asks the harder governance questions: who in an organisation should hold SSP credentials, what happens when the one person who knows the password resigns or is on leave on deadline day, and why ZIMRA's legal machinery makes "we were locked out of the portal" a costly rather than a sympathetic explanation.

Two framing points before the detail.

First, the password protects a user, not a taxpayer. Recall the SSP's foundational distinction: an SSP user is a natural person with a login; a taxpayer is the legal person (individual, company, trust, partnership) whose affairs are managed. One user can represent many taxpayers — a tax agent with a portfolio of clients, an in-house accountant handling the employing company and its subsidiaries — by "shifting" into each taxpayer after login. A compromised or lost password therefore exposes every taxpayer that user can shift into, which is exactly why multi-taxpayer practitioners must hold their credentials to a higher standard than a sole trader managing only their own TIN.

Second, password failure is a compliance event, not just an inconvenience. The compliance calendar does not pause for a locked account: PAYE remittances and the P2 are due by the 10th of the following month, the VAT 7 by the 25th following the tax period, quarterly payment dates fall on 25 March, 25 June, 25 September and 20 December under Section 72 of the Income Tax Act [Chapter 23:06], and the self-assessment ITF 12C is due four months after year-end under Section 37A. A password recovery that takes three days at the wrong end of the month can convert directly into late-filing penalties, interest, a blemished compliance record, and — through the ITF 263 machinery covered in tarmscertificates — a revoked or unrenewable tax clearance certificate and the 30% withholding under Section 80. That chain is what makes this topic examinable and practically important far beyond its apparent simplicity.

B. Legislative framework: why credentials carry legal weight

There is no Password Act — so where does the legal weight come from?

There is no "Password Act". No provision of the Income Tax Act [Chapter 23:06], the VAT Act [Chapter 23:12] or the Finance Act [Chapter 23:04] prescribes how an SSP password must be composed, rotated or recovered — those are administrative design choices inside TaRMS. The legal significance of credential management is instead derivative: it flows from provisions that assume, and depend on, each login belonging to exactly one identifiable person.

The secrecy provision — Section 5

Section 5 of the Income Tax Act [Chapter 23:06] is the preservation-of-secrecy provision. As covered in depth in the lesson on Administration of Income Tax (itcadministration), it binds persons handling taxpayer information to confidentiality, with criminal offences in Section 5(5) and Section 5(5a) for unauthorised disclosure, and narrow statutory gateways (the Minister under Section 5(3), the Financial Intelligence Unit under Section 5(3a)). The SSP's one-person-one-login rule is the system-level expression of this scheme: taxpayer information displayed inside an SSP session is confidential information, and the portal can only police who saw it if each set of credentials maps to one human being. A shared password collapses that mapping. The correct mechanism for giving a second person access has never been "tell them the password" — it is a formal grant through the Assignee Management module, which creates an auditable, revocable permission in that person's own name (covered fully in the forthcoming lessons on Roles & Permissions and Assigning an Agent).

Attribution — Sections 53–61 and Section 37A(10)–(11)

The Act's machinery for companies and other entities works through identified natural persons: the representative taxpayer provisions in Sections 53–56 and the public officer requirement in Section 61 fix responsibility for an entity's tax affairs on named individuals. In the TaRMS era those individuals act through SSP logins. Meanwhile Section 37A(10)–(11) provides that a self-assessment return, once submitted, constitutes the assessment — the act of clicking "submit" inside an SSP session creates a legally operative assessment. Authorship therefore matters: ZIMRA's working assumption is that whatever was done under a login was done by the registered holder of that login. "Someone else used my password" is an admission of a control failure, not a defence with any promising track record.

Deadlines that do not wait — Sections 37, 37A, 72; FA Section 4B

The filing and payment provisions — annual returns under Section 37, self-assessment within four months of year-end under Section 37A, quarterly payment dates under Section 72, and the Finance Act's Section 4B remittance discipline for withheld amounts — all run on fixed statutory dates. None of them contains a proviso for portal lock-outs or forgotten passwords. The risk-management consequence is drawn out in section D below.

The registration clock — Sections 25B–25D

As established in tarmssspregistration, a registrable taxpayer must register within 30 days under Section 25B, on pain of the Section 25C civil penalty (US$30 plus US$30 per day, capped at 90 days, with a closure notice as the end-game — inserted by the Finance Act (No. 2) 7/2024 with effect from 1 January 2025), and Section 25D makes liability independent of registration. A stalled password-creation link (wrong email at sign-up, link expired unused) stalls the user account, which stalls the taxpayer registration behind it, while the 30-day clock keeps running.

Data protection law — noted generally

Zimbabwe also has cyber and data protection legislation imposing duties around the security of personal information and criminalising unauthorised access to computer systems; an organisation's handling of SSP credentials sits within that broader framework as well.

What the law does not prescribe

Password length, complexity, expiry, the lock-out threshold and the inactivity timeout are all TaRMS configuration, not statute. They can change without any amendment Act. That is why this lesson states them in the portal's own general terms and flags the unconfirmed numbers, rather than asserting specifics that could silently go stale.

C. Detailed conceptual explanation: the four credential events

Four credential events, because the portal treats them as four.

The credential life-cycle has four distinct events. Learn them as four because the portal treats them as four — different pages, different preconditions, different failure modes.

Event Authenticated? Where Trigger
Creation No (one-time emailed link) Link emailed after Sign Up verification First-ever registration
Change Yes (logged in) Getting Started → Changing the Password Routine hygiene / suspicion
Reset No (Forgot Password) Login page → Forgot Password Forgotten / lost password
Lock N/A (blocked) Imposed by the system Repeated failed attempts

C.1 Password creation — the one-time event

The first password is set as the final step of SSP user registration, covered procedurally in tarmssspregistration. The sequence, restated for completeness:

  1. The applicant completes the Sign Up form at https://mytaxselfservice.zimra.co.zw (resident path with National Registration ID, or non-resident path with passport number), supplying among the mandatory fields a unique username, a phone number and an email address.
  2. ZIMRA verifies the submitted data against its records.
  3. On successful verification, ZIMRA emails a password-creation link to the registered email address.
  4. The applicant follows the link, sets the first password, and can then log in.

Two practical notes carry forward into everything that follows. First, the email address captured at sign-up is the recovery anchor for the life of the account — creation links, reset links and (where email is the chosen channel) browser-verification codes all go there. An error in that field at sign-up is the single most expensive typo in the SSP, and it is not self-service curable: a wrong registered email means contacting ZIMRA support. Second, the creation link is a one-time artefact; if it expires before use, the practical cure is the Forgot Password route once the account exists, or ZIMRA support if it does not.

C.2 Routine password change — the authenticated path

A logged-in user changes their password under Getting Started → Changing the Password. The screen asks for:

  1. the current password, and
  2. the new password, entered twice to guard against typos.

That the current password is demanded is not bureaucratic friction — it is the proof that the person at the keyboard is the account holder and not someone who found an unattended, logged-in session. (Recall from tarmslogin that the SSP's inactivity auto-logout is the backstop for exactly that scenario; the deliberate Log Out click remains the habit to build, particularly on shared devices.)

When to change, as a matter of discipline rather than statute:

  • Periodically — the ZIMRA SSP guidance is to use a strong password and rotate it at least annually.
  • Immediately on suspicion — a phishing email interacted with, a device lost or stolen, a session left open on a shared machine, or any indication another person may know the password.
  • On role changes around the account — for instance, where (improperly) a password had ever been disclosed to a colleague, the cure is an immediate change plus a proper Assignee Management grant for the colleague.

A strong password in this context means the familiar canon: meaningful length, no dictionary words or personal details (note that the SSP registration data — name, date of birth, national ID — is exactly the data an attacker may hold), no reuse of a password used on any other site, and ideally a password manager rather than memory or a sticky note.

C.3 Password reset — the unauthenticated recovery path

When the password is forgotten, the user is by definition outside the portal, so recovery runs unauthenticated from the login page:

  1. Go to https://mytaxselfservice.zimra.co.zw and click Forgot Password.
  2. Enter the username or registered email address.
  3. The SSP emails a password-reset link to the registered email address.
  4. Follow the link, set a new password, and log in with it.

Anatomy of the design: the reset proves identity by control of the registered mailbox. That is the whole security model, and it cuts both ways. It is why the reset is fast and self-service when the profile is current — and why it fails completely when the registered email is a departed employee's corporate address, an abandoned webmail account, or a mailbox whose own password is also forgotten. It is also why reset emails are a favourite phishing costume: the standing rule from tarmslogin applies with full force — be suspicious of unsolicited password-reset emails. A genuine reset link arrives because you clicked Forgot Password moments earlier. An unrequested one is presumptively an attack; do not click it, and change your password through the authenticated path if you have any doubt.

Three procedural wrinkles:

  • Check spam/quarantine first. As with the original creation link, corporate mail filters are the most common reason a reset email "never arrived".
  • The reset link is time-limited. Use it promptly; if it expires, simply run Forgot Password again.
  • A reset does not fix a username problem. If the user cannot remember the username, the registered email also works as the login identifier; reset cures lost passwords only.

C.4 Account lock — the involuntary state

Repeated incorrect login attempts cause the SSP to temporarily lock the account. The cure is to wait the prescribed lock period or contact ZIMRA support — repeated further attempts achieve nothing except, potentially, extending the problem. The tactical rule taught in tarmslogin bears repeating as doctrine: stop after two failed attempts. At that point, pause and think — is the keyboard layout right, is Caps Lock on, is this the correct username, was the password recently changed? — and if genuine doubt remains, go straight to Forgot Password before the lock engages, because a reset against an unlocked account is self-service and immediate, whereas a locked account adds a waiting period (or a support interaction) in front of everything.

Distinguish the lock from the reset conceptually: the reset is the user's voluntary recovery tool; the lock is the system's involuntary defence against credential-guessing attacks. They interact badly when a panicking user burns attempts and then resets — the new password may still have to wait out the lock.

C.5 The recovery anchor — the SSP User Profile

Everything in C.1–C.4 depends on one page: Getting Started → SSP User Profile, where the user maintains their username, phone number and email address. This is the user's profile, not the taxpayer's (taxpayer details live under Taxpayer Information — see the forthcoming tarmsuserprofile and tarmsprofile lessons for the full treatment of each). For password purposes the rule is simple and absolute: the profile must be kept current while you can still log in, because by the time you need recovery, you cannot. Changing jobs, changing mobile numbers, migrating off an old email provider — each of these events should trigger a profile update the same week. The browser-verification codes encountered at login (tarmslogin) ride on the same contact details, so a stale phone number can obstruct even a successful password's login.

C.6 Why there is no "admin gives me the password" route

Users coming from informal office IT cultures often expect a colleague or "the admin" to be able to look up or hand over a password. The SSP deliberately has no such route. Passwords are not retrievable by anyone — recovery always means setting a new one via a link to the registered email. And access for another person always means their own account plus an Assignee Management grant, never disclosure of credentials. This is the Section 5 secrecy architecture and the Sections 53–61 attribution logic (section B) expressed as user experience: the system is built so that the honest answer to "who did this?" is always a single named person.

D. Real-world applicability: individuals, SMEs, large corporates

The occasional filer who logs in twice a year and has forgotten everything.

D.1 The individual taxpayer — Rudo, a Harare employee with a side consultancy

Rudo registered on the SSP in 2025 to file her ITF 1. She logs in perhaps five times a year, which makes her the classic forgotten password case — infrequent users forget. In March she attempts to log in, fails twice, stops (the two-attempt rule), clicks Forgot Password, enters her email, finds the reset link in her inbox within minutes, sets a new password and is filing within a quarter of an hour. Total cost: nothing.

Contrast the counterfactual: Rudo had registered with her then-employer's corporate email, left that job in January, and never updated Getting Started → SSP User Profile. The reset link now goes to a mailbox she cannot open. Her path is ZIMRA support, with identity verification, during the filing season rush. The lesson writes itself: the profile update she skipped in January was the real failure; the forgotten password merely revealed it.

D.2 The SME — Tatenda & Sons (Pvt) Ltd, a Msasa hardware wholesaler

The company's entire SSP capability lives in one bookkeeper, Mr Phiri — sole SSP user with submission rights, registered with his personal Gmail. On 24 June (VAT 7 due the 25th; the June QPD due the 25th under Section 72), Mr Phiri is hospitalised. Nobody else can log in; sharing his password (even if known) would be precisely the control failure Sections 5 and 53–61 frame as culpable. The VAT 7 is filed late; penalty and interest follow; the compliance gap surfaces months later as a blocked ITF 263 renewal, and customers begin withholding 30% on payments above the Section 80 threshold.

The cure is structural, and it is the standing recommendation carried forward from tarmslogin: every taxpayer should have at least two SSP users with submission rights, each with their own login, granted through Assignee Management — for instance the bookkeeper and a director. The cost of the second account is one sign-up and one grant; the benefit is that no single password, illness, resignation or lock-out can strand a statutory deadline. Add the quarterly hygiene rules from the SSP guidance: review the assignee list at least quarterly, remove ex-staff promptly, and ensure every user's profile email is one the company's continuity does not depend on an individual remembering.

A worked illustration of the money at stake. Suppose Tatenda & Sons' June VAT liability is USD 18,400 and the locked-out period delays filing and payment by six days. Even before considering interest and the categorical 100%-band civil penalty exposure for late VAT, the knock-on ITF 263 lapse is the larger figure: if customers paying USD 120,000 of invoices in the gap month apply the Section 80 30% withholding for want of a valid clearance, USD 36,000 of cash flow is locked up as a provisional credit pending the next assessment cycle — a working-capital hole an SME feels immediately. (The mechanics of that example follow the pattern worked in detail in tarmscertificates.)

D.3 The large corporate and the tax agent — many users, many taxpayers

A listed group's shared-services centre might have a dozen SSP users across the group's TINs; a tax agency might have users shifting into fifty client taxpayers. At this scale, password management becomes formal identity governance:

  • Joiners: each new staff member signs up for their own SSP account (corporate email, per tarmssspregistration) and receives Assignee Management grants scoped to the taxpayers and functions they actually need — minimum necessary permissions.
  • Movers: role changes trigger grant adjustments, not credential hand-overs.
  • Leavers: the same day a user exits, their grants are revoked in Assignee Management. Note carefully what is and is not in the group's power: the group can revoke the leaver's access to its taxpayers, but the leaver's SSP user account is the leaver's own — which is exactly why access must ride on grants rather than on a shared "tax department" login whose password walks out the door in the leaver's head.
  • Compromise drills: any suspected phishing success against a user with multi-taxpayer access is treated as an incident across all taxpayers that user can shift into — immediate password change, review of recent submissions and bank-detail changes on each affected taxpayer (the SSP guidance specifically flags verifying bank-account changes under Taxpayer Information before any refund withdrawal is requested).

For agents, there is also a professional-liability angle: an agent submitting under Section 37A creates assessments for clients. The agent's credential hygiene is, functionally, part of the duty of care owed to every client in the portfolio.

E. Case law integration

Candidly, no Zimbabwean decision turns on a reset link or a shared login.

There is, candidly, no Zimbabwean case law on SSP password mechanics — no reported decision turns on a reset link, a lock-out or a shared login, and this lesson will not pretend otherwise. The portal is recent and these are administrative mechanics; disputes that reach the courts arrive framed as penalty, assessment or procedural-fairness questions, not as password questions.

The relevant authorities are therefore the contextual ones already met in this course, which show how the surrounding obligations are enforced regardless of practical difficulty:

  • The secrecy and administration framework of Section 5 and the Commissioner's powers, treated in itcadministration with its accompanying authorities, supplies the doctrinal reason credentials are personal.
  • The objection-and-assessment machinery (Section 51 notices, the 30-day objection window) — see Nestlé Zimbabwe (20-SC-290) and Barclays Bank (04-HH-162) as treated in itcadministration — runs on fixed time limits that a locked-out taxpayer must still meet; the prudent reading is that portal access problems should be documented contemporaneously (support reference numbers, screenshots) if they ever need to be advanced in mitigation.
  • On the clearance side, the principle that statutory clearance requirements bind notwithstanding commercial inconvenience, discussed via Sabeta (12-HH-079) and Sibanda v Masanga (24-SC-090) in tarmscertificates, illustrates the judiciary's general unreceptiveness to "the system made compliance hard" arguments.

No foreign authority is cited here because none is needed: the area is governed by statute and administrative design, not by case-made doctrine.

F. Common pitfalls

Sharing the password "just for month-end" — it breaks the confidentiality architecture.

  1. Sharing the password "just for month-end". The most common and most consequential failure. It breaks the Section 5 confidentiality architecture, destroys attribution under Sections 53–61/37A, and — practically — means the password is now only as safe as the least careful person who knows it. Correct approach: a second SSP account plus an Assignee Management grant takes minutes and is the designed route.

  2. A stale recovery email. Registering with a corporate or throwaway address and never updating the profile after leaving the job/provider. The failure is invisible until the day recovery is needed, at which point it is no longer self-service. Correct approach: treat every job, phone or mailbox change as an immediate Getting Started → SSP User Profile update.

  3. Burning login attempts until the lock engages. Panic-typing five guesses converts a thirty-second reset into a lock-out wait. Correct approach: stop after two failures, diagnose (Caps Lock, keyboard layout, username), then go straight to Forgot Password.

  4. First attempting recovery on deadline day. Filing on the 25th and discovering the password problem on the 25th stacks the recovery time directly onto the statutory deadline. Correct approach: log in early in the cycle (the monthly compliance routine in the forthcoming tarmsroutine lesson builds this in), so any credential problem surfaces with days, not minutes, of slack.

  5. Clicking unsolicited "reset your ZIMRA password" emails. Phishing campaigns mimic ZIMRA; genuine reset links arrive only in response to the user's own Forgot Password request, and genuine ZIMRA correspondence lands in the Notifications module, not in unsolicited emails with attachments or login links. Correct approach: never authenticate via an emailed link you did not just request; navigate to the portal by typing the URL.

  6. Keeping an ex-employee's account alive as "the company login". It is not the company's account; it is the leaver's. Continuing to use it is unauthorised access of another person's credentials and a standing secrecy breach. Correct approach: same-day grant revocation in Assignee Management on exit, and properly-granted accounts for current staff.

  7. Confusing the three "password pages". Trying to change a forgotten password (impossible — change requires the current password), or resetting when merely locked (the reset may still wait out the lock), or expecting the SSP User Profile page to manage taxpayer details. Correct approach: match the event to the page using the table in section C.

  8. No second submission-capable user. The single-point-of-failure design of D.2. Correct approach: minimum two users with submission rights per taxpayer, verified by an actual test login each quarter.

G. Practice Questions — Test Yourself, Every Answer Reveals An Instant Explanation

Interactive multiple-choice questions, graded as you go, with the explanation and source reference revealed on every answer.

Work through the questions one at a time. Choose an answer and it is graded immediately, with an explanation and the provision it comes from. Your progress is saved, so you can stop and resume.

H. Key takeaways

Four events, four pages, four sets of preconditions.

  • Four credential events, four pages: creation (one-time emailed link after Sign Up), change (authenticated, Getting Started → Changing the Password, current password + new twice), reset (unauthenticated, Forgot Password → emailed link), lock (system-imposed; wait or contact ZIMRA support). Match the event to the page.
  • The password protects a user, not a taxpayer — and one user may reach many taxpayers, so multi-taxpayer practitioners carry proportionally heavier credential duties.
  • The legal weight is derivative but real: Section 5 secrecy (offences Section 5(5)/(5a)) explains personal logins; Sections 53–61 and Section 37A(10)–(11) make what happens under a login attributable and legally operative; Sections 37/37A/72 and FA Section 4B deadlines do not pause for lock-outs.
  • The recovery anchor is the SSP User Profile (username, phone, email). Keep it current while you can still log in; every job/number/mailbox change is a same-week profile update.
  • Stop after two failed attempts; diagnose, then reset — a voluntary reset against an unlocked account beats a forced wait against a locked one.
  • Never share a password; never inherit one. Second-person access = own account + Assignee Management grant; leavers' grants are revoked same-day.
  • Two submission-capable users per taxpayer, minimum — the cheapest insurance in the whole compliance calendar, as the Section 80 arithmetic shows (a one-month ITF 263 lapse can lock up 30% of receipts as a provisional credit).
  • Phishing rule: genuine reset links arrive only when you just asked for one; genuine ZIMRA correspondence lands in the Notifications module. Type the URL; never log in via an unsolicited link.
  • Screen-level specifics (lock threshold/duration, link validity, complexity rules, inactivity timeout) are TaRMS configuration, not statute — verify against the live SSP help before relying on a number.

Tables and diagrams

Reset, change and lock-out compared.

Reset vs change vs lock — the practitioner's quick reference

Password change Password reset Account lock
Who initiates User, voluntarily User, voluntarily System, involuntarily
Logged in? Yes — required No — runs from login page N/A — login blocked
Inputs Current password + new password ×2 Username or registered email None (it is a state, not an action)
Channel In-portal page (Getting Started) Link emailed to registered address Wait prescribed period / ZIMRA support
Typical trigger Annual rotation; suspicion; hygiene Forgotten password Repeated failed attempts
Dependency Knowing the current password Current email on SSP User Profile Time, or support verification
Deadline-day risk Low Low if profile current High — plan never to reach it

Recovery dependencies

Recovery artefact Sent to Maintained at Fails when
Password-creation link Registered email Set at Sign Up Email typo at registration (support-only cure)
Password-reset link Registered email Getting Started → SSP User Profile Stale/abandoned mailbox
Browser verification code Registered phone or email Getting Started → SSP User Profile Changed number not updated

Decision tree — "I can't get into the SSP"

flowchart TD
 A[Cannot log in to the SSP] --> B{Failed attempts so far?}
 B -->|2 or more: STOP| C{Diagnose: Caps Lock, layout, right username?}
 B -->|Account already locked| L[Wait prescribed period or contact ZIMRA support]
 C -->|Found the slip| D[Retry carefully once]
 C -->|Password genuinely unknown| E[Forgot Password on login page]
 E --> F{Reset email received?}
 F -->|Yes| G[Follow link, set new password, log in]
 F -->|No| H{Checked spam and quarantine?}
 H -->|Found it| G
 H -->|Still nothing| I{Is the registered email still accessible?}
 I -->|Yes| J[Re-run Forgot Password / wait briefly]
 I -->|No - stale mailbox| K[Contact ZIMRA support: identity verification needed]
 D -->|Works| M[Logged in: update profile and consider password change]
 D -->|Fails| E
 L --> E
 K --> N[After recovery: update SSP User Profile immediately]
 G --> N

References

The secrecy provision and its offences.

Statutes & sections

  • Income Tax Act [Chapter 23:06] — Section 5 (preservation of secrecy; offences Section 5(5)/(5a); gateways Section 5(3)/(3a)): why SSP logins are personal; Sections 25B–25D (30-day registration; Section 25C civil penalty US$30 + US$30/day capped at 90 days with closure notice, as inserted by Finance Act (No. 2) 7/2024 w.e.f. 1 January 2025; liability independent of registration): the clock a stalled creation link runs against; Section 37 / Section 37A (returns; self-assessment within four months; Section 37A(10)–(11) return constitutes the assessment): attribution and deadline stakes; Sections 53–56, 61 (representative taxpayers; public officer): the named-person accountability that rides on logins; Section 72 (quarterly payment dates); Section 80 (30% withholding absent a valid tax clearance — the cash-flow consequence of credential-driven compliance lapses).
  • Finance Act [Chapter 23:04] — Section 4B (remittance discipline for withheld amounts; context for deadline rigidity).
  • Cyber and data protection legislation — referenced generally only.

Case law

  • None on SSP password mechanics — stated honestly. Contextual authorities treated in earlier lessons: Nestlé Zimbabwe (20-SC-290) and Barclays Bank (04-HH-162) on assessment/objection time limits (itcadministration); Sabeta (12-HH-079) and Sibanda v Masanga (24-SC-090) on the bindingness of clearance requirements (tarmscertificates).

ZIMRA guidance

  • Comprehensive Guide to the ZIMRA Self-Service Portal (ZIMRA External Guide) — Getting Started module (§§3.3–3.6: Password Reset; SSP User Profile; Changing the Password; User Inactivity and Logout), §20 Security Housekeeping (own login; strong password rotated at least annually; quarterly assignee review; log out on shared devices; phishing caution; bank-detail verification before withdrawals), §22 sitemap (Getting Started pages).
  • ZIMRA SSP online help, https://mytaxselfservice.zimra.co.zw/help/ssp/en/default.htm — authoritative per-page reference.
  • Zimbabwe Tax Compliance Calendar (ZIMRA) — the deadline rhythm (P2 by the 10th; VAT 7 by the 25th; QPDs 25 Mar/25 Jun/25 Sep/20 Dec; ITF 12C four months after year-end) against which recovery time is measured.

DTAs / international — none cited.

All TaxTami Lessons

Income Tax · VAT · CGT · Debt · TaRMS · Calculators · Customs

Open course menus →
M1 Income Tax
L1Sources of Zimbabwean Tax Law L2Introduction to Taxation in Zimbabwe L3Persons Liable to Income Tax in Zimbabwe L4Tax Residence and Source of Income L5Gross Income Definition and Case Law L6Capital vs Revenue Receipts L7Specific Inclusions in Gross Income L8Fringe Benefits Taxation in Zimbabwe L9Exempt Income under Zimbabwean Tax Law L10Allowable Deductions and General Formula L11Specific Allowable Deductions (Section 15(2)) L12Capital Allowances — Fourth Schedule L13Prohibited Deductions under Section 16 L14Taxation of Mining Operations in Zimbabwe L15Taxation of Farmers in Zimbabwe L16Taxation of Employment Income and PAYE L17Taxation of Individuals in Zimbabwe L18Taxation of Partnerships in Zimbabwe L19Taxation of Trusts and Deceased Estates L20Corporate Income Tax in Zimbabwe L21Calculation of Income Tax and Tax Credits L22Withholding Taxes — Residents and Non-Residents L23Double Taxation Agreements and Relief L24Transfer Pricing and Anti-Avoidance L25Returns and Record-Keeping Compliance L26Provisional Tax, QPDs and PAYE Administration L27Tax Administration, Returns and Appeals L28Representative Taxpayers L29Other Income-Based Levies (IMTT, Carbon Tax, etc.) L30Objections and Appeals under Income Tax L31Tax Recovery and Collection Procedures L32Digital Tax Administration Systems (ZIMRA TaRMS)L33Presumptive TaxL34Estate DutyL35Stamp DutyL36Wealth TaxL37Betting and Gaming TaxL38Digital Services TaxL39Domestic Minimum Top-Up TaxL40Tax Incentives and SEZs
M2 Value Added Tax
L1Zimbabwe VAT Foundations and Conceptual Fram… L2Interpretation and Key VAT Definitions L3Imposition and Scope of VAT L4VAT Rates and Types of Supplies L5Time of Supply Rules L6Value of Supply and Valuation Rules L7VAT on Imports and Exports L8Special VAT Charges and Statutory Levies L9VAT Registration Requirements (ZIMRA) L10VAT Accounting Basis (Invoice vs Cash) L11Input Tax Deep Dive (Capital Goods & Pre-Reg) L12VAT Adjustments and Change-in-Use L13Documentation and Record-Keeping L14Returns, Payments, Interest and Penalties L15VAT Refunds and Exporter Refunds L16Assessments and Self-Assessment System L17VAT Objections and Appeals L18Compliance, Audits and Enforcement L19Digital VAT, Fiscalisation and Technology L20Representative Persons and Withholding Agents L21Special VAT Rules and Industry Provisions L22VAT Anti-Avoidance Rules and ZIMRA Powers L23Practical VAT Application for Businesses L24VAT Exam Prep and Practitioner Toolkit
M3 Capital Gains Tax
L1Capital Gains Tax in Zimbabwe: Introduction, Purpose and Legal… L2Legal Framework of Capital Gains Tax in Zimbabwe L3Specified Assets Under Zimbabwe Capital Gains Tax Law L4Disposal of Assets and Taxable Events L5How to Determine Capital Gains L6Allowable Deductions When Calculating CGT L7How to Calculate Capital Gains Tax (Step-by-Step) L8Capital Gains Tax Exemptions L9Special CGT Rules for Business and Asset Transfers L10Capital Gains Withholding Tax L11Role of Intermediaries and Depositaries L12CGT Returns and Assessments L13Payment of CGT and Clearance Certificates L14How to Object and Appeal a CGT Assessment L15Enforcement and Recovery of CGT by ZIMRA L16CGT Treatment of Corporate Restructuring L17CGT on Property Sales L18CGT on Shares and Securities L19CGT on Cross-Border Asset Transfers L20CGT Compliance, Planning and Audit Risks L21Zimbabwe CGT Case Law and Judicial Interpretation L22Administration of CGT by ZIMRA L23Practical CGT Applications L21Deemed Sales L22Non-Permissible Deductions L23Suspensive Sales
M4 Debt Management
L1Foundations of Tax Debt Management L2Creation of Tax Debt L3Tax Assessments and Debt Collection L4Tax Debt Identification and Classification L5Taxpayer Account Management L6Interest and Penalties on Tax Debt L7Payment of Tax Liabilities L8Tax Clearance Certificates and Debt Status L9Debt Collection Strategies L10Payment Plans and Instalment Arrangements L11Tax Debt Enforcement Powers L12Garnishee Orders and Third-Party Collection L13Attachment and Sale of Property L14Civil Recovery Through Courts L15Tax Debt in Insolvency L16Tax Debt and Business Closure L17Tax Disputes and Debt Collection L18Write-Offs and Remission of Tax Debt L19Taxpayer Engagement and Compliance L20Technology in Tax Debt Management L21Special Tax Debt Situations L22Ethics and Professional Conduct L23Practical Debt Management Case Studies L24Debt Management Practitioner Toolkit L25Calculation of Interest on Tax Debt
M5 TaRMS Essentials
M1 Getting Started in TaRMS
L1.1Introduction to TaRMS and the SSP L1.2Logging In, Dashboard, and Switching TINs L1.3Downloading TIN and VAT Certificates L1.4SSP Self-Registration L1.5Password Management L1.6User Profile & Sessions
M2 Taxpayer Profile & Lifecycle
L2.1Anatomy of the Taxpayer Profile L2.2Adding a New Tax Type: VAT Application L2.3Tax Type Deregistration / Status Change L2.4TIN Deregistration L2.5First-Time Taxpayer Registration
M3 Tax Agents & Assignees
L3.1Tax Agent Registration L3.2Tax Agent Licence Management L3.3Assigning and Removing Tax Agents L3.4Roles and Assignees
M4 Tax Return Management
L4.1Return Submission Fundamentals L4.2PAYE Return Submission L4.3Amending Current-Period Returns L4.4Filing Past Returns and Back-Filing L4.5E-Agreement Filings L4.6Old Period Documents
M5 Tax Clearance (ITF 263)
L5.1Automatic Tax Clearance Generation L5.2Manual Tax Clearance Application
M6 Payments & Single Account
L6.1The Single Account Concept L6.2Changing the Single Account Bank L6.3Searching Single Account Transactions L6.4Balance Lookup L6.5New Payment Workflow L6.6E-Banking & Payment History L6.7Withdrawal & History
M7 Taxpayer Accounting
L7.1The Summary Report L7.2The Tax Type Report L7.3Assessment Notices and Reconciliation L7.4Audit Assessment Notices
M8 Capstone Workflows
L8.1End-to-End VAT Compliance Workflow L8.2End-to-End PAYE Compliance Workflow L8.3Common Pitfalls and ZIMRA Audit Triggers L8.4Your Monthly and Quarterly TaRMS Routine
M9 Specialised SSP Modules
L9.1Employee Management L9.2Refund Management L9.3Invoice Management & Diplomatic / DP Invoices L9.4Audit Management — Voluntary Disclosure (VDA01) L9.5Case Management — Objections, Appeals, Schemes L9.6E-Messaging with ZIMRA Officers
M6 Zimbabwe Tax Calculators
C1Bonus / 13th Cheque Tax C2CGT Suspensive Sale C3Capital Gains Tax C4Corporate Tax & QPD C5General Customs Duty C6Non-Resident Shareholders Tax C7Resident Dividend Tax C8Estate Duty C9Excise & Surtax C10Fringe Benefit Tax C11USD ↔ ZiG Conversion C12IMTT (2%) C13ITF1 Annual Reconciliation C14Mining Royalties C15Non-Resident Fees & Royalties C16Objection Deadline C17PAYE → ITF 16 Reconciliation C18PAYE & Net Salary C19Penalty & Interest C20Presumptive Tax C21Refund / Credit Position C22Stamp Duty / Property Transfer C23TaRMS Return Due-Date C24TCC Eligibility Checker C25VAT Apportionment C26VAT (15.5%) C27VAT 7 Pre-Submission C28Vehicle Import Duty C29WHT on Tenders C30WHT on Contracts
M7 Customs
M1 Foundations of Customs
L1.1Tariff Classification L1.2Customs Valuation L1.3Origin & Preference L1.4Customs Registration & Licensing L1.5Documentation & Bills of Entry
M2 Duty Computation & Reliefs
L2.1Calculation of Duty, Surtax & VAT L2.2Rebates & Suspensions L2.3Export Drawback of Duty L2.4Refunds, Remissions & Bonds L2.5Deferred Clearances
M3 Modes of Entry: Imports
L3.1Motor Traffic & Vehicle Imports L3.2Imports by Rail L3.3Imports by Air L3.4Imports by Post L3.5Form 49 & PCW L3.6ASYCUDA World Declarations L3.7E-commerce & Online Shopping
M4 Bonded Movement, Exports & SEZs
L4.1Bonded Warehouses & Deferred Clearances L4.2Containerisation L4.3Exportation of Goods L4.4Free Trade Zones & SEZs L4.5Temporary Imports & ATA Carnets
M5 Control & Enforcement
L5.1Customs Controls Framework L5.2Searches — Your Rights & Obligations L5.3Customs Offences & Penalties L5.4Customs Appeals Process
M6 Risk-Based Compliance & Audit
L6.1Risk Management & AEO L6.2Preparing for a Post-Clearance Audit L6.3Minerals Identification L6.4Audit Techniques
M7 Special Persons & Goods
L7.1Returning Residents Rebate L7.2Diplomatic & NGO Privileged Imports L7.3Strategic Goods & Permits L7.4Prohibited & Restricted Goods
M8 Regional & International Trade
L8.1SADC, COMESA & AfCFTA L8.2WTO TFA & Revised Kyoto Convention L8.3Green Customs — CITES & MEAs L8.4Multilateral Environmental Agreements L8.5Border Control & IBM
M9 Disputes & Recourse
L9.1Fiscal Appeal Court L9.2Judicial Review in the High Court
M10 Professional Standards
L10.1Integrity & Ethics in Customs L10.2Customs Report Writing
M8 Transfer Pricing
L1TP Foundations & the Arm's Length Principle L2The Five Approved TP Methods L3TP Documentation, Disclosure Return & Penalties L4Intangibles & Intra-group ServicesL5Advance Pricing Agreements & TP Dispute Resolution
M9 International Tax & DTAs
L1Residence, Source & Permanent Establishment L2Double Tax Agreements & Treaty ReliefL3Foreign Tax Credits & Double Taxation ReliefL4Treaty Anti-Avoidance — Treaty Shopping, PPT, LOB & the MLI
M10 Withholding Taxes
L1Resident Withholding Taxes L2Non-resident Withholding Taxes + treaty rates
M11 Tax in Financial Statements
L1Current Tax — From Accounting Profit to Tax Payable L2Deferred Tax — Temporary Differences & the Balance-Sheet Method L3Deferred Tax — Losses, Recognition & Measurement L4The Effective Tax Rate Reconciliation & DisclosuresL5IFRIC 23 — Accounting for Uncertain Tax Positions
M12 Mining Taxation
L1The Zimbabwe Mining Fiscal Regime — Overview L2Mining Royalties by Mineral L3Capital Redemption Allowances & Unredeemed Capital L4Special Mining Lease & Additional Profits TaxL5Mineral Marketing, Export Levies & the Fiscal Collection PointL6Taxing Artisanal & Small-Scale MiningL7Mining VAT & Customs
M13 Tax Audits & Disputes
L1ZIMRA Audits & Investigations — Selection, Triggers & Powers L2Assessments — Original, Additional & Estimated L3The Objection Process L4Appeals — Special Court & Fiscal Appeal CourtL5Voluntary Disclosure, Amnesty & ADR
TaxTami

Zimbabwe's leading tax education platform, making Zimbabwean tax law simple for students, professionals and business owners.

Courses

  • Income Tax
  • Value Added Tax
  • Capital Gains Tax
  • Debt Management
  • TaRMS Essentials
  • Customs
  • Zimbabwe Tax Calculators

Library

  • All Lessons
  • Legislation Bank

Account

  • Sign In
  • Dashboard
  • Profile
  • Certificate

Company

  • About
  • Contact
  • AI Use Policy

© TaxTami. All rights reserved.

  • AI Use Policy