• Sign In
  • info@taxtami.com
  • +263 772 226 466
  • | |
  • Our Social
  • 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.1 Introduction to TaRMS and the Self-Service Portal A first-principles tour of the Tax and Revenue Management System — what it replaced, the SSP taxpayer interface, the TIN as the universal identifier, the Single Account ledger, and the legal mandate that makes electronic filing the default channel for every taxpayer in Zimbabwe.
Lesson overview
1

Executive summary

What TaRMS is, why it replaced e-Services, and the legal architecture (Revenue Authority Act, Income Tax Act, VAT Act) that gives the system its mandate.

2

Lesson content

End-to-end conceptual map of the SSP — modules, the TIN, the Single Account, taxpayer profile, and the practical login workflow with screenshots.

3

Assessment & policy notes

Common pitfalls in onboarding, knowledge-check questions with full reasoning, and key takeaways linking TaRMS to Zimbabwe’s revenue-administration policy.

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 system every other lesson in this module runs through.

TaRMS — the Tax and Revenue Management System — is the Zimbabwe Revenue Authority's integrated back-end system for administering domestic taxes, and the Self-Service Portal (SSP) at https://mytaxselfservice.zimra.co.zw is its public-facing front-end. Together they form the digital channel through which Zimbabwean taxpayers now discharge virtually every administrative tax obligation: registering as a taxpayer and obtaining a Taxpayer Identification Number (TIN), filing every domestic return type (income tax, VAT, PAYE, withholding taxes, presumptive taxes and the specialty returns), paying tax in USD or ZiG, viewing assessments and the Single Account ledger, applying for tax clearance certificates (ITF 263), claiming refunds, managing employees for PAYE, lodging objections, and corresponding with ZIMRA officers.

The legal architecture behind the portal is not new — the portal merely digitises obligations that already exist in the Acts. ZIMRA itself is established by the Revenue Authority Act [Chapter 23:11] and administers the Income Tax Act [Chapter 23:06], the VAT Act [Chapter 23:12], the Capital Gains Tax Act [Chapter 23:01] and the annual Finance Act [Chapter 23:04]. Registration is compelled by Part IIIA (Sections 25A–25E) of the Income Tax Act, which gives a registrable taxpayer 30 days to register (Section 25B) and imposes a civil penalty of US$30 plus US$30 per day up to 90 days for default (Section 25C, as substituted by the Finance (No. 2) Act 7 of 2024 with effect from 1 January 2025). Returns are compelled by Section 37 (returns on notice) and Section 37A (self-assessment returns, due four months after the year-end). Records must be kept for six years in English (Section 37B). Withheld taxes must be remitted within the statutory windows under Section 4B of the Finance Act, and Section 80 of the Income Tax Act forces a 30% withholding on contract payments to any payee who cannot produce a valid ITF 263 tax clearance — the single strongest commercial reason taxpayers keep their SSP profile compliant.

TaRMS replaced ZIMRA's legacy e-services platform (efiling.zimra.co.zw) and the legacy Business Partner Number (BPN) identifier. The TIN is now the universal identifier on every return, certificate and payment. The portal organises its functionality into 16 modules visible from the welcome dashboard after login, and it distinguishes sharply between the SSP user (the human being who logs in) and the taxpayer (the legal person whose affairs are managed) — one user can represent many taxpayers, which is how tax agents and group accountants operate.

Two structural concepts dominate everything that follows in this course. First, the Single Account: every taxpayer has one unified ledger across all revenue heads, in both currencies; payments are made into the Single Account and then allocated to liabilities by ZIMRA's allocation rules, not posted directly to the return you intended to pay. Second, currency segregation: USD and ZiG balances never net against each other — a liability must be settled in the currency in which it arose.

This is the first lesson of the TaRMS Essentials course. It is a procedural course: unlike the Income Tax, VAT and CGT courses (which teach the substantive law), these lessons teach you how to use the system that gives effect to that law — with the legal hook for each obligation identified as we go. This opening lesson maps the whole terrain: what TaRMS and the SSP are, the legal basis of the system, the 16 modules and what each does, the user-versus-taxpayer model, and the monthly, quarterly and annual compliance rhythms that the rest of the course will walk through screen by screen.

