Parent File Ref - Property-Services
Assessment APIs:
Assessment is a snapshot of Property for a given transaction on that Property. These APIs provide functionalities to create/update/search the assessments. An assessment cannot exist without a property.
Postman Collection:
https://www.getpostman.com/collections/d1a02a29203d110df289
Configs:
Assessment shares most of the configs with Property as mentioned above, only exclusive properties are mentioned in this section.
IDGEN:
assessment id key = pt.assessmentnumber
assessment id format = PB-AS-[cy:yyyy-MM-dd]-[SEQ_EG_PT_ASSM]
KAFKA TOPICS:
save-pt-assessment
update-pt-assessment
Workflow integration can be controlled by the following two properties:
assessment.workflow.enabled=true assessment.workflow.trigger.param=usageCategory,occupancyType,occupancyDate
The first property switches workflow on or off, while the second property provides a way to control which field change can trigger workflow. A businessService needs to be created using the workflow
/egov-workflow-v2/egov-wf/businessservice/_create API .
Sample businessService create API body for Assessment workflow:
{
"RequestInfo": {
"apiId": "Rainmaker",
"action": "",
"did": 1,
"key": "",
"msgId": "20170310130900|en_IN",
"requesterId": "",
"ts": 1513579888683,
"ver": ".01",
"authToken": "b39181b1-5c6b-484a-b825-6be2f62012b8"
},
"BusinessServices": [
{
"tenantId": "pb",
"businessService": "ASMT",
"business": "pt-services",
"businessServiceSla": 172800000,
"states": [
{
"sla": null,
"state": null,
"applicationStatus": null,
"docUploadRequired": false,
"isStartState": true,
"isTerminateState": false,
"isStateUpdatable": true,
"actions": [
{
"action": "INITIATE",
"nextState": "INITIATED",
"roles": [
"CITIZEN",
"PT_CEMP"
]
}
]
},
{
"sla": null,
"state": "INITIATED",
"applicationStatus": "INITIATED",
"docUploadRequired": false,
"isStartState": true,
"isTerminateState": false,
"actions": [
{
"action": "APPLY",
"nextState": "APPLIED",
"roles": [
"CITIZEN",
"PT_CEMP"
]
},
{
"action": "INITIATE",
"nextState": "INITIATED",
"roles": [
"CITIZEN",
"PT_CEMP"
]
}
]
},
{
"sla": null,
"state": "APPLIED",
"applicationStatus": "APPLIED",
"docUploadRequired": false,
"isStartState": false,
"isTerminateState": false,
"isStateUpdatable": true,
"actions": [
{
"action": "FORWARD",
"nextState": "FIELDINSPECTION",
"roles": [
"PT_DOC_VERIFIER"
]
},
{
"action": "REJECT",
"nextState": "REJECTED",
"roles": [
"PT_DOC_VERIFIER"
]
},
{
"action" : "SENDBACKTOCITIZEN",
"nextState" : "INITIATED",
"roles":["PT_DOC_VERIFIER"]
}
]
},
{
"sla": null,
"state": "REJECTED",
"applicationStatus": "REJECTED",
"isStateUpdatable": false,
"docUploadRequired": false,
"isStartState": false,
"isTerminateState": true
},
{
"sla": 86400000,
"state": "FIELDINSPECTION",
"applicationStatus": "FIELDINSPECTION",
"docUploadRequired": false,
"isStartState": false,
"isStateUpdatable": true,
"isTerminateState": false,
"actions": [
{
"action": "FORWARD",
"nextState": "PENDINGAPPROVAL",
"roles": [
"PT_FIELD_INSPECTOR"
]
},
{
"action": "REJECT",
"nextState": "REJECTED",
"roles": [
"PT_FIELD_INSPECTOR"
]
},
{
"action": "SENDBACK",
"nextState": "APPLIED",
"roles": [
"PT_FIELD_INSPECTOR"
]
}
]
},
{
"sla": 43200000,
"state": "PENDINGAPPROVAL",
"applicationStatus": "PENDINGAPPROVAL",
"docUploadRequired": false,
"isStartState": false,
"isStateUpdatable": false,
"isTerminateState": false,
"actions": [
{
"action": "APPROVE",
"nextState": "PENDINGPAYMENT",
"roles": [
"PT_APPROVER"
]
},
{
"action": "REJECT",
"nextState": "REJECTED",
"roles": [
"PT_APPROVER"
]
},
{
"action": "SENDBACK",
"nextState": "FIELDINSPECTION",
"roles": [
"PT_APPROVER"
]
}
]
},
{
"sla": 43200000,
"state": "PENDINGPAYMENT",
"applicationStatus": "PENDINGPAYMENT",
"docUploadRequired": false,
"isStartState": false,
"isTerminateState": false,
"isStateUpdatable": false,
"actions": [
{
"action": "PAY",
"nextState": "APPROVED",
"roles": [
"CITIZEN",
"PT_CEMP",
"SYSTEM_PAYMENT"
]
},
{
"action": "ADHOC",
"nextState": "PENDINGPAYMENT",
"roles": [
"PT_CEMP"
]
}
]
},
{
"sla": null,
"state": "APPROVED",
"applicationStatus": "APPROVED",
"isStateUpdatable": false,
"docUploadRequired": false,
"isStartState": false,
"isTerminateState": true
}
]
}
]
}
Other system level configs are same as PT-Registry as mentioned above.
Notification:
Payment Notification:
{
"code": "PT_NOTIFICATION_PAYMENT_FAIL",
"message": "Dear Citizen, Your payment of Rs. <insert amount to pay> for Property Tax Unique ID <insert ID> has failed. Your assessment is pending. Please try again. Ignore this message if you have completed your payment. You can pay your Property Tax online here - <payLink>",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "PT_NOTIFICATION_PAYMENT_OFFILE",
"message": "Dear Citizen, Your Property Tax payment of Rs. <amount> has been accepted. Mode of Payment: <insert mode of payment> Pending Amount: <Enter pending amount>.",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "PT_NOTIFICATION_PAYMENT_ONLINE",
"message": "Dear Citizen, Your payment of Rs.< insert amount paid> with payment transaction id < insert payment transaction id from PG> has been made successfully. Assessment for Property Tax Unique ID <insert Property Tax Assessment ID> was succesful. Property Tax due is Rs.<pt due>.",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "PT_NOTIFICATION_PAYMENT_PARTIAL_OFFLINE",
"message": "Dear Citizen, Your Property Tax payment of Rs. <amount> has been accepted. Mode of Payment: <insert mode of payment> Pending Amount: <Enter pending amount>. You can pay your Property Tax online here - <payLink>",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "PT_NOTIFICATION_PAYMENT_PARTIAL_ONLINE",
"message": "Dear Citizen, Your payment of Rs.< insert amount paid> with payment transaction id < insert payment transaction id from PG> has been made successfully. Assessment for Property Tax Unique ID <insert ID> was succesful. Property Tax due is Rs.<pt due>. You can pay your Property Tax here - <payLink>",
"module": "rainmaker-pt",
"locale": "en_IN"
}
Assessment Notification:
{
"code": "ASMT_APPLIED",
"message": "Applied",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "ASMT_APPROVED",
"message": "Approved",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "ASMT_CREATE",
"message": "Dear {OWNER_NAME}, Your assessment with {ASSESSMENTNUMBER} for financial year {FINANCIALYEAR} and property id {PROPERTYID} is created.",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "ASMT_UPDATE",
"message": "Dear {OWNER_NAME}, Your assessment with {ASSESSMENTNUMBER} for financial year {FINANCIALYEAR} and property id {PROPERTYID} is reassessed.",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "ASMT_MSG_APPLIED",
"message": "Dear {OWNER_NAME}, Your assessment with {ASSESSMENTNUMBER} for financial year {FINANCIALYEAR} and property id {PROPERTYID} is updated to {STATUS}.",
"module": "rainmaker-pt",
"locale": "en_IN"
},
{
"code": "ASMT_MSG_APPROVED",
"message": "Dear {OWNER_NAME}, Your assessment with {ASSESSMENTNUMBER} for financial year {FINANCIALYEAR} and property id {PROPERTYID} is {STATUS}.",
"module": "rainmaker-pt",
"locale": "en_IN"
}
For adding localization for any status append ASMT_ prefix to the status and for adding a message for any status add ASMT_MSG_ before the status.
Assessment(Property Calculator) -
The calculator service Prepares and property tax and files the demand in the billing service for payment. It has an estimate API to give the estimated property tax without persisting data and a calculate API to create demand for payments.
The calculator service resides in the municipal-services git repo of eGov.
0 Comments