Merge pull request #14 from hmrc/v6-uplift-continued

V6 uplift continued

source/documentation/close-down.html.md

@@ -15,25 +15,25 @@ alt="Agent closedown process diagram" border="1px"; style="width:520px;" />
 
 <a href="figures/agent-closedown.png" target="blank">Open the agent close down process diagram in a new tab</a>.
 
-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).
 
 <img src="figures/business-closedown.png"
 alt="Business closedown process diagram" border="1px"; style="width:520px;" />
 
 <a href="figures/business-closedown.png" target="blank">Open the business close down process diagram in a new tab</a>.
 
-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.
 

source/documentation/obligations.html.md

@@ -15,10 +15,12 @@ alt="Agent active process diagram" border="1px"; style="width:520px;" /></a>
 <a href="figures/agent-active.png" target="blank">Open the agent process flow process diagram for obligations and returns in a new tab</a>.
 
 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) 
+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
 
@@ -30,10 +32,12 @@ alt="Business active process diagram" border="1px"; style="width:520px;" /></a>
 <a href="figures/business-active.png" target="blank">Open the business process flow process diagram for obligations and returns in a new tab</a>.
 
 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) 
+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)
+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 +52,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:
 
@@ -65,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
 
@@ -127,12 +131,28 @@ 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.
 
+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).
+
+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.
@@ -188,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
 
@@ -203,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.
 
 <img src="figures/future-obligations.png" alt="Future obligations process diagram" border="1px"; style="width:520px;" />
 

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
 
 <br>
 This video explains the step-by-step process for a business to sign up to VAT (MTD).