Knowledgebase Support HMRC Useful links
Knowledgebase home
Tax Return Production
Accounts Production
Client Hub
Practice Management
VAT Filer
CloudConnect
Anti-Money Laundering
Support home
Hot Topics
SimpleStep Guides
Release Notes
Technical
Known Issues

HMRC Status
Useful Links
MTD for Agents MTD for Businesses What is MTD
Preparation
Agent Services Account
MTD for VAT
MTD for Income Tax
MTD for VAT
Digital Record Keeping
Quarterly Updates
Step-by-step Guide
HMRC's MTD Timeline
TaxCalc's MTD Journey

Accountancy Practices and Tax Advisors
PRACTICE MANAGEMENT
Practice Management
Client Hub
Companies House Integration


PRACTICE COMPLIANCE
AML Centre
NEW

AML Identity Checking
GDPR Centre  
COMPLIANCE SERVICES
TAXATION AND HMRC
Tax Return Production
Vat Filer

FINANCIAL REPORTING
Accounts Production

COMPANY SECRETARIAL
Company Incorporator
Companies House Forms
COMMUNICATION MANAGEMENT
eSign Centre


SERVICES
CloudConnect

How to use HMRC VAT APIs

Article ID: 2871
Last updated: 15 Nov, 2018

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.  If you are unsure what this is or require more information, please click here.
  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.

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: 15 Nov, 2018
Revision: 9
Views: 757
This article was: