One-time social insurance payment (BHXH một lần)
bhxh_lump_sumEstimate the one-time social insurance payment in Vietnam: 1.5 months of the average insurance salary for each year of contributions before 2014 and 2 months for each year from 2014; leftover months round to half or a full year; under one year it is the amount contributed, capped at 2 months of the average. Pass salary_history (years with monthly insurance salary; each year is indexed with the published BHXH coefficients) or an already indexed average_salary with months_before_2014 and months_from_2014. Eligibility is not checked. Examples: {"salary_history":[{"year":2012,"monthly_salary":5000000},{"year":2013,"monthly_salary":6000000},{"year":2025,"monthly_salary":15000000,"months":7}],"as_of":"2026-09"}; {"average_salary":12000000,"months_before_2014":30,"months_from_2014":50}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "bhxh_lump_sum"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date. | |
| as_of | No | Date of the social insurance agency's decision: YYYY-MM (first day of that month) or YYYY-MM-DD. Default: today in Vietnam. Supported from 2026-01; earlier dates are rejected. | |
| month | No | Synonym of as_of (same formats: YYYY-MM or YYYY-MM-DD). Pass only one of as_of, month, date. | |
| average_salary | No | Alternative to salary_history: average monthly insurance salary, ALREADY indexed with the adjustment coefficients. | |
| salary_history | No | Simple list of years: {year, monthly_salary, months (default 12)}. Each year is indexed with the published adjustment coefficient; months before 2014 and from 2014 are counted from the years. | |
| months_from_2014 | No | With average_salary: months of contributions from 2014 on. | |
| contributed_amount | No | Under one year of contributions only: the amount actually contributed; if omitted it is estimated at 22% of the salaries. | |
| months_before_2014 | No | With average_salary: months of contributions before 2014. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| case | Yes | ||
| as_of | Yes | ||
| notes | Yes | ||
| amount | Yes | ||
| sources | Yes | ||
| disclaimer | Yes | ||
| data_version | Yes | ||
| average_salary | Yes |