// use case
매출 대사 (세금계산서 ↔ 입금)
세금계산서 발행과 입금이 안 맞을 때. 거래처 · 금액 · 날짜를 매주 자동으로 대조합니다.
// schemas
사용 스키마
hometax.tax-invoices.sales.v1bank.transactions.cb.v1
// scenario
매출 대사 (세금계산서 ↔ 입금)
월 매출 세금계산서와 같은 기간의 은행 입금을 자동 매칭. 미매칭 · 후보만 Notion DB 에 누적.
- 주기
- 매월 1회 (월초)
- 대상
- 월말 결산을 끝낸 회계담당.
- 채널
- CLI
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 --certNotion 토큰·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_KEYAPI Key 가 설정돼 있지 않다.
해결 h6s init 또는 export H6S_API_KEY=h6s_live_...
Notion 4xx토큰 권한 부족 또는 DB ID 오류.
해결 integration 을 DB 에 공유했는지·DB ID 확인. 실패 시 stdout fallback.
05변형
같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.
기간 바꾸기
2026-03 매출 대사로 돌려줘// scenario
미수금 추적
매출 대사의 미매칭/후보를 30/60/90일 연체로 분류, 담당자별 Slack DM + 거래처별 독촉 메일 초안.
- 주기
- 주 1회 (월요일 아침)
- 대상
- 세금계산서 발행 후 입금 대사가 잦은 팀.
- 채널
- CLI
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 출력 + 그 DB 에 미매칭/후보 행 존재
아니면 —
먼저 매출 대사 사례를 1회 실행해 DB 를 채운다.Gmail 초안 (선택)
env | grep GMAIL_GMAIL_* 환경변수가 설정돼 있다
아니면 —
미설정 시 메일 초안은 stdout 으로만 출력된다(전송 안 함).
02실행
이 한 줄로 끝. 수집 → 룰북·대사 → 외부 전송까지 internal-finance skill 이 오케스트레이션한다.
Reconcile Sales DB 의 미매칭/후보를 연체일 기준으로 분류해서 30/60/90일 톤으로 메일 초안과 담당자 DM 만들어줘.
내부적으로 도는 수집 명령: 신규 수집 없음 — 매출 대사(reconcile-sales) 의 Notion DB 를 재사용한다
03검증
- 거래처별 30/60/90일 톤의 독촉 메일 초안이 생성된다(자동 발송 아님).
- 담당자별 Slack DM 요약이 함께 만들어진다.
04흔한 에러
CREDENTIAL_INSUFFICIENT_FOR_PROVIDER그 provider 에 매칭되는 자격증명이 워크스페이스에 없다.
해결 h6s credentials create --interactive --cert (공동인증서 1개로 전 기관 공용).
CERT_EXPIRED · CERT_WRONG_PASSWORD등록된 공동인증서가 만료됐거나 비밀번호가 틀렸다.
해결 h6s credentials update 로 갱신 후 재실행.
NO_API_KEYAPI Key 가 설정돼 있지 않다.
해결 h6s init 또는 export H6S_API_KEY=h6s_live_...
05변형
같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.
전용 채널로 보내기
export SLACK_WEBHOOK_URL_DUNNING=https://hooks.slack.com/... # 없으면 기본 채널// related