개발자 문서
서비스 소개키 관리자격증명 등록OpenAPI콘솔
API 레퍼런스

지방소득세 특별징수 - 위택스

이 쪽의 모든 작업에 해당

  • 이 작업은 샌드박스를 지원하지 않습니다. 샌드박스로 보내면 거절되므로 데모나 정식 환경으로 호출합니다.

1. 지방소득세 특별징수 신고 세액 저장wetax.tax.local_income.special_withholding.adjustment_save

MCP 도구 이름 wetax__tax__local_income__special_withholding__adjustment_save

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

특별징수 신고의 세액 조정 내역을 저장합니다. 과세표준과 산출세액에 더해 기환급,이월환급,추가납부와 가산세, 조정 구분을 담아 최종 납부할 세액을 맞춥니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.adjustment_save이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.adjustment_save

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
tax_base_amountnumberY과세표준 합계입니다. 대상 저장 결과의 합계와 같은 값을 넣고, 다르면 저장하지 않습니다
calculated_tax_amountnumberY산출세액 합계입니다. 대상 저장 결과의 합계와 같은 값을 넣고, 다르면 저장하지 않습니다
previous_refund_amountnumberN당월 기타 환급액입니다. 없으면 보내지 않아도 되고 0 으로 들어갑니다

예시 : 0

carryover_refund_amountnumberN중도 퇴사자 환급액입니다. 없으면 보내지 않아도 되고 0 으로 들어갑니다

예시 : 0

additional_payment_amountnumberN추가 납부액입니다. 없으면 보내지 않아도 되고 0 으로 들어갑니다

예시 : 0

adjustment_kind_codestringN조정 구분 코드입니다. 받기만 하고 신고에 저장하지 않는 칸이라 보내지 않아도 됩니다

예시 : 1

adjustment_amountnumberN조정 금액입니다. 받기만 하고 신고에 저장하지 않는 칸이라 보내지 않아도 됩니다

예시 : 0

penalty_tax_amountnumberN가산세입니다. 받기만 하고 신고에 저장하지 않는 칸이라 보내지 않아도 됩니다

예시 : 0

remarkstringN비고입니다. 필요할 때만 넣고 최대 1000자입니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-adjustment_save-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.adjustment_save",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>",
    "tax_base_amount": "<필수: number>",
    "calculated_tax_amount": "<필수: number>",
    "previous_refund_amount": 0,
    "carryover_refund_amount": 0,
    "additional_payment_amount": 0,
    "adjustment_kind_code": "1",
    "adjustment_amount": 0,
    "penalty_tax_amount": 0
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 과세표준, 산출세액, 기환급액, 이월환급액, 추가납부액, 조정 구분 코드, 조정 금액, 가산세, 비고, 저장 결과

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.adjustment_save",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

2. 지방소득세 특별징수 신고 취소wetax.tax.local_income.special_withholding.cancel

MCP 도구 이름 wetax__tax__local_income__special_withholding__cancel

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

제출한 특별징수 신고를 취소합니다. 취소한 신고는 되살릴 수 없고 필요하면 다시 신고해야 하므로, 취소 사유와 취소,법적 효력 두 가지 명시 확인을 함께 보내야 실행됩니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.cancel이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.cancel

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
cancel_reasonstringY취소 사유입니다. 1자에서 100자까지 받고 앞뒤 공백은 지우며, 공백뿐이면 거절합니다
confirm_cancelbooleanY취소하겠다는 확인으로 true 를 보냅니다. true 가 아니면 거절합니다
confirm_legal_effectbooleanY취소한 신고는 되살릴 수 없고 필요하면 다시 신고해야 한다는 점을 확인하는 뜻으로 true 를 보냅니다. true 가 아니면 거절합니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-cancel-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.cancel",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>",
    "cancel_reason": "<필수>",
    "confirm_cancel": "<필수: boolean>",
    "confirm_legal_effect": "<필수: boolean>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 취소 사유, 명시 확인 둘(취소,법적 효력), 취소 결과

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.cancel",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

3. 지방소득세 특별징수 신고인 저장wetax.tax.local_income.special_withholding.declarant_save

MCP 도구 이름 wetax__tax__local_income__special_withholding__declarant_save

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

특별징수 신고의 신고인(대표자) 정보를 저장하면서 위택스에 작성 중인 신고서를 만들고 신고 식별자를 받습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.declarant_save이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.declarant_save

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
taxpayer_business_nostringY신고하는 사업장의 사업자등록번호입니다. 붙임표 없이 숫자 10자리만 넣고, 그 밖의 모양은 거절합니다
jurisdiction_codestringY관할 지방자치단체 코드입니다. 신고 시작 단계가 사업장 정보에서 읽어 알려 준 값을 그대로 넣습니다
representative_kindstringN신고인 구분 코드입니다. 보내지 않으면 01 로 넣습니다

예시 : 01

