Back to Details

g2b-sanctioned-supplier

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

나라장터 부정당제재업체정보 조회

国家市场不正当制裁企业信息查询

What this skill does

What this skill does

공공데이터포털의 조달청 나라장터 사용자정보 서비스(data.go.kr 15129466, 
getUnptRsttCorpInfo02
)를 
k-skill-proxy
경유로 호출해, 사업자등록번호 정확 일치(
inqryDiv=1
)로 조회시점 현재 유효한 부정당제재를 조회한다.
  • 반환: 제재 시작/종료일자, 제재기관명, 계약법구분, 제재근거법률 등 upstream 필드 원문
通过
k-skill-proxy
调用公共数据门户的采购厅国家市场用户信息服务（data.go.kr 15129466，
getUnptRsttCorpInfo02
），通过准确匹配营业执照号码（
inqryDiv=1
）查询当前查询时刻有效的不正当制裁信息。
  • 返回内容：制裁开始/结束日期、制裁机构名称、合同法分类、制裁依据法律等上游字段原文

Coverage boundary

Coverage boundary

upstream 명세상 다음은 제공되지 않는다 — 과거 이력 조회가 아니다.
  • 조회시점에 제재만료·해제된 건
  • 나라장터 미등록업체·개인에 대한 제재
만료 이력까지 보려면 나라장터(https://www.g2b.go.kr)에서 수동 확인이 필요하다.
根据上游规范，以下内容不提供——并非查询历史记录。
  • 查询时刻已到期/解除的制裁记录
  • 未在国家市场注册的企业/个人的制裁记录
若需查看到期历史记录，需在国家市场（https://www.g2b.go.kr）手动确认。

Design principles

Design principles

  • 점수·등급·해석 라벨을 만들지 않는다. upstream 사실 + 출처 + 적용범위 한계만 담는다.
  • 不创建分数、等级或解释标签。仅包含上游事实、来源及适用范围限制。

When to use

When to use

  • "이 회사 입찰 제재(부정당제재) 이력 있어?"
  • "거래/계약 전에 부정당업자 제재 여부 확인해줘"
  • "这家公司有投标制裁（不正当制裁）记录吗？"
  • "交易/签约前请确认是否为不正当制裁企业"

Prerequisites

Prerequisites

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

Credential requirements

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

Inputs

  • --bizno
    : 사업자등록번호 10자리(하이픈 허용) — 필수
  • --bizno
    : 10位营业执照号码（允许含连字符）——必填

CLI examples

CLI examples

bash
python3 g2b-sanctioned-supplier/scripts/g2b_sanctioned_supplier.py --bizno 124-81-00998
bash
python3 g2b-sanctioned-supplier/scripts/g2b_sanctioned_supplier.py --bizno 124-81-00998

Failure modes

Failure modes

  • 400 bad_request
    : 사업자번호가 10자리가 아님.
  • 503 upstream_not_configured
    : 프록시 서버에 
    DATA_GO_KR_API_KEY
    없음.
  • 502 upstream_forbidden
    : 프록시 키가 15129466에 활용신청되지 않음.
  • total_count = 0
    : 조회시점 현재 유효한 제재 없음 (만료·미등록업체는 미제공임에 유의).
  • 400 bad_request
    : 营业执照号码非10位。
  • 503 upstream_not_configured
    : 代理服务器未配置
    DATA_GO_KR_API_KEY
    。
  • 502 upstream_forbidden
    : 代理密钥未完成15129466服务的使用申请。
  • total_count = 0
    : 当前查询时刻无有效制裁记录（请注意不提供已到期/未注册企业的记录）。

Official surfaces

Official surfaces