VAT Filer for agents- How to send to and retrieve data from HMRC

Article ID: 2871
Last updated: 03 May, 2023

What are APIs?

HMRC have provided a method of obtaining information relevant to VAT Returns called Application Program Interfaces or APIs. This is the second part of their overall Digital transformation project known as Making Tax Digital (MTD).

What data can be requested from HMRC?

This article will help you to use the HMRC APIs to obtain information direct from HMRC. Please click here to find out what information you will receive from HMRC.

Prerequisites for using the APIs

The following details must be completed to ensure that information can be submitted and obtained from HMRC for VAT Returns:

  • VAT Registration Number
  • The client must have a current live VAT registration with HMRC. This means HMRC are expecting a VAT Return
  • Authorisation lodged with HMRC for VAT services
  • Authorised to use the MTD Service

Step 1 - Authorising TaxCalc to interact with HMRC - Agents

The first step is to authorise TaxCalc to interact with HMRC. This is a process that effectively links TaxCalc (with you as an agent) to HMRC. Please follow the steps below to authorise the software:

  1. Open TaxCalc and select Admin Centre
  2. Click on Applications and double click on VAT Filer
  3. Click on HMRC API Token Management and New Token
  4. Click the Authorise button for Check and submit MTD VAT data for your clients

  1. Then click Continue
  2. Enter the user ID and password you created when you set up your Agent Services Account.
  3. Click on Grant Authority and TaxCalc should be authorised.
  4. Then click Finish

Step 2: Fetching VAT periods from HMRC

Once you have authorised TaxCalc, open VAT Filer then select the client and click the Fetch VAT Periods button

The following screen will be displayed:

Enter the From and To date for the period you wish to fetch VAT periods as shown above and click Search.

The VAT periods will get displayed as shown below:

Please note: If you select a fulfilled VAT period, the VAT figures that were submitted for that VAT return period should get displayed in the area with the heading 'Fulfilled Return Data'. TaxCalc fetches the VAT figures of the fulfilled VAT return period. You can view this data by selecting that VAT return period on the Select VAT Returns/EC Sales List dialog and clicking Open. Please be aware that changes should not be made to a fulfilled VAT Return

Click Fetch. You will then be taken to the Select VAT Return/EC Sales List window where you can see the VAT periods listed as shown below:

Select the VAT period with an Open status and click Open. You should now be able to complete this VAT return and file it via the MTD service.

VAT periods can also be created manually before using the Fetch process but the period dates have to match the periods that HMRC hold for the business, for the period to file successfully. Once the Fetch process is completed, the periods will be validated and any mismatch with HMRC records will be shown via a message returned.

Payments and Liabilities:

You can also retrieve Payments and Liabilities using APIs.

Go to Client Information > Payment & Liabilities 

Click on the Retrieve Payments/Liabilities button. You will see the following screen:

Enter the From and To date for the period you wish to retrieve the information and click Fetch.

The payments that were made or refunded and any outstanding liabilities post enrolling for the MTD service will get displayed in the table on Payments & Liabilities page

Article ID: 2871
Last updated: 03 May, 2023
Revision: 11
Views: 3390
This article was:  

Also read
item Where do I enter Filing Credentials for VAT Filer?
item What information is available from HMRC APIs for VAT?