Skip to content

hmrc/ated-subscription

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

222 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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": "aa@aa.com"
    }
  }
]
}

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.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages