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

官方渠道

공공데이터포털: https://www.data.go.kr/data/3046071/openapi.do

upstream:

https://apis.data.go.kr/B552015/NpsBplcInfoInqireServiceV2

(요청 파라미터 camelCase)

프록시 route:
```
GET /v1/national-pension/workplace
```

公共数据门户：https://www.data.go.kr/data/3046071/openapi.do

上游接口：

https://apis.data.go.kr/B552015/NpsBplcInfoInqireServiceV2

（请求参数为驼峰式命名）

代理路由：
```
GET /v1/national-pension/workplace
```