representative_namestringN신고인 성명입니다. 회원 정보와 같음(same_as_member_info)이 true 이면 보내지 않아도 되고, false 로 보내면 이 값으로 저장합니다
representative_phonestringN신고인 전화번호입니다. 회원 정보와 같음(same_as_member_info)이 true 이면 보내지 않아도 되고, false 로 보내면 이 값으로 저장합니다
representative_mobilestringN신고인 휴대전화번호입니다. 회원 정보와 같음(same_as_member_info)이 true 이면 보내지 않아도 되고, false 로 보내면 이 값으로 저장합니다
representative_emailstringN신고인 이메일입니다. 회원 정보와 같음(same_as_member_info)이 true 이면 보내지 않아도 되고, false 로 보내면 이 값으로 저장합니다
same_as_member_infobooleanN회원 정보와 같음 여부입니다. true 이면 로그인한 회원 정보의 연락처를 그대로 쓰고, 보내지 않으면 true 입니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-declarant_save-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.declarant_save",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "taxpayer_business_no": "<필수>",
    "jurisdiction_code": "<필수>",
    "representative_kind": "01"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 연동 식별자, 사업자등록번호, 관할 지자체 코드, 대표자 구분, 대표자 성명, 대표자 전화, 대표자 휴대전화, 대표자 이메일, 회원정보 동일 여부, 신고 식별자, 저장 결과

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.declarant_save",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

4. 지방소득세 특별징수 신고 시작wetax.tax.local_income.special_withholding.init

MCP 도구 이름 wetax__tax__local_income__special_withholding__init

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

특별징수 신고를 쓰기 전에, 로그인한 사업장이 신고할 수 있는지와 신고할 사업장 정보를 확인합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.init이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.init

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

추가 파라미터가 없습니다. params 는 {} 로 보냅니다.

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-init-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.init",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • 이 API 가 돌려주는 데이터: 연동 식별자, 신고 가능 여부, 사업장 목록(사업자등록번호 일부 가림, 상호, 관할 지자체 코드), 저장 단계별 입력 항목, 막힌 사유

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.init",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

5. 지방소득세 특별징수 납부 상태 조회wetax.tax.local_income.special_withholding.payment_status

MCP 도구 이름 wetax__tax__local_income__special_withholding__payment_status

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

제출한 특별징수 신고의 납부 상태를 조회합니다. 신고 식별자로 세액과 납부 여부를 받으며, 조회 전용이라 납부를 실행하지는 않습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.payment_status이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.payment_status

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-payment_status-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.payment_status",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 납부할 금액, 납부 여부, 납부용 가상계좌 건수, 신고 상태

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.payment_status",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

6. 지방소득세 특별징수 신고 검토wetax.tax.local_income.special_withholding.review

MCP 도구 이름 wetax__tax__local_income__special_withholding__review

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

제출 전에 작성한 특별징수 신고를 검토합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.review이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.review

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-review-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.review",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 신고 상태, 귀속 연월, 지급 연월, 과세표준, 산출세액, 납부할 금액, 현재 단계

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.review",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

7. 지방소득세 특별징수 신고 이력 조회wetax.tax.local_income.special_withholding.search_history

MCP 도구 이름 wetax__tax__local_income__special_withholding__search_history

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

특별징수 신고 이력을 기간으로 조회합니다. 조회 시작일과 종료일, 신고 상태로 거르고 페이지로 나눠 받으며, 조회 전용이라 신고를 바꾸지 않습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.search_history이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.search_history

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입길이필수설명
start_datestring10Y조회 시작일입니다. YYYY-MM-DD 형식입니다

형식 : YYYY-MM-DD

end_datestring10Y조회 종료일입니다. YYYY-MM-DD 형식이고 시작일과 같거나 뒤여야 합니다

형식 : YYYY-MM-DD

filing_statusstring-N신고 상태 코드로 걸러 조회합니다. 보내지 않으면 거르지 않고, 기관이 지금 쓰는 상태 코드가 아니면 거절합니다
pagenumber-N페이지 번호입니다. 1부터 세며 보내지 않으면 1 입니다

예시 : 1

page_sizenumber-N한 페이지에 받을 줄 수입니다. 1에서 100 사이이고 보내지 않으면 20 입니다

예시 : 20

output_formatsarray-N이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-search_history-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.search_history",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "start_date": "<필수>",
    "end_date": "<필수>",
    "page": 1,
    "page_size": 20
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 조회 시작일, 조회 종료일, 신고 상태(선택), 페이지, 페이지 크기, 신고 이력 목록

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.search_history",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

8. 지방소득세 특별징수 신고 명세 저장wetax.tax.local_income.special_withholding.statement_save

MCP 도구 이름 wetax__tax__local_income__special_withholding__statement_save

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

특별징수 신고의 소득자별 명세를 저장합니다. 명세는 선택이라 줄 없이 보내면 명세 없이 다음 단계로 넘어가고, 줄을 담으면 소득자별 지급,세액 내역을 함께 저장합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.statement_save이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.statement_save

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
statement_rowsarrayN소득자별로 한 줄씩 넣는 목록입니다. 명세는 선택이라 줄을 하나도 보내지 않으면 명세 없이 다음 단계로 넘어갑니다. 줄을 보낼 때는 소득 종류 코드(income_type_code), 지급일(payment_date), 소득자 성명(payee_name), 소득자 식별번호(payee_identifier), 과세표준(tax_base_amount), 산출세액(calculated_tax_amount), 조정 환급액(adjustment_amount), 납부액(payment_amount)을 보내고, 모든 줄의 과세표준 합계와 산출세액 합계가 저장된 신고의 합계와 같아야 합니다. 소득 종류와 성명, 식별번호가 모두 같은 줄을 두 번 넣지 않습니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-statement_save-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.statement_save",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 명세 줄(선택): 소득 구분 코드,지급일,소득자 성명,소득자 식별자,과세표준,산출세액,조정 금액,지급액, 저장 결과

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.statement_save",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

9. 지방소득세 특별징수 신고 제출wetax.tax.local_income.special_withholding.submit

MCP 도구 이름 wetax__tax__local_income__special_withholding__submit

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

검토를 마친 특별징수 신고를 기관에 제출합니다. 실제 신고라 되돌리려면 취소해야 하므로, 제출,금액 검토,법적 효력 세 가지를 명시로 확인해야 실행됩니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.submit이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.submit

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
confirm_submitbooleanY제출하겠다는 확인으로 true 를 보냅니다. true 가 아니면 거절합니다
confirm_amounts_reviewedbooleanY제출 전에 검토 결과로 금액과 대상자를 확인했다는 뜻으로 true 를 보냅니다. true 가 아니면 거절합니다
confirm_legal_effectbooleanY제출한 신고에 법적 효력이 있다는 점을 확인하는 뜻으로 true 를 보냅니다. true 가 아니면 거절합니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-submit-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.submit",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>",
    "confirm_submit": "<필수: boolean>",
    "confirm_amounts_reviewed": "<필수: boolean>",
    "confirm_legal_effect": "<필수: boolean>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 명시 확인 셋(제출,금액 검토,법적 효력), 제출 결과

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.submit",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

10. 지방소득세 특별징수 신고 대상 저장wetax.tax.local_income.special_withholding.target_save

MCP 도구 이름 wetax__tax__local_income__special_withholding__target_save

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

데모입니다. 실제 기관에 접속하며 가입한 날부터 30일 동안 사용자 기준 하루 10 사용 토큰까지 호출할 수 있습니다(KST 0시 초기화).

특별징수 신고의 과세 대상과 소득 종류별 내역을 저장합니다. 귀속,납부 연월과 소득 종류별 인원,과세표준,징수 지방소득세를 담으며, 납부지연 일수는 비우면 기관 계산을 그대로 씁니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • sandbox샌드박스 — 이 작업은 지원하지 않습니다
  • real_test데모 — 하루 10 사용 토큰
  • production정식 — 스탠다드, PRO 또는 멀티계정 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • wetax이 API 고정값 (기본값)

예시 : wetax

actionstring-Y호출할 작업입니다.
  • wetax.tax.local_income.special_withholding.target_save이 API 고정값 (기본값)

예시 : wetax.tax.local_income.special_withholding.target_save

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
dclr_idstringY신고 식별자입니다. 신고인 저장이 돌려준 값을 그대로 넣습니다
filing_cyclestringN신고 주기입니다. 매월 신고(monthly)만 받으며, 보내지 않으면 monthly 입니다

예시 : monthly

attribution_year_monthstringY소득이 귀속되는 연월입니다. 202608 처럼 여섯 자리로 넣고, 지급 연월보다 늦을 수 없습니다
payment_year_monthstringY소득을 지급한 연월입니다. 202609 처럼 여섯 자리로 넣습니다
late_payment_day_countnumberN납부 지연 일수입니다. 보내지 않으면 기관이 계산한 날수를 쓰고, 보내면 그 날수와 같은지 확인해 다르면 저장하지 않습니다
income_rowsarrayY소득 종류별로 한 줄씩 넣는 목록입니다. 줄은 1개에서 12개까지이고 같은 소득 종류를 두 줄에 쓰지 않습니다. 줄마다 소득 종류 코드(income_type_code), 인원(headcount), 과세표준(tax_base_amount), 특별징수 세액(withheld_local_income_tax)을 보냅니다. 인원은 과세표준이 0 보다 크면 1 이상이어야 하고, 특별징수 세액은 10원 미만을 버리고 저장합니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header 'Idempotency-Key: demo-target_save-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "wetax",
  "action": "wetax.tax.local_income.special_withholding.target_save",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "dclr_id": "<필수>",
    "filing_cycle": "monthly",
    "attribution_year_month": "<필수>",
    "payment_year_month": "<필수>",
    "income_rows": "<필수: array>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 신고 식별자, 신고 주기(월), 귀속 연월, 납부 연월, 납부지연 일수(선택), 소득 종류별 줄(소득 구분 코드,인원,과세표준,징수 지방소득세), 저장 결과

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "wetax",
    "action": "wetax.tax.local_income.special_withholding.target_save",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}