ioss-returns

This is the repository for Import One Stop Shop Returns Backend

Frontend: https://github.com/hmrc/ioss-returns-frontend

Stub: https://github.com/hmrc/ioss-returns-stub

For more details on the Import One Stop Shop Returns service, including how to use the application, please refer to the instructions in the ioss-returns-frontend repository.

Requirements

This service is written in Scala and Play, so needs at least a [JRE] to run.

Run the application locally via Service Manager

sm2 --start IMPORT_ONE_STOP_SHOP_ALL

To run the application locally from the repository, execute the following:

sm2 --stop IOSS_RETURNS

and

sbt run -Dapplication.router=testOnlyDoNotUseInAppConf.Routes

Running correct version of mongo

Mongo 6 with a replica set is required to run the service. Please refer to the MDTP Handbook for instructions on how to run this

Unit and Integration Tests

To run the unit and integration tests, you will need to open an sbt session on the browser.

Unit Tests

To run all tests, run the following command in your sbt session:

test

To run a single test, run the following command in your sbt session:

testOnly <package>.<SpecName>

An asterisk can be used as a wildcard character without having to enter the package, as per the example below:

testOnly *ReturnControllerSpec

Integration Tests

To run all tests, run the following command in your sbt session:

it:test

To run a single test, run the following command in your sbt session:

it:testOnly <package>.<SpecName>

An asterisk can be used as a wildcard character without having to enter the package, as per the example below:

it:testOnly *ExternalEntryRepositorySpec

License

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