Skip to main content
작업 설계와 오프라인 예시입니다. 실제 기관 응답·고객 채택·법적 승인 증거가 아니며, 신용·사기 판정이나 상세 주소 검증을 제공하지 않습니다.

누구를 위한 작업인가

거래처 등록을 반복 처리하는 제품팀과 자동화 파트너가 대상입니다. 담당자가 적법하게 보유한 사업자등록번호로 국세청 사업자 상태를 조회하고, 필요한 경우 한국 지역명 또는 좌표를 행정 코드·기상 격자로 정규화하는 작업입니다. 폐업 여부 등의 상태는 신뢰도 점수나 거래 승인 결론이 아닙니다. 최종 판단은 담당자가 합니다.

입력과 채택 가능한 결과

resolve_location은 지역 가제티어와 좌표 계산을 사용하는 메타 도구입니다. 상세 주소가 지원되지 않거나 동명이면 unsupported_address 또는 ambiguous로 처리하고 재입력을 요청합니다. 이 도구를 전국 주소 검증기로 표현하지 않습니다.

기존 도구와 연결

  1. AI 연결 가이드와 첫 도구 실행의 인증·활성화 경로를 사용합니다.
  2. 민원 프리셋의 civil/business-registration에서 getBusinessRegistrationStatus를 확인합니다.
  3. 원본 응답에 포함된 상태·조회 기준 시각을 보존하고 상태 확인과 정보 일치 확인을 구분합니다.
  4. 기존 사업자 정보 확인 위젯은 validateBusinessRegistration용입니다. 추가 입력의 권한과 목적이 확인된 경우에만 사용하며, 상태 조회 결과나 신용 판정을 대신하지 않습니다.
  5. 성공 결과를 얻는 것과 업무 채택은 별개입니다. 사용자의 명시적인 채택 전에는 퍼널의 adopted를 기록하지 않습니다.
키가 없거나 활성화가 끝나지 않았으면 실행하지 않습니다. 공개 문서를 읽거나 카탈로그에서 도구를 선택한 것은 작업 성공이 아닙니다.

출처·시점·권한·비용

문서 검토일은 2026-10-10입니다. 아래는 저장소 메타데이터 검토이며 기관에 실시간 요청한 결과가 아닙니다. 지역 계산의 처리 시각은 사업자 상태의 기준 시각이 아닙니다. 유효한 상태라도 오래된 자료이면 사용 목적별로 합의한 최신성 기준을 통과해야 합니다. 기관 문서·권리·키와 승인된 실제 smoke 확인 전에는 운영 준비 완료를 주장하지 않습니다.

결과와 누락 처리

아래는 이 작업의 제안된 정규화 계약이며 현재 MCP의 원문 응답 스키마를 바꾸지 않습니다. 요청한 모든 구성요소에 출처·asOf·unavailable을 포함합니다. 예: 사업자 상태는 조회됐지만 주소 정규화가 지원되지 않으면 partial입니다. 정규화를 요청하지 않은 상태 단독 작업은 상태 결과만으로 판단합니다. 응답에 행이 있어도 키·기준 시각·최신성 문제가 있으면 해당 부분을 사용 가능한 것으로 표시하지 않습니다. 상태 코드 자체는 기관 뜻대로 해석하며, 폐업 상태도 정상 조회 결과일 수 있습니다.

오프라인 증거와 지원 경계

오프라인 증거 모음은 두 번들 총 50개 중 이 번들 25개의 합성 정규화 예시를 포함합니다. 실제 사업자번호·주소·키·기관 응답은 포함하지 않고 네 가지 결과와 누락 처리만 검증합니다. 원본 제공 기관 스키마 호환성, 실행 가능성, 사용자 채택률을 증명하지 않습니다. 담당자는 입력과 권리, 지원 창구와 예상 비용을 확인하고 장애 시 원문 입력을 분석 도구에 복사하지 않습니다. 시점이 없거나 지원되지 않는 주소는 빈칸 대신 누락 사유를 표시합니다. 문의할 때에는 도구명·시각·정제된 오류 코드만 공유하고 개인정보는 제외하세요. 관련 문서: 장소 브리핑, 인증과 보안, 내 API 등록.