headless
전체 활용 사례

// 팀 워크플로우에 녹여내기

현금영수증 발행 누락 탐지

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

CLI월 1회 (월초)

이런 분께 — 현금 매출 비중이 있는 사업자.

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

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 전송 (선택)

    echo $SLACK_WEBHOOK_URL

    webhook URL 이 출력된다

    아니면 — export SLACK_WEBHOOK_URL=https://hooks.slack.com/...

02실행

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

프롬프트

지난 달 은행 현금 입금이랑 홈택스 현금영수증 매출 비교해서 미발행 의심만 CSV 로 정리하고 슬랙에 한 줄.

내부적으로 도는 수집 명령: h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-04 + hometax.cash-receipts.sales.v1 --provider HOMETAX --from 2026-04-01 --to 2026-04-30

03검증

  • 현금 입금 합 vs 현금영수증 매출 합 비교 결과가 나온다.
  • 미발행 의심 건만 CSV(입금일·금액·상대계좌·현금영수증 상태)로 추려진다.

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
2026-Q1 현금영수증 누락 점검 해줘
이전부서별 · 프로젝트별 지출 분류
다음주간 입출금내역 백업 (GitHub Actions)
raw source 보기