HMRC Submission Success & Failure Notifications

Available from: v1.0.28

Whenever a quarterly HMRC submission completes — whether it succeeds or fails — you are automatically notified via an in-app notification and an email. You do not need to manually check submission status.

How It Works

After your quarterly submission is processed by HMRC, the system emits an internal hmrc/quarterly-submit.completed event. This event triggers the notification workflow, which inspects the submission outcome and delivers the appropriate notification.

hmrc-quarterly-submit function
        │
        ├─ step 7 / step 8 completes
        │
        └─ emits: hmrc/quarterly-submit.completed
                        │
                        ├─ status = 'submitted'  → Success notification (in-app + email)
                        └─ status = 'failed'     → Urgent failure notification (in-app + email)
                           status = 'rejected'

Success Notifications

When HMRC accepts your submission, you receive a confirmation notification containing the following details:

Field	Description
HMRC Correlation ID	The unique reference HMRC assigned to this submission
Submission ID	Your internal submission reference
Tax Year	The tax year covered by this submission
Quarter	The quarterly period submitted (Q1–Q4)
Net Profit / Income	A summary of the figures submitted to HMRC

Keep the HMRC Correlation ID — it is the reference to quote if you ever need to contact HMRC about a specific submission.

Failure & Rejection Notifications

If HMRC rejects or the system fails to submit your quarterly return, you receive an urgent notification. These notifications include:

The HMRC error code returned
A plain-English explanation of what went wrong
Clear, actionable next steps so you know exactly what to do

Common Error Example

HMRC rejected this submission: invalid NI number Please re-check your National Insurance Number in Settings and resubmit.

Other errors may relate to:

Submission window timing (e.g. submitting outside the allowed quarterly period)
Missing or malformed income/expense figures
HMRC service availability issues

In all cases, the notification will tell you what the error means and what action to take next.

Where to Find Notifications

In-app: The notification bell/inbox in the application header. Urgent (failure) notifications are visually distinguished from standard (success) notifications.
Email: Sent to the email address associated with your account. Check your spam folder if you do not see it within a few minutes of submission.

Audit Log

Every submission outcome — success or failure — is recorded in the Audit Log. This provides a tamper-evident history of all your HMRC submissions, useful for your own records and in the event of any dispute with HMRC.

Frequently Asked Questions

What should I do if I receive a failure notification? Read the plain-English description and follow the next steps provided in the notification. The most common fix is correcting your National Insurance Number in Settings → Profile.

Will I be notified for every quarter? Yes. A notification is sent for every submission attempt, regardless of outcome.

I submitted successfully but haven't received a confirmation email — what now? Check your spam folder first. If it is not there, verify that your account email address is correct in Settings → Profile. You can also confirm the submission status via the Audit Log.

Where do I find my HMRC Correlation ID? It is included in both the in-app notification and the confirmation email. It is also recorded in the Audit Log against the relevant submission.