HDbeammachineBeam Machine Docs
Help Center

Generating a VAT201 Return

Step-by-step guide for selecting a VAT period, generating the VAT201, and reviewing the 12-box output before submission.

publicusers

Generating a VAT201 Return

This page shows you how to select a VAT period, generate a VAT201 return, and review the 12-box output before anyone treats it as filing-ready.

Product: Beam Machine
Module: Tax -> VAT Returns
Role: Accountant, Tax Preparer, Finance Lead
Difficulty: Intermediate
Time: 10 minutes first time, 4 minutes repeat
Last Updated: 2026-03-10
Version: Current Beam Machine app build in this repo

Before You Start

  • You need access to the Tax module.
  • The relevant VAT period must already exist.
  • The underlying transactions should already be posted correctly.
  • Read ../modules/05-working-in-tax.md if you need the wider tax context first.

What is a VAT201 return?

A VAT201 return is the summary SARS expects from VAT-registered businesses for each VAT period. It shows what VAT you charged, what VAT you can claim, and the amount payable or refundable. In Beam Machine, the return is generated from the transactions in the selected period.

When do you use this?

Use this task when the VAT period is ready for preparation and finance needs a draft return for review. If the source transactions are wrong, the VAT201 will reflect those errors instead of fixing them.

Where to find it

Primary path: Finance -> Tax -> VAT Returns
Route: /dashboard/tax/vat-returns

How to generate a VAT201 return

  1. Open Tax from the left sidebar.
  2. Click VAT Returns.
  3. In VAT Period, select the correct VAT period.
  4. Click Generate VAT201.

āœ… Checkpoint: You should see a success message if the generation completes correctly, and the selected period should now show a return status in the VAT Periods & Returns table.

  1. In the VAT Periods & Returns table, find the period you just generated.
  2. Review the Period Status and Return Status.
  3. If a SARS Ref appears, note it for your review trail.
  4. Click View VAT201.
  5. Review all 12 boxes in the VAT201 detail table.
  6. Pay special attention to the summary rows for:
    • Box 4 total supplies
    • Box 8 total inputs
    • Box 12 VAT payable or refundable
  7. Close the detail view after review.

What happens next: The return stays visible against the VAT period and can be reviewed further before submission or downstream filing activity.

Common Questions & Issues

"I cannot generate the VAT201"

Why this happens: The most common cause is that no VAT period is selected.

Fix: Choose the VAT period first, then click Generate VAT201 again.

"The VAT201 looks wrong"

Why this happens: The VAT201 is driven by posted transactions. If the underlying transactions or VAT treatment are wrong, the return will be wrong too.

Fix: Review the accounting records and VAT-linked activity for the selected period before regenerating the return.

"There is no return for the period"

Why this happens: A VAT period can exist without a generated return.

Fix: Generate the return from the selected period, then check the status table again.

What's Next

Related Pages

SA Compliance Reference

  • South African VAT-registered businesses submit VAT201 returns to SARS for each VAT period. This page explains the Beam Machine generation flow, not the full legal filing process or advisory signoff requirements.

Still Stuck?

Was this page helpful?

[Yes] [No]