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

What this skill does

getUnptRsttCorpInfo02

k-skill-proxy

inqryDiv=1

• 반환: 제재 시작/종료일자, 제재기관명, 계약법구분, 제재근거법률 등 upstream 필드 원문

Coverage boundary

• 조회시점에 제재만료·해제된 건
• 나라장터 미등록업체·개인에 대한 제재

Design principles

• 점수·등급·해석 라벨을 만들지 않는다. upstream 사실 + 출처 + 적용범위 한계만 담는다.

When to use

• "이 회사 입찰 제재(부정당제재) 이력 있어?"
• "거래/계약 전에 부정당업자 제재 여부 확인해줘"

Prerequisites

• 인터넷 연결,

  python3

• scripts/g2b_sanctioned_supplier.py

  helper
• hosted/self-host

  k-skill-proxy

  의

  /v1/g2b/sanctioned-supplier

  route 접근 가능

Credential requirements

• 사용자 측 필수 시크릿 없음.

• KSKILL_PROXY_BASE_URL

  — self-host 프록시를 쓸 때만 설정. 비우면 hosted

  https://k-skill-proxy.nomadamas.org

  사용.

• DATA_GO_KR_API_KEY

  는 프록시 운영 서버 환경에만 둔다. 공공데이터포털에서

  조달청_나라장터 사용자정보 서비스

  (부정당제재업체정보조회 포함) 활용신청이 되어 있어야 한다.

Inputs

• --bizno

  : 사업자등록번호 10자리(하이픈 허용) — 필수

CLI examples

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

Failure modes

• 400 bad_request

  : 사업자번호가 10자리가 아님.

• 503 upstream_not_configured

  : 프록시 서버에

  DATA_GO_KR_API_KEY

  없음.

• 502 upstream_forbidden

  : 프록시 키가 15129466에 활용신청되지 않음.

• total_count = 0

  : 조회시점 현재 유효한 제재 없음 (만료·미등록업체는 미제공임에 유의).

Official surfaces

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

  https://apis.data.go.kr/1230000/ao/UsrInfoService02/getUnptRsttCorpInfo02

• 수동 대조: 나라장터 https://www.g2b.go.kr
• 프록시 route:

  GET /v1/g2b/sanctioned-supplier