Sourcing note for this course: the authoritative procedural source is the official SSP online help at https://mytaxselfservice.zimra.co.zw/help/ssp/en/default.htm. The help system could not be fetched at the time of writing (the page requires an interactive browser), so the procedural detail in this lesson is grounded in ZIMRA's Comprehensive Guide to the ZIMRA Self-Service Portal (External Guide, compiled from that help system). Where a screen-level specific has not been re-verified against the live portal this lesson flags it. The portal is updated regularly; menu names and layouts can change.

A. Lesson context: why a tax course needs a systems course

Every substantive rule in the course is now given effect through one platform.

Every substantive rule you have met (or will meet) in the domestic tax courses — the Section 8(1) gross income definition, the VAT charge, PAYE on remuneration, the QPD instalments under Section 72 — ends in the same place: an administrative act performed inside a computer system. A return is filed, an assessment is raised, a payment is allocated, a certificate is issued. Since the go-live of TaRMS, that computer system is one system, and the taxpayer's window into it is the Self-Service Portal.

What TaRMS is, and what the SSP is — they are not synonyms

  • TaRMS (Tax and Revenue Management System) is ZIMRA's internal, back-end revenue administration system. ZIMRA officers work in TaRMS: they process registrations, approve refunds, raise assessments, run audits and manage debt inside it.
  • The SSP (Self-Service Portal) is the public-facing front-end of TaRMS at https://mytaxselfservice.zimra.co.zw. Taxpayers and their agents work in the SSP. Everything submitted in the SSP lands in TaRMS for ZIMRA-side processing, and everything ZIMRA does in TaRMS that concerns you surfaces in the SSP as a notification, an assessment notice, a certificate or a message.

