Allows users to view their tax credits information and perform a renewal.
The following services are exposed from the micro-service.
Please note it is mandatory to supply an Accept HTTP header to all below services with the value application/vnd.hmrc.1.0+json.
- Run locally:
sbt runwhich runs on port8246by default - Run with test endpoints:
sbt 'run -Dplay.http.router=testOnlyDoNotUseInAppConf.Routes'
The service can be run locally from Service Manager, using the following profiles:
| Profile Details | Command |
|---|---|
| MOBILE_TAX_CREDITS_ALL | sm2 --start MOBILE_TAX_CREDITS_ALL --appendArgs '{"MOBILE_TAX_CREDITS_SUMMARY": ["-Dmicroservice.reportActualProfitPeriod.endDate=2030-01-31T10:00:00.000", "-DdateOverride=2020-08-15", "-Dmicroservice.renewals.startDate=2021-04-26T07:00:00.000", "-Dmicroservice.renewals.packReceivedDate=2021-06-04T17:00:00.000", "-Dmicroservice.renewals.endDate=2030-07-31T17:00:00.000", "-Dmicroservice.renewals.gracePeriodEndDate=2030-08-07T22:59:59.000", "-Dmicroservice.renewals.endViewRenewalsDate=2030-11-30T23:59:59.000"]}' |
- Run Unit Tests:
sbt test - Run Integration Tests:
sbt it:test - Run Unit and Integration Tests:
sbt test it:test - Run Unit and Integration Tests with coverage report:
sbt clean compile coverage test it:test coverageReport dependencyUpdates
| Task | Supported Methods | Description |
|---|---|---|
/income/:nino/tax-credits/tax-credits-summary |
GET | Fetch the Tax Credits Summary object for a given NINO. More... |
All the above endpoints are accessible on sandbox with /sandbox prefix on each endpoint,e.g.
GET /sandbox/income/:nino/tax-credits/tax-credits-summary
To trigger the sandbox endpoints locally, use the "X-MOBILE-USER-ID" header with one of the following values: 208606423740 or 167927702220
To test different scenarios, add a header "SANDBOX-CONTROL" with one of the following values:
| Value | Description |
|---|---|
| "TAX-CREDITS-USER" | Happy path, non-excluded Tax Credits User with full summary |
| "WORKING-TAX-CREDIT-ONLY" | Happy path, non-excluded Tax Credits User with working tax credit data but no child tax credit data |
| "CHILD-TAX-CREDIT-ONLY" | Happy path, non-excluded Tax Credits User with child tax credit data but no working tax credit data |
| "NON-TAX-CREDITS-USER" | Happy path, non-excluded, Non Tax Credits User with no summary |
| "EXCLUDED-TAX-CREDITS-USER" | Happy path, excluded Tax Credits User with no summary |
| "PXP5" | Happy path, where PXP5 period is open to calculate new tax credits rates |
| "OLD-RATE" | Happy path, before the PXP5 period |
| "NEW-RATE" | Happy path, after the PXP5 period |
| "PAYMENTS-NOT-ENABLED" | Happy path, when user has no payments |
| "CLAIMANTS-FAILURE" | Unhappy path, non-excluded Tax Credits User with partial summary missing claimants section |
| "ERROR-401" | Unhappy path, trigger a 401 Unauthorized response |
| "ERROR-403" | Unhappy path, trigger a 403 Forbidden response |
| "ERROR-500" | Unhappy path, trigger a 500 Internal Server Error response |
| Not set or any other value | Happy path, non-excluded Tax Credits Users |
To start the service locally either use service-manager or clone this repo and use sbt to start:
cd $WORKSPACE/mobile-tax-credits-summary
sbt start
Once its running then to test the default behaviour (non-excluded Tax Credits Users payload):
curl -i -H"Accept: application/vnd.hmrc.1.0+json" localhost:8246/sandbox/income/CS700100A/tax-credits/tax-credits-summary
For more information, visit Confluence and see the following page:
/display/NGC/How+to+shutter+NGC+apis
API definition for the service will be available under /api/definition endpoint.
See definition in /conf/api-definition.json for the format.