4대보험 공제 재료
payroll_pack__insurance_deduction_material_v1__generateComposite insurance-deduction material v1: combines NHIS, NPS, and COMWEL employment billing notice Jobs, then returns computed insurance deduction material fields. Requires prior session login for 건강보험·국민연금·고용산재. Tax fields remain out of scope. One 고지 (고지년월 + 고지차수) reissued as several NHIS 작성회차 (WRT_CHASU) resolves to the newest revision; rows from different 고지 are never collapsed and stay skipped unless the provider-specific row key disambiguates them. No account_link_id is needed here: each step finds its own institution link. 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goji_round | No | Optional NHIS notice round | |
| nps_row_key | No | Optional NPS row key from pension notice search, used only to disambiguate multiple exact matches | |
| billing_year | Yes | COMWEL billing year in YYYY format | |
| nhis_row_key | No | Optional NHIS row key from premium notice search, used only to disambiguate multiple exact matches | |
| billing_month | Yes | COMWEL billing month 1-12 (string or integer) | |
| output_formats | No | Optional. Also return this result as a file (Excel (xlsx)) in artifacts[] of the result. Omit it for data only. | |
| idempotency_key | No | Optional outer idempotency key; leg keys are derived deterministically from this value. | |
| 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 |