From b21e1ff01674e31b9084991b35b9d0264981597f Mon Sep 17 00:00:00 2001 From: mickschonhut <33155491+mickschonhut@users.noreply.github.com> Date: Wed, 2 Jan 2019 12:36:57 +0000 Subject: [PATCH 1/6] Update obligations.html.md --- source/documentation/obligations.html.md | 36 +++++++++++++++++------- 1 file changed, 26 insertions(+), 10 deletions(-) diff --git a/source/documentation/obligations.html.md b/source/documentation/obligations.html.md index 2e69f18..a15fd7b 100644 --- a/source/documentation/obligations.html.md +++ b/source/documentation/obligations.html.md @@ -15,10 +15,11 @@ alt="Agent active process diagram" border="1px"; style="width:520px;" /> Open the agent process flow process diagram for obligations and returns in a new tab. 1. [Agent receives client's obligations and submits a VAT return](#receive-obligations-and-submit-a-vat-return) -2. [Agent amends client's VAT return](#amend-a-vat-return) -3. [Agent pays client's VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) -4. [Agent notifies client’s change of circumstances](#notify-a-change-of-circumstances) -5. [Client views their future obligations and previous returns in their Business Tax Account (BTA)](#view-future-obligations-and-previous-returns) +2. Agent views client's [VAT liabilities](#view-vat-liabilities) or [VAT payments](#view-vat-payments) +3. [Agent amends client's VAT return](#amend-a-vat-return) +4. [Agent pays client's VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) +5. [Agent notifies client’s change of circumstances](#notify-a-change-of-circumstances) +6. [Client views their future obligations and previous returns in their Business Tax Account (BTA)](#view-future-obligations-and-previous-returns) ## Business journey overview @@ -30,10 +31,11 @@ alt="Business active process diagram" border="1px"; style="width:520px;" /> Open the business process flow process diagram for obligations and returns in a new tab. 1. [Business receives obligations and submits VAT Return](#receive-obligations-and-submit-a-vat-return) -2. [Business amends a VAT Return](#amend-a-vat-return) -3. [Business pays a VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) -4. [Business notifies a change of circumstances](#notify-a-change-of-circumstances) -5. [Business views future obligations and previous returns in its Business Tax Account (BTA)](#view-future-obligations-and-previous-returns) +2. Business views its [VAT liabilities](#view-vat-liabilities) or [VAT payments](#view-vat-payments) +3. [Business amends a VAT Return](#amend-a-vat-return) +4. [Business pays a VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) +5. [Business notifies a change of circumstances](#notify-a-change-of-circumstances) +6. [Business views future obligations and previous returns in its Business Tax Account (BTA)](#view-future-obligations-and-previous-returns) ## Receive obligations and submit a VAT Return @@ -48,7 +50,7 @@ Your software should use the [VAT (MTD) API](https://developer.service.hmrc.gov. ### Retrieve obligations in software -The [Retrieve VAT obligations endpoint](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0#_retrieve-vat-obligations_get_accordion) allows software to search for obligations based on a start and end date range and an obligation status - O for open, F for fulfilled, or blank for both. +The [Retrieve VAT obligations endpoint](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0#_retrieve-vat-obligations_get_accordion) allows your software to search for obligations based on a start and end date range and an obligation status - O for open, F for fulfilled, or blank for both. If the status is: @@ -127,12 +129,26 @@ We require your software to show your businesses or agents a declaration that th Your software can retrieve returns submitted up to four years previously using the VAT (MTD) API: -1. Find the period key for the VAT Return you wish to retrieve, using the retrieve [VAT obligations endpoint](/docs/api/service/vat-api/1.0#_retrieve-vat-obligations_get_accordion) (/organisations/vat/{vrn}/obligations) with the status field set to F to see all fulfilled obligations within a date range, or left blank to see both open and fulfilled obligations. +1. Find the period key for the VAT Return you wish to retrieve, using the [Retrieve VAT obligations endpoint](/docs/api/service/vat-api/1.0#_retrieve-vat-obligations_get_accordion) (/organisations/vat/{vrn}/obligations) with the status field set to F to see all fulfilled obligations within a date range, or left blank to see both open and fulfilled obligations. 2. Use the period key with the view [VAT Returns endpoint](/docs/api/service/vat-api/1.0#_view-vat-return_get_accordion) (/organisations/vat/{vrn}/returns/{periodKey}) to retrieve the required VAT Return. Your software cannot retrieve returns filed before business or agents joined VAT (MTD) through the VAT (MTD) API. +## View VAT liabilities + +Your software can retrieve VAT liabilities by calling the VAT (MTD) API [Retrieve VAT liabilities endpoint](/docs/api/service/vat-api/1.0#_retrieve-vat-liabilities_get_accordion), which returns the liabilities and charges whose To date falls in the requested date range (of up to one year). + +The response includes the charge type of the liability, the original amount, and if applicable the outstanding amount owing and the due date for payment. + +## View VAT payments + +Your software can retrieve VAT payments by calling the VAT (MTD) API [Retrieve VAT payments endpoint](/docs/api/service/vat-api/1.0#_retrieve-vat-payments_get_accordion), which returns payments that have been used to offset liabilities whose To date falls in the requested date range (of up to one year). + +The response includes the amount allocated to a liability and, when available, the date it was received. + +It is not yet possible to return links between payments and liabilities + ## Amend a VAT Return We would like software developers to give businesses and agents the option to make VAT payments at key points in their journey. From 005b7486ee1545066bda0f99a8aa8e1df974c532 Mon Sep 17 00:00:00 2001 From: mickschonhut <33155491+mickschonhut@users.noreply.github.com> Date: Wed, 2 Jan 2019 13:33:22 +0000 Subject: [PATCH 2/6] Update obligations.html.md --- source/documentation/obligations.html.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/source/documentation/obligations.html.md b/source/documentation/obligations.html.md index a15fd7b..aa52f9f 100644 --- a/source/documentation/obligations.html.md +++ b/source/documentation/obligations.html.md @@ -15,11 +15,12 @@ alt="Agent active process diagram" border="1px"; style="width:520px;" /> Open the agent process flow process diagram for obligations and returns in a new tab. 1. [Agent receives client's obligations and submits a VAT return](#receive-obligations-and-submit-a-vat-return) -2. Agent views client's [VAT liabilities](#view-vat-liabilities) or [VAT payments](#view-vat-payments) -3. [Agent amends client's VAT return](#amend-a-vat-return) -4. [Agent pays client's VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) -5. [Agent notifies client’s change of circumstances](#notify-a-change-of-circumstances) -6. [Client views their future obligations and previous returns in their Business Tax Account (BTA)](#view-future-obligations-and-previous-returns) +2. [Agent views client's VAT liabilities](#view-vat-liabilities) +3. [Agent views client's VAT payments](#view-vat-payments) +4. [Agent amends client's VAT return](#amend-a-vat-return) +5. [Agent pays client's VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) +6. [Agent notifies client’s change of circumstances](#notify-a-change-of-circumstances) +7. [Client views their future obligations and previous returns in their Business Tax Account (BTA)](#view-future-obligations-and-previous-returns) ## Business journey overview @@ -31,7 +32,8 @@ alt="Business active process diagram" border="1px"; style="width:520px;" /> Open the business process flow process diagram for obligations and returns in a new tab. 1. [Business receives obligations and submits VAT Return](#receive-obligations-and-submit-a-vat-return) -2. Business views its [VAT liabilities](#view-vat-liabilities) or [VAT payments](#view-vat-payments) +2. [Business views its VAT liabilities](#view-vat-liabilities) +3. [Business views its VAT payments](#view-vat-payments) 3. [Business amends a VAT Return](#amend-a-vat-return) 4. [Business pays a VAT bill or receives a repayment](#pay-vat-or-get-a-repayment) 5. [Business notifies a change of circumstances](#notify-a-change-of-circumstances) From b916fa3a0ab7ffa082b280b5cb30a191ddd5bb5d Mon Sep 17 00:00:00 2001 From: mickschonhut <33155491+mickschonhut@users.noreply.github.com> Date: Wed, 2 Jan 2019 14:59:40 +0000 Subject: [PATCH 3/6] Update obligations.html.md --- source/documentation/obligations.html.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/source/documentation/obligations.html.md b/source/documentation/obligations.html.md index aa52f9f..bc35648 100644 --- a/source/documentation/obligations.html.md +++ b/source/documentation/obligations.html.md @@ -137,6 +137,8 @@ Your software can retrieve returns submitted up to four years previously using t Your software cannot retrieve returns filed before business or agents joined VAT (MTD) through the VAT (MTD) API. +Businesses can also view their previously submitted VAT Returns in their Business Tax Account. + ## View VAT liabilities Your software can retrieve VAT liabilities by calling the VAT (MTD) API [Retrieve VAT liabilities endpoint](/docs/api/service/vat-api/1.0#_retrieve-vat-liabilities_get_accordion), which returns the liabilities and charges whose To date falls in the requested date range (of up to one year). @@ -206,11 +208,13 @@ We encourage you to remind businesses to check and update their details with us. They can do this by visiting their Business Tax Account at [https://www.tax.service.gov.uk/account](https://www.tax.service.gov.uk/account). -Businesses can update a range of information, including addresses, telephone numbers, e-mail and business type. +Businesses can update a range of information online which includes email address, principle place of business, VAT return dates, repayment bank account details and deregistering from VAT. + +Agents who have signed up to MTD and also have a client who is signed up, can [notify a change of circumstances](https://www.tax.service.gov.uk/gg/sign-in?continue=%2Fvat-through-software%2Faccount%2Fchange-business-details&origin=manage-vat-subscription-frontend). Until VAT (MTD) goes into Live service there will be a manual process in place whereby a business or agent can contact us directly for a manual change to be made to their details. -Functionality will be available for businesses or agents to make the most regular changes - with more functionality being added up until Go Live early 2019. +Functionality will be available for businesses or agents to make the most regular changes - with more functionality being added after April 2019. ## View future obligations and previous returns From 0bb43011f904146377e5853d6a6f636fd5f52116 Mon Sep 17 00:00:00 2001 From: mickschonhut <33155491+mickschonhut@users.noreply.github.com> Date: Wed, 2 Jan 2019 15:25:19 +0000 Subject: [PATCH 4/6] Update set-up.html.md --- source/documentation/set-up.html.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/documentation/set-up.html.md b/source/documentation/set-up.html.md index cddf630..0d0da04 100644 --- a/source/documentation/set-up.html.md +++ b/source/documentation/set-up.html.md @@ -128,7 +128,7 @@ Once an agent has linked a client to their agent services account, they can sign 5. Agent gives client's email address to HMRC 6. Client receives verification email and verifies their email address 7. Agent agrees to terms of participation for self and client -8. Agent waits 24 hours to see if client is approved to sign up +8. Agent waits 72 hours to see if client is approved to sign up We will develop supporting content that allows a business to identify whether they need to: @@ -152,7 +152,7 @@ Businesses can sign themselves up for VAT (MTD) whether or not they use an agent 5. Business gives HMRC its business type and other business information 6. Business agrees to receive emails and gives and verifies its email address 7. Business agrees to the terms of participation -8. Business waits 24 hours to see if it is approved to sign up +8. Business waits 72 hours to see if it is approved to sign up
This video explains the step-by-step process for a business to sign up to VAT (MTD). From 5b37276d25255ba591c9c6370a760a7f48e3e6d7 Mon Sep 17 00:00:00 2001 From: mickschonhut <33155491+mickschonhut@users.noreply.github.com> Date: Wed, 2 Jan 2019 16:07:14 +0000 Subject: [PATCH 5/6] Update obligations.html.md --- source/documentation/obligations.html.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/documentation/obligations.html.md b/source/documentation/obligations.html.md index bc35648..6a8239f 100644 --- a/source/documentation/obligations.html.md +++ b/source/documentation/obligations.html.md @@ -69,7 +69,7 @@ Notes: * VAT (MTD) will support more business types throughout Controlled Go Live. As they are supported, this endpoint will return obligation information for businesses that are on monthly, annual and other non-standard staggers. * The obligations are returned with the most up to date obligation first. As the next obligation is created at the beginning of the period, it is likely that the period you are trying to file against could be provided second (see example). * Period keys should not be shown to the business or agent, these are for software use to ensure the return is recorded against the correct obligation. -* When checking if an obligation is fulfilled following a submission it can take xxxxx for the obligation to be marked as fulfilled in backend systems. +* When checking if an obligation is fulfilled following a submission it can take around 5 seconds for the obligation to be marked as fulfilled in backend systems. ### Example period keys for stagger types @@ -225,7 +225,7 @@ We encourage software developers to include these features within their products From April 2018, if a business has volunteered for the pilot and signed up for VAT (MTD), they will have the option to use and view information within their BTA. This will include information such as: viewing their return, payment obligations and the option to link off from their BTA and make an online card payment. -Agents must use third party software to view their client’s future obligations and previous returns. This software will call the [Retrieve VAT obligations](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0#_retrieve-vat-obligations_get_accordion) and [View VAT Return API endpoints](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0#_view-vat-return_get_accordion) to provide this information. +Agents must use your software to view their client’s future obligations and previous returns. Your software must call the [Retrieve VAT obligations](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0#_retrieve-vat-obligations_get_accordion) and [View VAT Return API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0#_view-vat-return_get_accordion) endpoints to provide this information. Future obligations process diagram From cedd30c78bd7416131a45431e6e3ac0c3c0ada92 Mon Sep 17 00:00:00 2001 From: mickschonhut <33155491+mickschonhut@users.noreply.github.com> Date: Wed, 2 Jan 2019 16:45:37 +0000 Subject: [PATCH 6/6] Update close-down.html.md --- source/documentation/close-down.html.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/documentation/close-down.html.md b/source/documentation/close-down.html.md index d98f6f1..24d6b91 100644 --- a/source/documentation/close-down.html.md +++ b/source/documentation/close-down.html.md @@ -15,25 +15,25 @@ alt="Agent closedown process diagram" border="1px"; style="width:520px;" /> Open the agent close down process diagram in a new tab. -1. [Agent arranges for client to leave VAT (MTD)](#leave-vat-mtd) +1. [Agent arranges for client to unsubscribe from VAT (MTD)](#unsubscribe-from-vat-mtd) 1. [Client or agent ends relationship](#client-or-agent-ends-relationship) 2. [Agent leaves agent services](#agent-leaves-agent-services) ## Business overview -Businesses can leave VAT (MTD). +Businesses unsubscribes from VAT (MTD). Business closedown process diagram Open the business close down process diagram in a new tab. -1. [Voluntary business leaves VAT (MTD)](#leave-vat-mtd) +1. [Business unsubscribes from VAT (MTD)](#unsubscribe-from-vat-mtd) -## Leave VAT (MTD) +## Unsubscribe from VAT (MTD) -Businesses who signed up for VAT (MTD) on a voluntary basis can request to leave VAT (MTD). +Businesses who signed up for VAT (MTD) on a voluntary basis can request to unsubscribe from VAT (MTD). Initially there is a manual process in place whereby a business or agent can contact our HMRC helpline to notify us they wish to unsubscribe from the service.