Why do VAT returns fail to submit from Zoho Books?
Zoho Books files UK VAT returns through HMRC’s Making Tax Digital API. When a submission bounces, the cause is almost always one of six things:
- The HMRC authorisation has expired (it lasts 18 months)
- HMRC’s MTD service is down, which surfaces as “Unable to connect with HMRC”
- HMRC already holds a return for that period (
DUPLICATE_SUBMISSION) - The return period in Zoho Books doesn’t match an open HMRC obligation
- The connection uses the wrong Government Gateway identity (agent vs business)
- First-submission setup mistakes: the VAT number format or MTD enrolment still processing at HMRC
Work through them in order. The first is the most common by a distance and takes two minutes to fix.
Has the 18-month HMRC authorisation expired?
When you first connect Zoho Books to HMRC, you grant Zoho authority at the Government Gateway to file on your behalf. That grant is valid for 18 months. After that, HMRC rejects everything from Zoho Books with authorisation errors.
The 18-month window is long enough that everyone forgets it exists. Six returns file without a hitch, then the seventh fails the night before the deadline and nobody can think what changed. Nothing changed in Zoho Books. The token died of old age.
To fix it:
- Go to Settings (gear icon) > Taxes > VAT Settings in Zoho Books.
- Find the HMRC connection status and click Reauthorise (or reconnect).
- Sign in at the Government Gateway with the credentials used originally and approve the grant.
- Retry the submission. It should go straight through.
Put the renewal date in the calendar before you close the tab. When we design Zoho finance setups for UK clients, the reauthorisation date goes into the month-end checklist.
What does “Unable to connect with HMRC” mean?
This one usually isn’t your fault. The message means Zoho Books reached out to HMRC’s API and got nothing useful back. HMRC takes the MTD service down for planned maintenance more often than people expect and it degrades unannounced around peak filing dates.
Before touching anything in Zoho Books, check HMRC’s MTD VAT service availability page on GOV.UK. If there’s a listed outage, stop and retry in an hour or two. Hammering the submit button during an outage achieves nothing and occasionally creates the duplicate problem described below.
If GOV.UK shows the service as healthy, treat the message as an authorisation problem in disguise. A revoked or expired grant can surface as a generic connection error. Reauthorise as above, then retry.
Why is HMRC rejecting my return as a duplicate?
A DUPLICATE_SUBMISSION error means HMRC has already received a return for that obligation period. The usual culprits:
- Your accountant filed it. They saw the deadline coming and filed from their own software without telling you.
- A previous tool filed it. A bridging spreadsheet or your old accounting package submitted the period before you switched.
- An earlier attempt succeeded. A submission that timed out or threw an error on screen may still have landed at HMRC. The error you saw was on the response, not the submission.
Whatever the cause, don’t resubmit. Log into the Business Tax Account (or ask your agent) and check the figures HMRC holds for the period. If they match your Zoho Books return, record the return as filed in Zoho Books and move on. If they do not match, you have a filed return with wrong numbers, which is the correction process covered further down.
Why do my VAT periods not match HMRC’s?
HMRC defines your obligation periods. Every VAT-registered business sits in a stagger group (calendar quarters, quarters ending a month either side, or monthly). Zoho Books generates returns from the reporting period in your VAT settings. If the two disagree, the return covers dates HMRC has no open obligation for and the submission fails.
Check the stagger first. Your VAT certificate states it and the Business Tax Account shows the open obligations with exact start and end dates. Compare those against Settings > Taxes > VAT Settings in Zoho Books, where the reporting period and first return date live. Correct the Zoho Books side, regenerate the return and submit again.
One trap: a stagger change or a move to monthly returns usually creates a one-off long or short transitional period. Zoho Books won’t guess it. Set the period manually to match the obligation HMRC is showing.
Are you connected as an agent or as the business?
HMRC will accept a submission for your VAT number from exactly two identities: the business’s own Government Gateway account enrolled for VAT, or an agent’s Agent Services Account with your business linked as a client. Anything else fails with CLIENT_OR_AGENT_NOT_AUTHORISED.
The classic failure: an accountant connects with a personal or legacy agent login rather than the Agent Services Account, or uses the right account before the client authorisation has been accepted. The credentials are valid, the login works, HMRC still says no.
If the business owner files, use the business’s own Gateway credentials and ignore agent accounts entirely. If an accountant files for you, they need to complete the client link in their Agent Services Account first, then connect Zoho Books with those credentials. The grant belongs to whoever signed in, so a wrong identity means disconnecting and reconnecting in VAT Settings.
Why is my first MTD submission failing?
First submissions fail for setup reasons that never trouble you again. Two dominate:
- VAT number format. HMRC’s systems want the nine-digit number on its own. A GB prefix, a space or a missing leading zero in Settings > Taxes > VAT Settings is enough to break the match. Check it digit by digit against your VAT certificate.
- MTD enrolment not live at HMRC. Newly VAT-registered businesses can’t file the moment registration is approved. HMRC takes days to make the record available to the MTD API, sometimes longer in busy periods. Until then Zoho Books gets authorisation or not-found errors whatever you do. Wait for HMRC’s confirmation, then connect.
Established businesses moving to Zoho Books rarely have an enrolment problem; almost everyone was brought into MTD automatically in 2022. Look at the VAT number format and credentials instead.
Deadline-day triage: what order to check things in
The filing deadline is one calendar month plus seven days after the period end. If that’s today and the return won’t go, work this order:
- GOV.UK service availability. If HMRC’s MTD service is down, note the outage (screenshot it) and retry later in the day.
- Reauthorise the HMRC connection. Two minutes in VAT Settings and it clears the single most common cause.
- Confirm the Gateway identity. Business credentials for the business, Agent Services Account with the client linked for agents.
- Compare the return period against the open obligation in the Business Tax Account. Fix the Zoho Books reporting period if they disagree.
- Pay the VAT anyway. Payment doesn’t depend on the submission. Late submission earns penalty points; late payment costs real money on a separate clock.
- Still stuck? Ring the HMRC VAT helpline and keep your evidence. HMRC is reasonable about genuine software issues when the return follows promptly.
If the blocker turns out to be in Zoho Books itself and the deadline is hours away, our emergency Zoho developer service puts a senior developer on it within 30 minutes during UK business hours.
How do I fix the figures after a return has filed?
Sometimes the submission isn’t the problem; the numbers were. Duplicated income from a reconnected feed, a missing fortnight of transactions, a purchase entered with the wrong tax rate. Feed gaps are a frequent source, which is why our guide on Zoho Books UK bank feeds not working tells you to close the gap before you file.
Once a return has gone in, the correction route depends on size. Net errors under 10,000 pounds (or under 50,000 pounds where the error is below 1 percent of box 6 turnover) can be corrected on your next return. Post the correcting transactions or journals in Zoho Books inside the current period and the next return absorbs the adjustment. Larger errors, or anything deliberate, must go to HMRC’s error correction team on form VAT652.
Either way, never refile the original period from Zoho Books. The obligation is fulfilled and HMRC will reject it as a duplicate.
Quick diagnostic checklist
- Authorisation older than 18 months? Reauthorise in Settings > Taxes > VAT Settings and retry.
- “Unable to connect with HMRC”? Check the GOV.UK service availability page before changing anything.
DUPLICATE_SUBMISSION? Check the Business Tax Account for what HMRC holds. Never resubmit a fulfilled period.- Period rejected? Compare your Zoho Books reporting period against the open obligation dates at HMRC.
- Not-authorised errors with valid credentials? Wrong Gateway identity. Reconnect as the business, or as an agent with the client link completed.
- First ever submission? Check the nine-digit VAT number format and confirm HMRC has finished processing the registration.
- Deadline today and still stuck? Pay the VAT on time regardless, then ring HMRC with your evidence.
When to bring in help
A failed reauthorisation is a self-service fix. A VAT setup where the periods have never quite matched HMRC, duplicates have crept into filed returns and nobody is sure which Gateway account holds the grant is a different job. Untangling that mid-quarter is faster with someone who has done it before.
H4Z is a UK-based Zoho consultancy with clients worldwide. Our Zoho Books service covers MTD setup, VAT scheme configuration and the clean-up when filings have gone wrong, with published pricing and a developer assigned to standard projects within 24 hours. The discovery consultation is free, so get in touch and we’ll tell you whether you need ten minutes of reauthorisation or a proper rebuild of the VAT workflow.