전체 활용 사례

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

매출 대사 (세금계산서 ↔ 입금)

월 매출 세금계산서와 같은 기간의 은행 입금을 자동 매칭. 미매칭 · 후보만 Notion DB 에 누적.

CLI매월 1회 (월초)

이런 분께 월말 결산을 끝낸 회계담당.

Reconcile · Sales · 2026-04
  • ㈜에이클라이언트
    12,500,000매칭
  • 비클라이언트
    3,800,000후보
  • 시컨설팅
    2,200,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

  • Notion 토큰·DB 가 준비돼 있다

    echo $NOTION_TOKEN $NOTION_DB_RECONCILE_SALES

    토큰과 DB ID 가 둘 다 출력된다

    아니면 — Notion integration 토큰 발급 + 대상 DB 공유, 두 환경변수 export.

02실행

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

프롬프트

지난 달 매출 세금계산서랑 은행 입금 대조해서 미매칭만 Notion DB 에 올려줘.

내부적으로 도는 수집 명령: h6s fetch hometax.tax-invoices.sales.v1 --provider HOMETAX --month 2026-04 --output csv + bank.transactions.cb.v1 --provider CB_KB --month 2026-04

03검증

  • Notion DB(Reconcile · Sales)에 미매칭·후보 행만 누적된다(매칭은 CSV 에만).
  • 매칭률이 출력된다 — 70% 미만이면 룰북 보완 신호.

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_...

Notion 4xx

토큰 권한 부족 또는 DB ID 오류.

해결 integration 을 DB 에 공유했는지·DB ID 확인. 실패 시 stdout fallback.

05변형

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

기간 바꾸기

terminal
2026-03 매출 대사로 돌려줘
다음미수금 추적