PSPCL iFix Adapter

Overview

Pspcl iFix Adapter is a java standalone application, which will be running as cron job to fetch the bills and payments from PSPCL system and reconcile the same. And finally publish them to iFix core system.

Version

Current version : 1.0.0

Prerequisites

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

Java 8
Postgres DB should be up and running

Features

pspcl-ifix-adapter fetches the pspcl bills and payments from PSPCL system based on account number that is mapped in MDMS (can be found in https://github.com/misdwss/mdms-mgramseva/blob/QA/data/pb/pspcl-integration/accountNumberGpMapping.json ). Once will get the bills and payments, below steps are there to reconcile and publish to the iFix Core system.

Sort the pspcl bills and payments results based on 'BILL_ISSUE_DATE' and 'TXNDATE' respectively.
Get the latest that is 0th index bill and payment result And check - is it reconciled already or not ?
if reconciled already stop the reconciliation.
if not reconciled , calculate the current bill (since in the pspcl bill result, we are getting all the accumulated bills together). And this calculated bill will become the 'actual current bill' of the current month.
1. Calculated bill = (Curr_Bill - Last_Bill + Last_Payment).
2. Curr_Bill : This is the pspcl bill that we get in the sorted 0th index pspcl bill result.
3. Last_Bill : Will get this bill based 'DATE_READING_PREV' date.
4. Last_Payment : Will pick up the record from the payment detail table with 'TXNDATE' as range from 'DATE_READING_PREV' & 'Current time'. And then finally sort and take the latest payment TXNDATE as Last_Payment record.
Save a copy of pspcl bill (note that , in this bill , we are not saving the calculated bill ) and payment in DB.
Publish the bill and payment as event type 'Demand' and 'Receipt' respectively with calculated actual bill and payment amount to the iFix Core system.
Log the success or failure fiscal events to the DB.

Interaction Diagram

Environment

Below are the list of environment variables :

Key	Description
pspcl.fetch.bill.url	PSPCL fetch bill url. e.g : `https://billapp.pspcl.in//fetchbillingdata.asmx`
pspcl.fetch.payment.url	PSPCL fetch payment url. e.g : `https://billapp.pspcl.in//fetchbillingdata.asmx`
ifix.host	Fiscal event host address for specific environment. e.g : `https://ifix-qa.ifix.org.in`
egov.mdms.host	MDMS host address for specific environment. `e.g : https://mgramseva-qa.egov.org.in`
keycloak.host	Keycloak host address for specific address. `e.g : https://ifix-qa.ifix.org.in`
keycloak.credentials.clientid	Keycloak client id of pspcl-ifix-adapter. `e.g : pspcl-ifix-qa`
keycloak.credentials.clientsecret	Keycloak client secret of pspcl-ifix-adapter.
fiscal.event.tenantId	Fiscal event tenant id. e.g : ‘pb’
demand.coaCode	Chart of account code for ‘DEMAND’ event. e.g : `8247-12-373-56-78-90`
receipt.coaCode	Chart of account code for ‘RECEIPT’ event. e.g : `8247-12-373-56-78-90`
fiscal.event.receiver	mGramSeva keycloak client id e.g : `mgramseva-qa`
aspect.enabled	Mark it as ‘false', if don’t want to log the PSPCL fetch bills and payments time.

Configurations and Setup

Update all the configuration in the dev.yaml, qa.yml, prod.yaml file.