Skip to content

hmrc/business-customer-frontend

Repository files navigation

business-customer-frontend

Build Status Download

This frontend microservice is used to register a UK/Non-UK client (SA/Organisation) or agent to ETMP (creating business partner record) and enrol in Government Gateway. This renders common set of pages with texts based on the service using it.

The services which uses business-customer-frontend are:

  • ATED - Annual Tax on Enveloped Dwellings
  • AWRS - The Alcohol Wholesaler Registration Scheme
  • AMLS - Anti Money Laundering Supervision

Usage

Add your service name in the list inside application.conf

microservice {
  services {

    names = [ated, amls, awrs]

and, make appropriate changes as necessary

 awrs {
      serviceRedirectUrl: "http://localhost:9913/alcohol-wholesale-scheme"
    }
    amls {
      serviceRedirectUrl: "http://localhost:9222/anti-money-laundering"
    }

where,

Property Description
serviceRedirectUrl page uri that agent or client would land when it leaves the service

Other important files to be modified/used:

messages
BCUtils.scala
*Spec.scala (as per use)

Please run test and test coverage before raising a PR.

APIs used

Property Description
/clear-cache/:service Used to clear the cache from another service, usually used after user has subscribed to their particular service
/fetch-review-details/:service Used to retrieve review details returned from ETMP after registering to ETMP

Note - Remember to use the partials header carrier for frontend to frontend calls

Requirements

This service is written in Scala and Play, so needs the latest JRE to run.

Authentication

Authentication is via Government Gateway

Acronyms

In the context of this service we use the following acronyms:

  • API: Application Programming Interface

  • HoD: Head of Duty

  • JRE: Java Runtime Environment

  • JSON: JavaScript Object Notation

  • URL: Uniform Resource Locator

License

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