ated-subscription

Annual Tax for Enveloped Dwellings Subscription microservice

Build Status

This service provides the ability for UK-based or Non-UK based ATED clients (or agents on behalf of clients) to subscribe to ATED service on ETMP. They must be registered to ETMP as per the ROSM pattern.

Subscribe to ATED

The request must be a valid json for below uri

PATH Supported Methods Description
/org/:org/subscribe POST subscribe to ATED
/agent/:ac/subscribe POST subscribe a NON-UK based client to ATED via agent

where,

Parameter Message
org Org-Id
ac AgentCode

Example of usage for individual or Agent

POST /org/123456789/subscribe

POST /agent/123456789/subscribe

Request body

{
"acknowledgmentReference": "12345678901234567890123456789012",
"safeId": "XE0001234567890",
"address": [
  {
    "name1": "Joe",
    "name2": "bloggs",
    "addressDetails": {
      "addressType": "Correspondence",
      "addressLine1": "address-line-1",
      "addressLine2": "address-line-2",
      "addressLine3": "address-line-3",
      "addressLine4": "Newcastle",
      "postalCode": "AB1 4CD",
      "countryCode": "GB"
    },
    "contactDetails": {
      "telephone": "01234567890",
      "eMailAddress": "[email protected]"
    }
  }
]
}

Response

Status Message
200 Ok
400 Bad Request
404 Not Found
500 Internal Server Error
503 Service Unavailable
{
 "processingDate":"2001-12-17T09:30:47Z",
 "atedRefNumber": "XY1234567890123",
 "formBundleNumber": "123456789012345"
}
Parameter Message
atedRefNumber ATED subsciption id for client generated when subscribed

All tests and checks

sbt runAllChecks

This is an sbt command alias specific to this project. It will run

  • unit tests
  • integration tests
  • and produce a coverage report.

You can view the coverage report in the browser by pasting the generated url.

Installing sbt plugin to check for library updates.

To check for dependency updates locally you will need to create this file locally ~/.sbt/1.0/plugins/sbt-updates.sbt and paste - addSbtPlugin("com.timushev.sbt" % "sbt-updates" % "0.6.3") - into the file. Then run:

sbt dependencyUpdates

To view library update suggestions - this does not cover sbt plugins. It is not advised to install the plugin for the project.

License

This code is open source software licensed under the Apache 2.0 License.