Back to Details

national-pension-workplace

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

국민연금 가입 사업장 내역 조회

国民年金加入企业明细查询

What this skill does

本Skill的功能

공공데이터포털의 국민연금공단_국민연금 가입 사업장 내역 서비스(data.go.kr 3046071, V2)를 
k-skill-proxy
경유로 호출해 다음을 조회한다.
  • 가입 사업장 후보: 사업장명 + 사업자번호 앞 6자리로 매칭된 사업장 목록 (자료생성년월별 중복은 사업장당 최신 월로 정리)
  • 단일 사업장이 특정되면 상세: 가입자수(
    jnngpCnt
    ), 당월 고지금액(
    crrmmNtcAmt
    ), 신규취득/상실 인원
  • 월별 가입 현황 시계열
사업자등록번호는 앞 6자리만 공개(뒷자리 마스킹)되므로 사업장명이 필수이며, 후보가 여럿이면 특정하지 않고 목록 그대로 돌려준다.
通过
k-skill-proxy
调用公共数据门户的国民年金公团_国民年金加入企业明细服务(data.go.kr 3046071, V2)，查询以下信息：
  • 加入企业候选列表：匹配企业名称+营业执照号码前6位的企业列表（按数据生成年月去重，保留每个企业的最新月份数据）
  • 确定单个企业后查看详情：参保人数(
    jnngpCnt
    )、当月通知金额(
    crrmmNtcAmt
    )、新增/减员人数
  • 月度参保情况时间序列
营业执照号码仅公开前6位（后几位掩码处理），因此企业名称为必填项；若存在多个候选企业，则直接返回候选列表，不做特定筛选。

Design principles

设计原则

  • 점수·등급·"위험" 같은 해석 라벨을 만들지 않는다. upstream이 돌려준 사실만 담는다.
  • 후보가 여럿이면 동일성을 단정하지 않는다.
  • 不添加评分、等级、"风险"等解读标签，仅保留上游返回的事实数据。
  • 若存在多个候选企业，不判定其同一性。

When to use

使用场景

  • "○○ 회사 직원 규모가 얼마나 돼? 국민연금 가입자수로 보자"
  • "이 사업장 당월 국민연금 고지금액이 얼마야?"
  • "최근 인원이 늘었는지 줄었는지 월별로 보자"
  • "○○公司的员工规模有多大？用国民年金参保人数看看吧"
  • "这家企业当月的国民年金通知金额是多少？"
  • "看看最近人员是增加还是减少，按月度查看趋势"

Prerequisites

前置条件

  • 인터넷 연결, 
    python3
  • scripts/national_pension_workplace.py
    helper
  • hosted/self-host 
    k-skill-proxy
    의 
    /v1/national-pension/workplace
    route 접근 가능
  • 互联网连接、
    python3
    环境
  • scripts/national_pension_workplace.py
    辅助脚本
  • 可访问托管/自托管
    k-skill-proxy
    的
    /v1/national-pension/workplace
    路由

Credential requirements

凭证要求

  • 사용자 측 필수 시크릿 없음.
  • KSKILL_PROXY_BASE_URL
    — self-host 프록시를 쓸 때만 설정. 비우면 hosted 
    https://k-skill-proxy.nomadamas.org
    사용.
  • DATA_GO_KR_API_KEY
    는 프록시 운영 서버 환경에만 둔다. 공공데이터포털에서 
    국민연금공단_국민연금 가입 사업장 내역
    활용신청이 되어 있어야 한다.
  • 用户无需提供必要密钥。
  • KSKILL_PROXY_BASE_URL
    — 仅在使用自托管代理时设置。若留空，则使用托管地址
    https://k-skill-proxy.nomadamas.org
    。
  • DATA_GO_KR_API_KEY
    仅需在代理运营服务器环境中配置。需在公共数据门户完成
    国民年金公团_国民年金加入企业明细
    的使用申请。

Inputs

输入参数

  • --name
    : 사업장명(상호) — 필수
  • --b-no
    : 사업자등록번호(하이픈 허용). 앞 6자리만 prefix 필터로 쓰인다.
  • --name
    ：企业名称（商号）—— 必填项
  • --b-no
    ：营业执照号码（允许包含连字符）。仅使用前6位作为前缀筛选条件。

Privacy boundary

隐私边界

  • 국민연금 데이터는 사업자번호 앞 6자리만 공개되므로, 6자리 일치 + 상호 유사 후보를 나열할 뿐 사업장 동일성을 단정하지 않는다.
  • 공개 범위는 법인·근로자 일정 규모 이상 사업장 위주이며, 소규모/개인 사업장은 미공개일 수 있다.
  • 国民年金数据仅公开营业执照号码前6位，因此仅列出前6位匹配且名称相似的候选企业，不判定企业的同一性。
  • 公开范围主要针对达到一定规模的法人及员工企业，小规模/个体企业可能未公开。

CLI examples

CLI示例

bash
python3 national-pension-workplace/scripts/national_pension_workplace.py \
  --name "삼성전자(주)" --b-no 124-81-00998
bash
python3 national-pension-workplace/scripts/national_pension_workplace.py \
  --name "삼성전자(주)" --b-no 124-81-00998

Failure modes

失败场景

  • 400 bad_request
    : 사업장명을 주지 않음.
  • 503 upstream_not_configured
    : 프록시 서버에 
    DATA_GO_KR_API_KEY
    없음.
  • 502 upstream_forbidden
    : 프록시 키가 3046071에 활용신청되지 않음.
  • 후보 다수: 
    selected_candidate
    가 
    null
    — 사용자가 후보 목록에서 특정한다.
  • 400 bad_request
    ：未提供企业名称。
  • 503 upstream_not_configured
    ：代理服务器未配置
    DATA_GO_KR_API_KEY
    。
  • 502 upstream_forbidden
    ：代理密钥未完成3046071服务的使用申请。
  • 多个候选企业：
    selected_candidate
    为
    null
    — 需用户从候选列表中选择特定企业。

Official surfaces

官方渠道