headless

// back-office

결산 전 부가세·현금영수증 점검

신고서를 내기 전에 빠진 게 없는지 봐야 할 때. 누락·중복·사업자번호 오류를 결산 전에 미리 잡습니다.

// 상황

이런 상황이라면

신고 직전에 빠진 게 보인다

마감하고 나서 누락이나 중복을 발견하면 수정이 번거롭습니다.

사업자번호 오류

거래처 사업자등록번호가 틀리면 공제에서 문제가 생깁니다.

현금영수증이 누락된다

세금계산서만 보다 현금영수증 매입을 빠뜨립니다.

// 흐름

어떻게 동작하나

  1. 01

    신고 자료 수집

    매출·매입 세금계산서와 현금영수증을 함께 받습니다.

  2. 02

    누락·중복 점검

    건수와 금액을 맞춰 빠지거나 겹친 건을 찾습니다.

  3. 03

    오류 정리

    사업자번호 오류 등 의심 건을 결산 전에 잡습니다.

// schemas

사용 데이터 형식

이 시나리오에서 받는 데이터입니다. 기관이 달라도 같은 모양으로 옵니다. 필드 전체 명세는 각 데이터 형식 문서에서 확인할 수 있습니다.

// 결과물

손에 남는 것

  • 신고 전 누락·중복 점검
  • 사업자번호 오류 조기 발견
  • 세금계산서·현금영수증 통합 확인
  • 마감 후 수정 최소화

// 실행 가이드

그대로 따라 하면 됩니다

사전 점검부터 검증까지 이 페이지에서 끝납니다. 실행 방식이 여럿이면 하나만 고르면 됩니다.

01사전 점검

아래 명령을 붙여 넣어 현재 환경이 준비됐는지 확인합니다.

  • CLI가 설치돼 있다

    h6s --version

    버전 문자열이 출력됩니다

    대안으로 npm i -g @h6s-ai/cli

  • 로그인(또는 API Key)이 돼 있다

    h6s whoami

    워크스페이스와 사용량이 출력된다

    대안으로 h6s init # 또는 export H6S_API_KEY=h6s_live_...

  • 워크스페이스에 대상 자격증명이 있다

    h6s credentials list

    공동인증서 또는 대상 기관 자격증명이 1건 이상 보인다

    대안으로 h6s credentials create --interactive --cert

  • Slack 전송 (선택, 없으면 stdout)

    echo $SLACK_WEBHOOK_URL

    webhook URL 이 출력된다

    대안으로 export SLACK_WEBHOOK_URL=https://hooks.slack.com/...

02실행

이 한 줄로 끝. 수집 → 룰북·대사 → 외부 전송까지 internal-finance skill 이 오케스트레이션한다.

프롬프트

2026-Q1 매출/매입 세금계산서랑 현금영수증 4종 합산해서 신고 예정액 자가 검증하고 팀 재무 슬랙에 한 줄로 보내줘.

내부적으로 도는 수집 명령: h6s fetch hometax.tax-invoices.sales.v1 --provider HOMETAX --from 2026-01-01 --to 2026-03-31 (+ purchase·cash-receipts.{sales,purchase} 4종)

03검증

  • 납부/환급 예상액과 자가 검증(음수세액·추이·사업자번호 일관) 결과가 한 줄로 온다.
  • 누락·중복·금액 차이 의심이 있으면 함께 표시된다.

04흔한 에러

CREDENTIAL_INSUFFICIENT_FOR_PROVIDER

그 provider 에 매칭되는 자격증명이 워크스페이스에 없습니다.

해결 h6s credentials create --interactive --cert (공동인증서 1개로 전 기관 공용).

CERT_EXPIRED · CERT_WRONG_PASSWORD

등록된 공동인증서가 만료됐거나 비밀번호가 틀렸다.

해결 h6s credentials update 로 갱신 후 재실행.

NO_API_KEY

API Key 가 설정되어 있지 않습니다.

해결 h6s init 또는 export H6S_API_KEY=h6s_live_...

05변형

같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.

분기 바꾸기

terminal
2025-Q4 부가세 사전 점검 해줘

표로 자세히

terminal
방금 점검 결과를 신고서 항목별 표로 보여줘
전체 가이드 페이지로 보기

// 더 보기

관련 시나리오

cash-receipt-gap-2026-04.csv
입금일금액상대계좌현금영수증
2026-04-18330,000박**미발행 의심
2026-04-22150,000이**미발행 의심

현금영수증 발행 누락 탐지

은행 현금 입금 합 vs 홈택스 현금영수증 매출 합 비교. 발행 누락 의심을 탐지해 자진 발행 안내.

CLI·월 1회 (월초)
MCP · Claude

2026-Q1 부가세 신고용 자료 모아줘

매출 세금계산서 18건 · 공급가액 24,300,000

매입 세금계산서 12건 · 공급가액 9,820,000

신고 예정 납부세액 1,448,000▍

1인 사장님 분기 부가세 신고 자료

Claude Desktop 에 한 줄만 입력하면 지난 분기 매출/매입 세금계산서 + 현금영수증 4종이 신고서 항목별 합계로 정리되어 채팅창에 도착합니다.

MCP·분기 1회 (신고 ~1주 전)

// faq

자주 묻는 질문

현금영수증도 함께 보나요?

매출·매입 세금계산서와 현금영수증을 함께 받아 한 번에 점검합니다.

사업자번호 오류를 잡아 주나요?

사업자등록번호의 형식과 체크섬을 점검해 의심 건을 추릴 수 있습니다.

면세 거래도 오나요?

세금계산서와 면세계산서를 함께 받습니다. 면세는 세액이 0으로 옵니다.

// related

함께 보면 좋은 흐름

같은 데이터를 제품 연동, 내부 시스템, 자동화 작업 중 어디에 둘지에 따라 구현 방식이 달라집니다.

headless

첫 수집은 작게 시작합니다

가입하고 API 키를 만드세요. 짧은 기간의 데이터로 응답 형식을 먼저 확인할 수 있습니다.

무료로 첫 수집 시작