In everyday speech (and in ZIMRA's own notices) "TaRMS" is often used loosely for both. In this course we keep the distinction where it matters: you never log into TaRMS; you log into the SSP, and TaRMS responds.

Why this matters practically — and why it is examinable

The portal is not optional. Registration within 30 days of becoming a registrable taxpayer is a statutory command (Section 25B, Income Tax Act [Chapter 23:06]), backed by an escalating civil penalty (Section 25C) and ultimately a closure notice for business premises. Self-assessment returns are due four months after year-end (Section 37A), monthly PAYE and withholding remittances by the 10th of the following month, and VAT returns by the 25th — and all of these are filed through the SSP. A practitioner who knows the law but cannot navigate Pending Tax Returns, the Single Account or the ITF 263 request screen cannot actually deliver compliance. Examiners increasingly test administration alongside substance — deadlines, the consequences of non-registration, and the clearance-certificate mechanics of Section 80 — precisely because that is where real-world failures happen.

Where this course sits

The Income Tax Course lesson on Administration of Income Tax established the five-phase administrative life-cycle — registration, declaration, verification, assessment, dispute/recovery — and identified TaRMS/SSP as the front-end through which the life-cycle runs. This course zooms into that front-end. Each subsequent lesson takes one module or workflow (logging in, registration, return submission, payments, clearance, refunds, audits, messaging) and walks it step by step. This lesson gives you the map so that none of those walkthroughs feels like an isolated island.

B. Legislative framework: the law behind the portal

The portal has no charging provisions — every screen exists to serve one.

The SSP has no charging provisions of its own. Every screen in it exists to give effect to an obligation or entitlement located in an Act. The framework below is the legal skeleton of the whole course; later lessons re-cite the relevant pieces in depth.

B.1 The administering authority

The Revenue Authority Act [Chapter 23:11] establishes the Zimbabwe Revenue Authority (ZIMRA) under a Commissioner-General, and vests in it the administration of the domestic tax Acts (the Income Tax Act's original administration Sections 3–4 were repealed and replaced by this arrangement from January 2001). The secrecy obligation in Section 5 of the Income Tax Act binds everyone handling taxpayer information — one reason the SSP is built around per-user logins, role-based permissions and formal assignee management rather than shared passwords.

B.2 Registration — Part IIIA of the Income Tax Act (Sections 25A–25E)

  • Section 25A defines who is a registrable taxpayer.
  • Section 25B commands registration within 30 days of becoming registrable. On the portal this is the Taxpayer Registration module, which ends in ZIMRA issuing a TIN.
  • Section 25C imposes the civil penalty for non-registration: US$30 plus US$30 per day of continued default, capped at 90 days, after which ZIMRA may issue a closure notice for business premises. This penalty regime was substituted by the Finance (No. 2) Act 7 of 2024 with effect from 1 January 2025 — an example of the old-versus-new contrast that runs through this Act: the previous regime was a flat civil penalty without the structured daily escalation and closure-notice machinery now in place.
  • Section 25D makes liability to tax independent of registration — not registering does not make income untaxable; it simply adds penalties on top.
  • Section 25E deems certain persons corporate income taxpayers (read with the Thirty-Eighth Schedule).

The VAT Act [Chapter 23:12] has its own registration regime for VAT (compulsory registration above the threshold, voluntary registration below it) — covered in the VAT course and in this course's lesson on VAT Registration Application via TaRMS. On the portal, VAT registration is an additional tax type added to an existing TIN, not a separate identity.

B.3 Returns and records

  • Section 37 (Income Tax Act): annual returns on notice by the Commissioner-General, normally within 30 days of the notice; partnerships file a joint return (Section 37(15)); dormant companies have a proviso.
  • Section 37A: self-assessment — the specified taxpayer must furnish a self-assessment return within four months after the year-end (the deadline was set at four months by the Finance (No. 2) Act 10 of 2022, with effect from the 2023 year of assessment). Critically, the return constitutes the assessment (Section 37A(10)–(11)), though the Commissioner may still raise an assessment (Section 37A(12)). On the portal, this is the ITF 12C in the Tax Return Management module.
  • Section 37AA: separate returns for foreign-currency and local-currency income — the statutory root of the SSP's dual-currency design.
  • Section 37B: records must be kept for six years, in English; default attracts a penalty of the greater of a level 7 fine or 10% of taxable income.
  • The VAT Act requires VAT returns (the VAT 7) per tax period, and the Thirteenth Schedule to the Income Tax Act underpins PAYE withholding and remittance by employers (the P2 return).

B.4 Payment, withholding and remittance

  • Section 4B of the Finance Act [Chapter 23:04] requires withheld amounts to be remitted within the statutory window (with interest and penalty consequences for late remittance — the Income Tax Course lesson on Other Income-Based Levies covers the detail). On the portal: Payments → New Payment.
  • Section 72 (Income Tax Act) sets the QPD (quarterly payment date) instalments for provisional tax — 10% / 25% / 30% / 35% due on 25 March, 25 June, 25 September and 20 December — filed on the ITF 12B.

B.5 The compliance lever — tax clearance

Section 80 of the Income Tax Act obliges a paying officer to withhold 30% of payments to a contractor who does not furnish a valid tax clearance certificate (ITF 263), and Section 80A ties clearance to licensing and registration processes. This is why the Taxpayer Certificates module matters commercially: an expired ITF 263 immediately costs a business 30% of its gross receipts from corporate customers as an advance withholding. The portal runs an automated, real-time compliance check across every revenue head before issuing the certificate, so every other module in this course — returns, payments, profile accuracy — feeds the clearance outcome.

B.6 Disputes

An assessment notice raised in TaRMS (visible under Taxpayer Accounting → Assessment Notices and in Notifications) is the Section 51 assessment notice of the Income Tax Act, and it starts the 30-day objection window under Section 62. The objection itself is lodged in the SSP's Case Management module. The pay-now-argue-later principle (Section 69) means the tax remains payable despite the objection. The dispute-side lessons of the Income Tax Course (itcobjections) give the substantive law; this course's Case Management lesson gives the screens.

B.7 Old law versus new law — the platform transition

Before TaRMS, taxpayers used ZIMRA's e-services platform with a Business Partner Number (BPN) as identifier, manual bank transfers referenced to assessments, and largely paper-based registration and clearance processes. TaRMS introduced: the TIN (replacing the BPN), the Single Account ledger across all tax heads, automated ITF 263 issuance against a real-time compliance check, in-portal objection and audit document management, and integrated e-banking payment rails. Returns from periods predating the SSP that ZIMRA has migrated appear under Tax Return Management → Old Period Documents — the subject of a later lesson.

C. Detailed conceptual explanation: how the portal is organised

User and taxpayer are different things, and the portal is built on that.

C.1 The user versus the taxpayer — the portal's foundational distinction

The SSP separates two concepts that beginners constantly conflate:

  • An SSP user is a person who has created a portal login. One human being = one user account. The user account has its own profile (username, phone, email) managed under Getting Started → SSP User Profile.
  • A taxpayer is the legal person whose tax affairs are administered — an individual, a company, a trust, a partnership — identified by its TIN.

A user can represent multiple taxpayers. A tax agent represents many clients; an in-house accountant represents the employing company and perhaps its subsidiaries; an individual director may represent both herself (as an individual taxpayer) and her company. After logging in, the user shifts to the taxpayer they wish to manage. The portal then operates in one of two modes:

  • User mode — no taxpayer selected. A limited set of modules is available, and things like notifications are addressed to you personally as a user.
  • Taxpayer mode — a specific taxpayer selected. The full module set is available (subject to your assigned role), and notifications, returns, balances and certificates all relate to that taxpayer.

Some modules (Notifications, E-Messaging) exist in both modes and behave differently depending on the mode — a recurring source of confusion addressed in section F.

C.2 The 16 modules — the map of the whole course

After login, the welcome page presents the portal's functionality as 16 modules. The table below is the master map; almost every later lesson in this course is a deep dive into one row.

# Module Purpose Key pages within it
1 Getting Started SSP account creation, login, password, user profile, logout SSP Registration • Login • Password Reset • SSP User Profile • Changing the Password • User Inactivity and Logout
2 Taxpayer Registration Apply for registration as a taxpayer (TIN issuance) Register taxpayer (individual / entity)
3 Taxpayer Information View and amend the taxpayer profile; status changes Taxpayer Profile • Applications • Requests • Drafts
4 Assignee Management Grant other users access to the taxpayer's affairs Roles • Assignees • Tax Agent Assignment
5 Taxpayer Certificates Apply for and download tax clearance (ITF 263) Certificates • Certificate Requests
6 Employee Management Register employees and manage earnings for PAYE Employees • Earnings • Assessment of Employee Earnings
7 Tax Return Management File every return type; drafts; e-agreements; old periods Pending Tax Returns • Submitted Tax Returns • E-Agreement • Old Period Documents • Drafts
8 Taxpayer Accounting What ZIMRA says you owe Assessment Notices • Audit Assessment Notices • Summary Report • Tax Type Report
9 Payments Balances, paying, history, withdrawals Balance • New Payment • E-Banking • Payment History • Single Account Transactions • Withdrawal • Withdrawal Application History
10 Refund Management Refund applications Applications • Drafts
11 Invoice Management Match fiscalised invoices for VAT input-tax claims Invoices • Diplomatic Missions and Development Partners Invoices
12 Audit Management Taxpayer-initiated audit documents (e.g. voluntary disclosure) Audit Documents • Drafts
13 Debt Management Overdue debts and instalment plans Overdue Debts • Instalment Plan • Instalment Applications • Drafts
14 Case Management ZIMRA cases; objections and responses Documents • Drafts
15 E-Messaging Direct messages with ZIMRA / TaRMS Messages • Drafts
16 Notifications TaRMS notifications to the user or the taxpayer Taxpayer Notifications • User Notifications

C.3 First contact with the portal — the two registrations, step by step

A beginner must grasp that there are two distinct registrations, performed in sequence:

Step 1 — SSP user registration (create your login).

  1. Visit https://mytaxselfservice.zimra.co.zw and click Sign Up.
  2. State whether you are a Zimbabwean resident or a non-resident.
  3. Complete the mandatory fields. For residents: National Registration ID Number, Title, First Name, Middle Name(s) (optional), Surname, Gender, Date of Birth, Nationality, Username (unique across the SSP), Phone Number, Email Address. For non-residents, Passport Number replaces the National ID.
  4. Submit. ZIMRA verifies the data and emails a password-creation link to the registered address.
  5. Follow the link, set a password — you can now log in.

Step 2 — Taxpayer registration (obtain a TIN).

Once logged in, use the Taxpayer Registration module to register the taxpayer — yourself as an individual, or the entity you represent (company, trust, partnership, non-resident with Zimbabwean obligations). ZIMRA processes the application and issues the TIN, the identifier used on every return, certificate and payment thereafter. The legal clock here is Section 25B'Section 30 days; the full screen-by-screen walkthrough is a dedicated later lesson.

Logging in thereafter:

  1. Go to the portal URL; enter your username (or registered email) and password; click Log In.
  2. If browser verification is requested, retrieve the verification code (phone or email) and click Verify.
  3. The welcome page opens with the 16-module dashboard. Shift to the taxpayer you wish to manage.

The portal logs users out automatically after a period of inactivity, and passwords are reset via Forgot Password on the login page (repeated wrong attempts can temporarily lock the account). The dedicated lessons on Logging In and Password Management cover the error states.

C.4 The Single Account — the portal's accounting heart

Every taxpayer has one Single Account at ZIMRA: a unified ledger across all revenue heads, maintained in both USD and ZiG, recording every assessment and every payment. Two consequences follow, and they explain half of the reconciliation problems practitioners encounter:

  1. Payments are allocated, not directed. A payment does not post directly to the return you meant to pay. It enters the Single Account and ZIMRA's allocation rules distribute it — typically to the oldest debt first within a tax type, then by tax-type priority. A payment you intended for this month's VAT can therefore be swallowed by an old PAYE shortfall, leaving the VAT "unpaid" and attracting penalties even though the money left your bank. The defence is hygiene: keep every tax type current, and reconcile the Single Account monthly using Taxpayer Accounting → Summary Report and Payments → Single Account Transactions.
  2. Currencies do not net. USD assessments must be settled in USD; ZiG assessments in ZiG. A healthy ZiG credit balance does nothing for a USD liability. This is the portal-level expression of the dual-currency return regime in Section 37AA.

C.5 The communication layer — notifications, messages, cases

Three modules carry information between you and ZIMRA, and they are not interchangeable:

  • Notifications is one-way: TaRMS tells you things — assessment notices, refund approvals, certificate availability, audit findings, payment confirmations. Notifications split by mode: User Notifications (to you personally) versus Taxpayer Notifications (to the taxpayer you have shifted to). Configure email forwarding so notifications also reach your inbox; do not rely on daily logins.
  • E-Messaging is two-way correspondence for routine matters: querying an allocation, following up an instalment plan, asking for clarification on an assessment. It is the portal's email-equivalent — informal, but on the record.
  • Case Management is the formal channel: ZIMRA-initiated cases, and taxpayer-initiated objections (the Section 62 objection goes here, never through E-Messaging). Using the wrong channel for an objection risks missing the 30-day window with an informal message that has no legal effect as an objection.

C.6 Status flow of a submitted document

Most documents in the portal follow the same life-cycle, which you will see in every later lesson: a form is opened (often from Pending Tax Returns, pre-populated with the taxpayer's header data), completed (the SSP computes subtotals automatically), optionally saved as a Draft, then Submitted, after which it sits in a Waiting for Approval state (during which a return can still be amended) before ZIMRA-side processing completes. Every module has its own Drafts page — drafts are module-specific, not pooled.

D. Real-world applicability: who uses what

Who actually uses which part, from employee to large corporate.

D.1 Individuals (employees, sole traders, professionals)

Scenario — Rudo, a salaried employee in Harare. Rudo's PAYE is withheld by her employer, so her routine portal footprint is light: she registers as an SSP user, registers herself as an individual taxpayer (TIN), and primarily uses Notifications, Taxpayer Information (keeping her address current) and — if she has non-employment income such as rentals — Tax Return Management for an annual ITF 1/self-assessment return. If she buys immovable property, conveyancing will surface CGT processes; if she takes up consultancy work, Section 80 means her corporate clients will demand her ITF 263, pulling her into the Taxpayer Certificates module.

Scenario — Tendai, a sole-trader electrician. Tendai's stakes are higher: registration within 30 days of starting trade (Section 25B, else the Section 25C US$30 + US$30/day penalty), quarterly ITF 12B QPDs, an annual self-assessment, and — because his commercial customers withhold 30% without it — a perpetually valid ITF 263. For Tendai the portal is his tax function.

D.2 SMEs and partnerships

Scenario — Mbare Hardware (Pvt) Ltd, a VAT-registered wholesaler with 12 employees. The company's accountant lives in the portal on a monthly rhythm:

  • By the 10th: file the P2 PAYE return (fed by Employee Management, where the 12 employees and their monthly earnings are maintained) and any REV 5-series withholding returns; pay via Payments → New Payment.
  • By the 25th: file the VAT 7, first using Invoice Management to match fiscalised input-tax invoices on ZIMRA's file against the purchase ledger; pay.
  • Month-end: reconcile Taxpayer Accounting → Summary Report against the company ledger; raise allocation queries via E-Messaging; check Notifications and Case Management for new correspondence.
  • Quarterly (25 Mar / 25 Jun / 25 Sep / 20 Dec): file the ITF 12B and pay the QPD instalment (10% / 25% / 30% / 35% under Section 72).
  • Annually (by 30 April for a 31 December year-end): file the ITF 12C self-assessment with attachments; through October–November, apply for the next year's ITF 263 under Taxpayer Certificates → Certificate Requests; at year-end, generate ITF 16 employee certificates from Employee Management and reconcile the year's P2s against them.

A partnership is transparent for income tax (Section 10(2) — see the Income Tax Course), but it still files the joint partnership return (Section 37(15)) and, if VAT-registered, the VAT 7, so the portal mechanics are the same.

D.3 Large corporates and multinationals

A group adds three layers. First, Assignee Management becomes governance-critical: the group tax manager assigns roles (read-only viewer, return preparer, return submitter, payment authoriser) to finance staff and external advisers per entity, and reviews the assignee list quarterly. Second, volume: dozens of revenue heads across several TINs means the Summary Report and Tax Type Report become the reconciliation backbone, and misallocations within the Single Account are a monthly reality to manage. Third, the formal channels get heavier use — Case Management for objections (transfer-pricing and management-fee disputes especially), Audit Management for voluntary disclosures, and Debt Management for instalment plans negotiated before liabilities fall due (ZIMRA is more receptive to instalment applications lodged before the due date than after).

D.4 Worked illustration — the cost of ignoring the portal

Tendai (D.1) starts trading on 1 February and only registers on 30 June, 119 days later (89 days beyond the 30-day Section 25B window, within the 90-day penalty cap):

Item Computation Amount
Base civil penalty (Section 25C) fixed US$30
Daily penalty US$30 × 89 days US$2,670
Total registration penalty US$2,700

Meanwhile, a corporate customer paying him US$4,000 for a contract during the unregistered period must withhold 30% = US$1,200 under Section 80 because he has no ITF 263 — recoverable later as an advance credit, but a brutal cash-flow hit. And by Section 25D, his trading income for the unregistered months remains fully taxable. The portal is cheaper than the alternative.

E. Case law integration

Honesty first: there is no body of case law on the platform itself.

Honesty first: there is no body of case law on TaRMS or the SSP itself. The system is recent, and disputes about how a portal screen works do not reach the courts. What the courts have shaped is the legal machinery the portal implements, and those authorities — all from the Income Tax Course — remain the governing context:

  • CF (Pvt) Ltd v ZIMRA and the Section 51/Section 62 line of cases (e.g. Nestlé Zimbabwe (Pvt) Ltd v ZIMRA 20-SC-290; Barclays Bank of Zimbabwe v ZIMRA 04-HH-162): the assessment notice and the 30-day objection window are strict — the portal's Notifications and Case Management modules are where that window now opens and closes in practice.
  • Hilmax Enterprises (Pvt) Ltd v ZIMRA 22-HH-832: ZIMRA's information-gathering powers under Section 44 extend to information, not to seizing the laptop itself — relevant context for audit interactions that now begin as TaRMS audit cases.
  • PPC Zimbabwe v ZIMRA 19-HH-755: the Commissioner-General's powers are exercised through proper delegation — the institutional frame within which TaRMS officers act.

Where a later lesson touches a dispute-bearing process (objections, audits, recovery), it will cite the substantive authorities there. For pure navigation lessons, expect this section to be sparse — that is the honest position, not an omission.

F. Common pitfalls

Conflating a user account with a taxpayer registration.

  1. Conflating SSP user registration with taxpayer registration. Creating a login does not register you as a taxpayer or stop the Section 25B clock. The TIN comes only from the Taxpayer Registration module. New businesses repeatedly discover this 90 penalty-days too late.
  2. Sharing one SSP login across the finance team. It breaks the portal's security model, defeats the audit trail, and becomes a crisis when the password-holder resigns. Correct approach: each person has their own user account; access is granted and revoked through Assignee Management, reviewed quarterly.
  3. Operating in the wrong mode. Looking for a company's assessment notice while in User mode (or in the wrong taxpayer after shifting) and concluding "there's nothing there." Always confirm which taxpayer you have shifted to before reading notifications or balances.
  4. Treating a payment as settling a specific return. It does not — the Single Account allocates it, oldest-debt-first. If an old liability lurks anywhere in the ledger, this month's VAT payment may be consumed by it. Reconcile monthly; query misallocations promptly through E-Messaging.
  5. Paying in the wrong currency. USD and ZiG ledgers do not net. A ZiG payment cannot extinguish a USD assessment. Check the currency of the liability on the Balance screen before paying.
  6. Ignoring Notifications between filing deadlines. Assessment notices start the 30-day objection clock whether or not you log in. Configure email forwarding of notifications and check Taxpayer Notifications at least weekly.
  7. Lodging an objection through E-Messaging. A message is not a Section 62 objection. Formal objections go through Case Management → Documents, within 30 days, with the tax paid meanwhile (Section 69).
  8. Letting the taxpayer profile go stale. ZIMRA cross-checks ITF 263 applications against Taxpayer Information; outdated addresses, bank details or revenue-head registrations stall the automated clearance check precisely when a customer is demanding the certificate.
  9. Leaving drafts unsubmitted. A return saved as a draft has not been filed. Filing deadlines are met by submission, not by preparation. Check the module's Drafts page before every deadline.

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

The back-end, the portal, and what each is for.

  • TaRMS is ZIMRA's back-end; the SSP at https://mytaxselfservice.zimra.co.zw is the taxpayer's front-end. Everything administrative — registration, returns, payments, clearance, refunds, objections — now runs through it.
  • The portal digitises pre-existing legal duties: registration within 30 days (Section 25B, penalties Section 25C, liability regardless Section 25D), returns (Sections 37, 37A — four months after year-end, return = assessment), records (Section 37B, six years), remittance (FA Section 4B), QPDs (Section 72), clearance leverage (Section 80, 30% withholding), objections (Sections 51, 62, 69).
  • Two registrations, in order: SSP user account first (your login), then taxpayer registration (the TIN — successor to the legacy BPN). Confusing them is the classic new-business penalty trap.
  • User ≠ taxpayer; mode matters. One user can represent many taxpayers; shift deliberately, and read notifications in the right mode.
  • The Single Account allocates payments (oldest debt first) and never nets USD against ZiG. Reconcile monthly via the Summary Report and Single Account Transactions; pay in the liability's currency.
  • Use the right channel: Notifications (one-way, watch the 30-day clocks), E-Messaging (routine two-way), Case Management (formal objections only here).
  • The compliance rhythm is fixed: P2 and withholding returns by the 10th; VAT 7 by the 25th; QPDs 25 Mar / 25 Jun / 25 Sep / 20 Dec; ITF 12C four months after year-end; ITF 263 renewal ahead of expiry.
  • Case law on the portal itself is non-existent — the governing authorities attach to the underlying machinery (assessments, objections, information powers), and this course says so rather than padding.

Tables and diagrams

The legacy regime against the current one.

Legacy regime versus TaRMS/SSP

Dimension Legacy (pre-TaRMS) TaRMS / SSP
Taxpayer identifier Business Partner Number (BPN) TIN (universal across returns, certificates, payments)
Filing channel e-services platform / paper SSP — Tax Return Management, all return types
Ledger Per-tax-head accounts Single Account across all heads, USD and ZiG segregated
Payment Bank transfer referenced manually New Payment (card / e-banking), auto-allocated by rules
Tax clearance (ITF 263) Manual application and review Automated real-time compliance check, download in-portal
Objections / audit documents Letters / physical lodgement Case Management / Audit Management modules
Correspondence Email, phone, visits Notifications + E-Messaging, on the record
Access control Shared credentials common Per-user logins, roles via Assignee Management

The taxpayer's portal life-cycle

flowchart TD
 A[Create SSP user account - Sign Up] --> B[Log in and verify]
 B --> C[Register taxpayer - TIN issued]
 C --> D{Compliance cycle}
 D --> E[File returns - Pending Tax Returns]
 E --> F[Pay - New Payment into Single Account]
 F --> G[Reconcile - Summary Report and Transactions]
 G --> H{Notice received?}
 H -->|Assessment disputed| I[Objection via Case Management within 30 days]
 H -->|Refund position| J[Refund application then Withdrawal]
 H -->|All clear| K[Request or renew ITF 263]
 I --> D
 J --> D
 K --> D

Choosing the right communication channel

flowchart TD
 A[Need to communicate with ZIMRA] --> B{Is it a formal dispute or response to a case?}
 B -->|Yes - objection, scheme, case response| C[Case Management - Documents]
 B -->|No| D{Routine query or follow-up?}
 D -->|Yes - allocation, clarification, instalment follow-up| E[E-Messaging]
 D -->|No - just monitoring| F[Notifications - check User and Taxpayer modes]

References

The registration Part and the information-technology provisions.

Statutes & sections

  • Income Tax Act [Chapter 23:06] — Part IIIA Sections 25A–25E (registration: 30-day duty Section 25B; civil penalty Section 25C as substituted by Finance (No. 2) Act 7 of 2024 w.e.f. 1 Jan 2025; liability independent of registration Section 25D); Section 37 (returns on notice; partnership joint return Section 37(15)); Section 37A (self-assessment, four months after year-end; return constitutes assessment Section 37A(10)–(11)); Section 37AA (separate currency returns); Section 37B (six-year records); Section 44 (information powers); Section 51 (assessment notice); Section 62 (objection, 30 days); Section 69 (pay-now-argue-later); Section 72 (QPDs); Section 80 / Section 80A (30% withholding absent ITF 263; clearance and licensing); Section 5 (secrecy).
  • Finance Act [Chapter 23:04] — Section 4B (remittance of withheld amounts; interest/penalty for default).
  • VAT Act [Chapter 23:12] — VAT registration and periodic VAT returns (VAT 7) given effect through the SSP.
  • Revenue Authority Act [Chapter 23:11] — establishment of ZIMRA and the Commissioner-General.

Case law

  • Nestlé Zimbabwe (Pvt) Ltd v ZIMRA (2020, SC) — strictness of the assessment/objection machinery.
  • Barclays Bank of Zimbabwe v ZIMRA (2004, HH) — objection-window context.
  • Hilmax Enterprises (Pvt) Ltd v ZIMRA (2022, HH) — limits of Section 44 information powers.
  • PPC Zimbabwe v ZIMRA (2019, HH) — exercise of the Commissioner-General's powers.
  • No authority exists on TaRMS/SSP mechanics themselves; the above govern the underlying administrative law.

ZIMRA guidance

  • Comprehensive Guide to the ZIMRA Self-Service Portal — ZIMRA External Guide (module-by-module walkthrough; primary procedural source for this lesson).
  • ZIMRA SSP online help — https://mytaxselfservice.zimra.co.zw/help/ssp/en/default.htm (authoritative per-screen reference; not reachable for re-verification at the time of writing — see VERIFY flags).
  • Zimbabwe Tax Compliance Calendar — ZIMRA (deadline rhythm: 10th, 25th, QPD dates, annual return).
  • Comprehensive Guide to the ITF 263 — ZIMRA External Guide (clearance compliance grid).

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