Skip to content

NASWA-OpenUI/monetary-determination-api

Repository files navigation

monetary-determination-api

API to calculate monetary determination. This is just a prototype and should not be used to represent current policy or regulation.

Get started

Make sure you have python3 and fastapi installed.

From the project directory, run

fastapi dev main.py

The server will be started at http://127.0.0.1:8000

API Docs in the form of OpenAPI (formerly Swagger) UI will be at http://127.0.0.1:8000/docs

Notes

This prototype will add complexity in an iterative fashion. The first goal is to get to a simple weekly benefit amount (WBA) for a first benefit year for a claimant with wages from a single state. After that we will might add the following more complex functionality:

  • check qualification (hqw, bp, hq, wba, bpw, aaw)
  • calculate WBA for second benefit year
  • calculate max beefit entitlement
  • calculate duration
  • calculate partial / earnings disregard
  • seasonal work - this looks cokmplicated
  • add dependents' allowance - this may get complicated because things like dependent age matter
  • calculate combined waged claim - claim for wages from multiple states
  • automatic adjustment to WBA - some states adjust WBA based on state average wage

The prototype assumes that the wage information provided is correct. It does not do verification and or look at previous claim history. It doesn't care about employers, and it assumes that the wage information passed in the query is a sum of all wages from all employers for the given quarter. It does not care about any wages already "used" in another claim. It also takes a simplistic view of the base period and assumes that the base period has been pre-calculated. It does not care about extended base periods. Some of these things, e.g. wage verification, can happen further upstream in a separate component/microservice. Some states have a waiting period before claimant can receive the WBA, but that is not relevant to this calculator.

Determination endpoint output

# Base period used, both the relevant dates and the type of base period it was
# // What wages/hours were used to calculate the benefits in that claim, and whether there was any cancellation of wage credits
# // Which employer(s) is or are liable or responsible for the benefits in that claim
# Weekly benefit amount. all states round the WBA to an even dollar amount but do this with different logic (e.g. round to nearest number or highest number). 
# Maximum payable amount
# Benefit year, whether a date range or separate start date and end date fields
# Date of determination
# calculator version number, so you can tell what logic was used when a speciic claim was issued

About

API to calculate monetary determination

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages