Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2023-06-23
Troubleshooting: E-Filed VAT Return Fails to Submit (UK)

Troubleshooting: E-Filed VAT Return Fails to Submit (UK)

When e-filing fails, Workday populates the
E-File Error Code
 field on the tax declaration to indicate why the submission failed. You can use this information to diagnose and resolve common problems that prevent you from submitting your VAT return.
Cause
Solution
Authorization Required
CLIENT_OR_AGENT_NOT_AUTHORISED
INVALID_CREDENTIALS
invalid_grant
MISSING_CREDENTIALS
Missing Tax ID
UNAUTHORIZED
VRN_INVALID
  1. Access the
    Edit Company Tax Details
     task.
    Configure the
    E-Filing VAT Registration Number
     tax ID type for the United Kingdom.
    Enter the 9-digit numeric VAT number that you registered for Making Tax Digital.
    Security:
    • Set Up: Company General
       domain in the Common Financial Management functional area.
    • Set Up: Tax
       domain in the Common Financial Management functional area.
    • Set Up: Payroll - Company Specific (Accounting)
       domain in the Core Payroll functional area.
  2. Sign in to your UK Government Gateway in your browser.
  3. Select
    Tax Declaration
    Create Replacement
     from the related actions menu of the tax declaration.
    Create and approve a replacement tax declaration.
  4. Select
    Tax Declaration
    Submit HMRC Credentials
     from the related actions menu of the replacement tax declaration.
  5. Select
    Tax Declaration
    Submit E-File
     from the related actions menu of the replacement tax declaration.
INVALID_DATE_FROM
INVALID_DATE_RANGE
INVALID_DATE_TO
MULTIPLE_PERIOD_KEYS
NOT_FOUND
  1. Select
    Tax Declaration
    Correct E-File Errors
     from the related actions menu of the tax declaration.
    Ensure that the date range is for 1 full period starting after 2019-04-01 or, if applicable for your organization, 2019-10-01.
  2. Select
    Tax Declaration
    Submit E-File
     from the related actions menu of the tax declaration.
Missing Period Key - Resubmit E-File
GATEWAY_TIMEOUT
INTERNAL_TIMEOUT_UNABLE_TO_SUBMIT_VAT
SCHEDULED_MAINTENANCE
SERVER_ERROR
  1. Ensure that HMRC isn't undergoing scheduled maintenance.
  2. Select
    Tax Declaration
    Submit E-File
     from the related actions menu of the tax declaration.
  3. (Optional) If the submission fails several times, contact Workday Support.
INTERNAL_SERVER_ERROR
  1. Resubmit the VAT return by selecting
    Tax Declaration
    Submit E-File
     from the related actions menu of the tax declaration.
  2. (Optional) If the issue persists for more than 72 hours, contact the HMRC VAT Online Services Helpdesk.
INTERNAL_TIMEOUT_UNABLE TO VIEW VAT
  1. Access your UK Government Gateway in your browser and check if HMRC received the VAT return.
  2. If the submission was unsuccessful, contact Workday Support.
VAT_NET_VALUE
  1. Access the
    Edit Tax Declaration Component
     task.
    On the component mapped to box 5, select
    Reverse Sign When Result is Negative
    .
  2. Select
    Tax Declaration
    Create Replacement
     from the related actions menu of the tax declaration.
    Create and approve a replacement tax declaration.
  3. Select
    Tax Declaration
    Submit E-File
     from the related actions menu of the tax declaration.
VAT_TOTAL_VALUE
  1. Access the
    Edit Tax Declaration Component
     task.
    Change the component mapped to box 3 to a
    Calculation
    -type component that contains the sum of boxes 1 and 2.
  2. Select
    Tax Declaration
    Create Replacement
     from the related actions menu of the tax declaration.
    Create and approve a replacement tax declaration.
  3. Select
    Tax Declaration
    Submit E-File
     from the related actions menu of the tax declaration.