Guidance for Using the Test Services
Total Page:16
File Type:pdf, Size:1020Kb
Revenue Scotland - Guidance for Using the Test Services Document Ref A10658012 Version 1.0 Date 19/03/2015 Status Published Revenue Scotland - Guidance for Using the Test Services Table of Contents 1 Introduction ............................................................................................................................................ 1 2 Using the Test Service ............................................................................................................................. 2 3 References and Terminology .................................................................................................................. 4 3.1 References ...................................................................................................................................... 4 3.2 Terminology And Abbreviations ..................................................................................................... 4 4 Document Control .................................................................................................................................. 5 Ref: A10658012, Version: 1.0 Page i Published Revenue Scotland - Guidance for Using the Test Services 1 Introduction The Scotland Act 2012 provided the Scottish Parliament with the powers to introduce devolved taxes. In his statement to the Scottish Parliament of June 2012, the Cabinet Secretary for Finance, Employment and Sustainable Growth confirmed that he intended to introduce two new taxes to replace revenues that would otherwise be lost when the UK taxes cease to apply in Scotland. Land and Buildings Transactions Tax (LBTT) will replace Stamp Duty Land Tax (SDLT) and Scottish Landfill Tax (SLfT) will replace UK Landfill Tax (LfT). He announced that Revenue Scotland would be established to administer the new taxes, working in partnership with Registers of Scotland (RoS) on LBTT and the Scottish Environment Protection Agency (SEPA) for SLfT. The new taxes are expected to take effect from 1 April 2015 and because they are designed for Scotland, are aligned with Scots law and practice. A new IT system, called the Scottish Electronic Tax System (SETS), is being delivered to support the collection and administration of LBTT and SLfT. It will provide access to Revenue Scotland, Registers of Scotland and the Scottish Environmental Protection Agency in order to administer tax collection and will allow access to taxpayers and their agents to file their tax returns and make payments. In addition to the services that allow taxpayers and agents to enter tax returns, SETS will provide an Application Programming Interface (API) that will allow third party packages to submit LBTT returns via a web service. Revenue Scotland will also make a test version of the API available to allow software developers to test their products. This document provides a guidance to developers on how to use the test service. Ref: A10658012, Version: 1.0 Page 1 Published Revenue Scotland - Guidance for Using the Test Services 2 Using the Test Service Ref. [1] describes the use of the live web service for LBTT submissions. This is designed to allow taxpayers and agents to submit tax returns. The test service conforms to the same basic design with some necessary key differences. The key elements are: User Registration: Third party application developers must register with Revenue Scotland in order to use the test service. They should do this by emailing [email protected], stating o Name of User o Organisation o Email Address of the contact in the organisation o IP address from which submissions will be received Authentication: On receipt of the above information, Revenue Scotland will create a user on the test service for the organisation, generate a web service security token for the organisation and send it to the email address provided above. Developers should include the user ID and this token in their test submissions as specified in ref. [1] Web service url: Developers should use the following url to make test submissions. https://test.revenue.scot/rs98/LBTTSubmissionService?wsdl Service provided: The test service will accept LBTT returns as xml documents. It will apply the defined validation to the document and respond with success or error messages as appropriate. Test Service Availability: Revenue Scotland will normally make the test service available 24 hours per day. Any exceptions to this will be published on Revenue Scotland’s website (https://www.revenue.scot/help/third-party-vendors). Test Service Management: The test service is a transitory environment and will be cleared down periodically, primarily for security reasons. Developers should not rely on data being persisted in the test service. There are a number of caveats associated with the test service: 1. This is a service for functional testing. It is not intended to support volume or performance testing. 2. The test service is not implemented in a high availability configuration. 3. Revenue Scotland does not offer any expressed or implied service level agreements with this test service. Ref: A10658012, Version: 1.0 Page 2 Published Revenue Scotland - Guidance for Using the Test Services APPENDICES Ref: A10658012, Version: 1.0 Page 3 Published Revenue Scotland - Guidance for Using the Test Services 3 References and Terminology 3.1 References Doc Ref Version [1] Web Service Specification for LBTT Submissions from 3rd Party Software Packages. 1.04 Available from Revenue Scotland’s website (https://www.revenue.scot/help/third- party-vendors) 3.2 Terminology And Abbreviations Term Explanation IP Internet Protocol LBTT Devolved Tax: Land and Buildings Transaction Tax – replacing SDLT in Scotland, to be administered by Revenue Scotland LBTT Act Legislation: Land and Buildings Transaction Tax (Scotland) Act 2013 http://www.legislation.gov.uk/asp/2013/11/pdfs/asp_20130011_en.pdf Revenue Tax Authority: Revenue Scotland Scotland RS Tax Authority: Revenue Scotland RSTPA Legislation: Revenue Scotland Tax Powers Act http://www.scottish.parliament.uk/parliamentarybusiness/Bills/70929.aspx Scotland Act Legislation: Scotland Act 2012 2012 SETS The Scottish Electronic Tax System SG Scottish Government SLfT Devolved Tax: Scottish Landfill Tax – replacing LFT in Scotland, to be administered by Revenue Scotland SLfT Act Legislation: Landfill Tax (Scotland) Act 2014 http://www.legislation.gov.uk/asp/2014/2/pdfs/asp_20140002_en.pdf url Uniform resource locator, a reference to a resource that specifies the location of the resource on a computer network and a mechanism for retrieving it. Ref: A10658012, Version: 1.0 Page 4 Published Revenue Scotland - Guidance for Using the Test Services 4 Document Control Version Date Author Comments 0.1 19-Mar-2015 Revenue Scotland First draft. 0.2 19-Mar-2015 Revenue Scotland Final draft, ready for publication. 1.0 19-Mar-2015 Revenue Scotland Baselined for publication Ref: A10658012, Version: 1.0 Page 5 Published .