API 문서
급여 1회분의 원천징수액 계산
한 급여 기간의 연방 소득세(IRS Pub 15-T Worksheet 1A)와 캘리포니아주 소득세(EDD Method B) 원천징수액을 계산합니다. 각 행에 참조한 사실의 버전과 공식 문서의 해당 쪽을 표시합니다. 직원 데이터는 저장하지 않습니다.
REST: POST /v1/payroll/calculate MCP 도구: payroll_calculate API 키 필요
거절 코드
- input_invalid (400) The request does not match the action’s input schema.
- parameter_missing (400) A parameter the computation needs was not given.
- jurisdiction_unsupported (422) This tax or jurisdiction is not covered yet.
- table_not_effective (422) No reviewed fact is in force for this pay date.
- key_missing (401) This action needs an API key (Authorization: Bearer <key>).
- key_invalid (401) The API key is unknown, revoked or expired.
- rate_limited (429) Too many requests from this client; slow down.
- trial_exhausted (402) The trial key has used all of its included calls.
- quota_exhausted (402) The plan’s calls for this month are used; a larger plan or the next month opens more.
- plan_excludes_action (403) The account’s plan does not include this action.
입력 (JSON Schema)
{
"type": "object",
"properties": {
"pay_date": {
"type": "string",
"format": "date"
},
"pay_frequency": {
"enum": [
"daily",
"weekly",
"biweekly",
"semimonthly",
"monthly",
"quarterly",
"semiannual",
"annual"
],
"type": "string"
},
"gross": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$"
},
"taxes": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"const": "us_fit"
},
"w4": {
"type": "object",
"properties": {
"filing_status": {
"enum": [
"single",
"married_filing_jointly",
"head_of_household"
],
"type": "string"
},
"step2_checkbox": {
"type": "boolean",
"default": false
},
"step3_credits": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"default": "0"
},
"step4a_other_income": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"default": "0"
},
"step4b_deductions": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"default": "0"
},
"step4c_extra_withholding": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"default": "0"
},
"exempt": {
"type": "boolean",
"default": false
}
},
"required": [
"filing_status"
]
}
},
"required": [
"kind"
]
},
{
"type": "object",
"properties": {
"kind": {
"const": "us_ca_pit"
},
"de4": {
"type": "object",
"properties": {
"filing_status": {
"enum": [
"single",
"married",
"head_of_household"
],
"type": "string"
},
"regular_allowances": {
"type": "integer",
"minimum": 0,
"maximum": 99,
"default": 0
},
"estimated_deduction_allowances": {
"type": "integer",
"minimum": 0,
"maximum": 99,
"default": 0
},
"additional_withholding": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?$",
"default": "0"
},
"exempt": {
"type": "boolean",
"default": false
}
},
"required": [
"filing_status"
]
},
"method": {
"enum": [
"annualized",
"period_table"
],
"type": "string",
"default": "annualized"
}
},
"required": [
"kind"
]
}
]
},
"minItems": 1,
"maxItems": 10
}
},
"required": [
"pay_date",
"pay_frequency",
"gross",
"taxes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}