eChallan Calculator Services

Overview

eChallan Calculator service is used to calculate the echallan amount based on the details present in echallan request. This module is designed in such way that it can be used to serve echallan for different type of service.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

• Java 8

• Kafka server is up and running.

• PSQL server is running and database is created to store eChallan Calculator Application data.

• Following services should be up and running:

  • egov-mdms

  • echallan-services

  • billing-service

Key Functionalities

• echallan service internally call echallan-calculator to generate a demand.

• Based on the taxhead and tax amount defined in echallan request, echallan calculator service create the demand.

• After Demand creation, it call billing service to generate the fees.

Configuration Details

MDMS Config:

Define the tax period in the below mdms file for the business service which are allowed in echallan service.

https://github.com/egovernments/egov-mdms-data/blob/DEV/data/pb/BillingService/TaxPeriod.json

Define the taxhead in the below mdms file for the business service which are allowed in echallan service.

https://github.com/egovernments/egov-mdms-data/blob/DEV/data/pb/BillingService/TaxHeadMaster.json

Define the action and role action mapping for the API’s in the below mdms files.

https://github.com/egovernments/egov-mdms-data/blob/DEV/data/pb/ACCESSCONTROL-ACTIONS-TEST/actions-test.json

Deployment Details

1. Add mdms configs required for eChallan Service and calculator and restart mdms service.

2. Deploy the latest version of eChallan Service and calculator.

3. Add eChallan Service persister yaml path in persister configuration and restart persister service

4. Add Role-Action mapping for API’s.

Integration

Integration Scope

echallan-calculator will be integrated with echallan-services. echallan-services internally invoke the echallan-calculator service to calculate and generate demand for the echallan request.

Integration Benefits

eChallan calculator application is used to calculate the eChallan Fees based on the data mentioned in echallan creation. Based on tax amount mentioned in echallan, demand is created.  So because of eChallan calculator the calculation and demand generation logic will be separate out from eChallan services.
So in future, if calculation logic need to modify then changes can be carry out for each implementation without modifying the eChallan services.

Steps to Integration

eChallan service application need to call echallan-calculator/v1/_calculate API to calculate and generate the demand for the eChallan application.

Interaction Diagram

TBD

Reference Docs

Doc Links

API List