Skip to content

Commit

Permalink
Merge pull request #2 from mashukreza/patch-1
Browse files Browse the repository at this point in the history
Updated content for overview section index.md
  • Loading branch information
jameshforster authored Oct 3, 2019
2 parents 2147319 + 9656ee2 commit a2bab95
Showing 1 changed file with 7 additions and 39 deletions.
46 changes: 7 additions & 39 deletions source/documentation/index.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,20 @@
---
title: VAT (MTD) End-to-End Service Guide
title: Making Tax Digital (MTD) Income Tax end-to-end service guide
weight: 1
description: Software developers, designers, product owners or business analysts. Integrate your software with VAT API for Making Tax Digital.
---

# VAT (MTD) end-to-end service guide
# Making Tax Digital (MTD) Income Tax end-to-end service guide

Version 6.0 issued 6 February 2019
Version 2.0 issued XX August 2019
***

This guide explains how you can integrate your software with our APIs to submit VAT returns under Making Tax Digital for VAT. It shows how the APIs fit into various end-to-end user journeys. It is intended to help software developers, designers, product owners or business analysts understand how your software needs to interact with HMRC systems.

## Overview
<!-- Section owner: MTD Programme -->

VAT (MTD) requires VAT registered businesses with taxable turnover above the VAT registration threshold to:

* keep records in digital form
* file their VAT Returns using software (via our [VAT (MTD) API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/))

The frequency of submitting a VAT Return (annually, quarterly or monthly) does not change under MTD.

For more details see [VAT Notice 700/22](https://www.gov.uk/government/publications/vat-notice-70022-making-tax-digital-for-vat). In particular, [section 7](https://www.gov.uk/government/publications/vat-notice-70022-making-tax-digital-for-vat/vat-notice-70022-making-tax-digital-for-vat#examples-of-where-a-digital-link-is-required) shows the various options for software integration.

## End-to-end user journeys
<!--- Section owner: MTD Programme --->

These journeys show examples of use. Journeys for businesses and agents are broken down into:

* [VAT (MTD) set up activities](documentation/set-up.html#set-up)
* [retrieving VAT (MTD) obligations, submitting returns and paying bills](documentation/obligations.html#obligations-and-returns)
* [paying VAT (MTD) penalties and interest or appealing](documentation/penalties.html#penalties-and-appeals)
* [VAT (MTD) close down activities](documentation/close-down.html#close-down)
This service guide is to help software designers and vendors understand how their software fits in with HMRC APIs.
It covers elements of the service delivered by HMRC to show how the Income Tax end-to-end service works.
Product owners, developers and business analysts can also use this guide to learn more about Making Tax Digital for Income Tax Self Assessment (ITSA).

## Related API documentation
<!--- Section owner: MTD Programme --->

* [VAT (MTD) REST API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0)
* [VAT (MTD) Income Tax REST API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api?filter=income-tax)
* [Create Test User API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/api-platform-test-user/1.0)

## Changelog
<!--- Section owner: MTD Programme --->

### Version 6.0

6 February 2019

What changed:

* [Added documentation for Retrieve VAT liabilities endpoint](documentation/obligations.html#view-vat-liabilities)
* [Added documentation for Retrieve VAT payments endpoint](documentation/obligations.html#view-vat-payments)

0 comments on commit a2bab95

Please sign in to comment.