HDbeammachineBeam Machine Docs
Help Center

Understanding VAT Periods and VAT201

How to create VAT periods, generate VAT201 returns, finalize them for review, and record SARS submission details honestly in the current Beam Machine workflow.

publicusers

Understanding VAT Periods and VAT201

This page shows you how Beam Machine currently handles VAT periods, VAT201 generation, finalization, and submission tracking without pretending the app already replaces the full SARS process.

Product: Beam Machine
Module: Tax -> VAT Periods and VAT Returns
Role: Bookkeeper, Accountant, Tax Preparer, Finance Lead
Difficulty: Intermediate
Time: 12 minutes first read, 3 to 8 minutes per period once set up
Last Updated: 2026-03-10
Version: Current Beam Machine app build in this repo

Before You Start

  • You need access to Tax.
  • You need the correct entity and the correct VAT cycle.
  • Your invoicing, purchasing, and bank postings must already be clean enough to support VAT.
  • Read ../tasks/05-generating-a-vat201-return.md if you only need the shorter VAT201 task version.

What is a VAT period and a VAT201?

A VAT period is the reporting window SARS expects you to report on. A VAT201 is the return that tells SARS what VAT you charged, what VAT you can claim, and what you owe or expect back.

In Beam Machine, VAT work is split across two live screens:

  • VAT Periods for creating periods and moving them through status
  • VAT Returns for generating and reviewing the 12-box VAT201 summary view

Important: the current BM build shows a 12-box VAT201 view. The source scope documents describe broader VAT coverage, but that wider field set is not fully exposed in the current UI.

When do you use this?

Use this page when a VAT period is ready to be prepared, reviewed, finalized, or recorded as submitted.

If you do this before your books are right, you do not get a better VAT return. You get a faster wrong answer.

Where to find it

Primary path: Finance -> Tax -> VAT Periods
Alternative path: Finance -> Tax -> VAT Returns
Routes: /dashboard/tax/vat-periods and /dashboard/tax/vat-returns

How to manage VAT periods and VAT201 in BM

Create the VAT period

  1. Open Tax.
  2. Click VAT Periods.
  3. Click Create VAT Period.
  4. Enter the Period Name.
  5. Enter the Start Date.
  6. Enter the End Date.
  7. Click Create Period.

āœ… Checkpoint: The new period should appear in the table with a status you can work from.

Generate the VAT201

  1. Stay on VAT Periods and click Generate for the open period, or open VAT Returns and select the period from VAT Period.
  2. Click Generate VAT201.
  3. Wait for the success message or refreshed table state.
  4. In VAT Returns, review the VAT Periods & Returns table.
  5. Click View VAT201 for the generated return.
  6. Review all 12 boxes, especially the summary rows:
    • Box 4 total supplies
    • Box 8 total inputs
    • Box 12 VAT payable / refundable

āœ… Checkpoint: You should now have a generated VAT201 and a visible return status against the period.

Finalize the VAT201 for internal sign-off

  1. Go back to VAT Periods.
  2. Find the period in draft status.
  3. Click Finalize.
  4. Refresh the table if needed and confirm the period now shows finalized.

Record submission honestly

  1. Complete the actual filing steps in your SARS channel and finish your internal review outside Beam Machine.
  2. Return to VAT Periods.
  3. Click Submit on the finalized period.
  4. Enter the SARS Reference Number exactly as you received it from the real filing process.
  5. Click Submit to SARS.

What happens next: Beam Machine records the status and the SARS reference number against that VAT return.

What BM does and does not do right now

  • BM does let you create VAT periods, generate VAT201 data, finalize the return state, and store a SARS reference number.
  • BM does not prove direct electronic filing into SARS from this route. The current submit action records submission status in BM after you provide the SARS reference number.
  • BM does show Box 1 as standard rate supplies at 15% in the current build. If SARS rules change in future, confirm current filing treatment before relying on old screen labels.

Common Questions & Issues

"I cannot generate the VAT201"

Why this happens: The period may not exist yet, or the wrong period was selected.

Fix: Create or select the correct VAT period first, then generate again.

"The VAT201 is there, but the numbers look wrong"

Why this happens: The return reflects the underlying transactions and tax mappings. It does not correct source errors for you.

Fix: Fix the accounting records, then regenerate the return.

"I clicked Submit to SARS, so BM must have filed it"

Why this happens: The button label sounds like direct filing.

Fix: In the current BM build, that action stores the submission state and SARS reference in Beam Machine. Treat the actual SARS filing as an external step unless your delivery team has separately proved a live integration in your environment.

"Why does my VAT deadline in planning not match the period end date?"

Why this happens: A reporting period end date and a legal filing deadline are not the same thing.

Fix: Work from the SARS due date for your filing channel, not only the BM period dates. SARS guidance currently says manual VAT201 filing is due by the 25th and eFiling by the last business day of the following month.

What's Next

Related Pages

SA Compliance Reference

Still Stuck?

Was this page helpful?

[Yes] [No]