4대보험 공제 재료
payroll_pack__insurance_deduction_material_v1__generateComposite insurance-deduction material v1: combines NHIS, NPS, and COMWEL employment billing notice steps, then returns computed premium totals. The amounts are institution-notice totals billed to the workplace, including BOTH employee and employer portions (employment insurance is the unemployment-benefit portion only); they are NOT the employee payroll-deduction amounts, so compute the employee share separately. Requires prior session login for 건강보험·국민연금·고용산재. To also get income_tax_won and local_income_tax_won from the simplified withholding-tax table, pass employees[] (monthly_pay_won and dependent_count per row) or monthly_pay_won with dependent_count for one employee; without them the tax fields stay in missing_fields. One 고지 (고지년월 + 고지차수) reissued as several NHIS 작성회차 (WRT_CHASU) resolves to the newest revision. When no row key or filter narrows the search to one 고지, each summary uses the newest 고지 of its provider (latest 고지년월, then latest round within it); a tie, or a row whose age cannot be read, stays skipped unless the provider-specific row key disambiguates it. No account_link_id is needed here: each step finds its own institution link. When you combine employee rows from several institutions, treat two rows as the same employee only when BOTH the name and the workplace match; never use a resident registration number (even partial or masked) as the matching key; if two people share a name, do not merge them automatically - ask the user for a distinguishing detail such as the hire date or the institution's employee number; keep an employee found at only one institution and show that institution's amount on its own. If computed is null the result could not be assembled: read computed_error for the reason and do not present the result as complete. Two shapes carry that case: this envelope with partial set to true (we fetched everything - the legs hold it - but could not calculate), or an error whose data carries the same envelope. partial is true whenever the result is incomplete, whether a leg failed or the calculation did. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works for 15 minutes; each file is kept for 7 days. If a link has expired, call xdata__job__result with the pack_run_id from the result for fresh links. For an anonymous result, keep its private recovery_receipt and send it with the original job_id or pack_run_id to xdata__job__result. It grants access to that result only, until the original file retention expires. Do not publish it. Losing it cannot be repaired by signing up. The receipt also works if the client later signs in; it does not grant access to other results. Without a receipt, results require the original account and lane. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"notice_year_month": "<notice_year_month>",
"installment_round": "<installment_round>",
"billing_year": "<billing_year>",
"billing_month": "<billing_month>"
},
"name": "payroll_pack__insurance_deduction_material_v1__generate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| employees | No | Optional. One row per employee with monthly_pay_won and dependent_count (children_count_8_to_20 optional, employee_key / employee_name optional labels). When given, the result adds the table income tax and local income tax summed over the rows; without any tax input those fields stay in missing_fields. To tax a single employee, pass monthly_pay_won and dependent_count at the top level instead. | |
| goji_round | No | Optional NHIS notice round | |
| nps_row_key | No | Optional NPS row key from pension notice search. Without it the newest notice is used; pass it to summarize an older notice or to settle a tie between equally new notices | |
| billing_year | Yes | COMWEL billing year in YYYY format | |
| nhis_row_key | No | Optional NHIS row key from premium notice search. Without it the newest notice is used; pass it to summarize an older notice or to settle a tie between equally new notices | |
| billing_month | Yes | COMWEL billing month 1-12 (string or integer) | |
| output_formats | No | 선택 입력입니다. 결과를 엑셀(xlsx) 파일로도 받으려면 입력해 주세요. 파일은 결과의 artifacts[] 에 실립니다. 비워 두면 데이터만 받습니다. | |
| dependent_count | No | ADR-069 D-4: >=1 includes self; never invent | |
| idempotency_key | No | Optional outer idempotency key; leg keys are derived deterministically from this value. | |
| monthly_pay_won | No | Canonical monthly pay / gross (ADR-069). Wins over monthly_salary_won when both are set. | |
| nhis_document_id | No | NHIS summary document: BMBB_030=regular, BMBB_050=adjusted | BMBB_030 |
| installment_round | Yes | NPS installment round: 1=ED02, 2=ED08 | |
| notice_year_month | Yes | Target notice year-month in YYYYMM format | |
| business_management_no | No | Optional COMWEL business management number; defaults to the logged-in workplace | |
| children_count_8_to_20 | No | ADR-069 D-4: >=0; omit → 0 when monthly pay + dependent_count present |