This is a Scala/Play frontend to allow Limited Companies to provide their information to HMRC.
-
Make sure any dependent services are running using the following service-manager command
sm --start INCORPORATED_ENTITY_IDENTIFICATION_ALL -r
-
Stop the frontend in service manager using
sm --stop INCORPORATED_ENTITY_IDENTIFICATION_FRONTEND
-
Run the frontend locally using
sbt 'run 9718 -Dapplication.router=testOnlyDoNotUseInAppConf.Routes'
Creates a new journey, storing the journeyConfig against the journeyId.
Request body must contain the continueUrl and deskProServiceId fields. If nothing is provided for the optional service name, Entity Validation Service
will be used.
{
"continueUrl" : "/testUrl",
"optServiceName" : "Service Name",
"deskProServiceId" : "DeskProServiceId",
}
Status: Created(201)
Example Response body:
{“journeyStartUrl” : "/testUrl"}
Retrieves all the journey data that is stored against a specific journeyID.
A valid journeyId must be sent in the URI
Status:
Expected Response | Reason |
---|---|
OK(200) |
JourneyId exists |
NOT_FOUND(404) |
JourneyId doesn't exist |
Example response body:
{"companyProfile":
{"companyName":"TestCompanyLtd”,
“companyNumber":"01234567",
"dateOfIncorporation":"2020-01-01",
"unsanitisedCHROAddress":
{"address_line_1":"testLine1",
"address_line_2":"test town",
"care_of":"test name",
"country":"United Kingdom",
"locality":"test city",
"po_box":"123",
"postal_code":"AA11AA",
"premises":"1",
"region":"test region"
}
},
"ctutr":"1234567890",
"identifiersMatch":true,
"businessVerification":
{"verificationStatus":"PASS"},
"registration":
{"registrationStatus":"REGISTERED",
"registeredBusinessPartnerId":"X00000123456789"}
}
Shows all feature switches:
-
Incorporated Entity Identification Frontend
- Companies House API stub
- Business Verification Stub
-
Incorporated Entity Identification
- Get CT reference stub
- DES stub
This is a test entry point which simulates a service making the initial call to setup a journey.
-
ContinueURL(Required)
- Where to redirect the user after the journey has been completed
-
Service Name (Optional)
- Service Name to use throughout the service
- If nothing is entered,
Entity Validation Service
will be used
Stubs retrieving the Company Profile from Companies House. The Companies House API stub feature switch will need to be enabled.
A valid company Number must be sent in the URI
Status:
Expected Response | Reason | Example |
---|---|---|
OK(200) |
Company Number exists |
Any other valid Company Number |
NOT_FOUND(404) |
Company Number doesn't exist |
"00000001" |
Example response body:
{"companyProfile":
{"companyName":"TestCompanyLtd”,
“companyNumber":"01234567",
"dateOfIncorporation":"2020-01-01",
"unsanitisedCHROAddress":
{"address_line_1":"testLine1",
"address_line_2":"test town",
"care_of":"test name",
"country":"United Kingdom",
"locality":"test city",
"po_box":"123",
"postal_code":"AA11AA",
"premises":"1",
"region":"test region"
}
}
Retrieves all the journey data that is stored against a specific journeyID.
A valid journeyId must be sent in the URI
Status:
Expected Response | Reason |
---|---|
OK(200) |
JourneyId exists |
NOT_FOUND(404) |
JourneyId doesn't exist |
Example response body:
{"companyProfile":
{"companyName":"TestCompanyLtd”,
“companyNumber":"01234567",
"dateOfIncorporation":"2020-01-01",
"unsanitisedCHROAddress":
{"address_line_1":"testLine1",
"address_line_2":"test town",
"care_of":"test name",
"country":"United Kingdom",
"locality":"test city",
"po_box":"123",
"postal_code":"AA11AA",
"premises":"1",
"region":"test region"
}
},
"ctutr":"1234567890",
"identifiersMatch":true,
"businessVerification":
{"verificationStatus":"PASS"},
"registration":
{"registrationStatus":"REGISTERED",
"registeredBusinessPartnerId":"X00000123456789"}
}
Stubs creating a Business Verification journey. The Business Verification Stub Feature Switch will need to be enabled.
No body is required for this request
Status: Created(201)
Example Response body:
{“redirectUri” : "/testUrl?journeyId=<businessVerificationJourneyId>"}
Stubs retrieving the result from the Business Verification Service. The Business Verification Stub feature switch will need to be enabled.
A valid Business Verification journeyId must be sent in the URI
Status: OK(200)
Example Response body:
{"journeyType": "BUSINESS_VERIFICATION",
"origin": vat,
"identifier": {
"ctUtr" -> "1234567890"
},
"verificationStatus" -> "PASS"
This code is open source software licensed under the Apache 2.0 License.