// 팀 워크플로우에 녹여내기
매출 대사 (세금계산서 ↔ 입금)
월 매출 세금계산서와 같은 기간의 은행 입금을 자동 매칭. 미매칭 · 후보만 Notion DB 에 누적.
이런 분께 — 월말 결산을 끝낸 회계담당.
- ㈜에이클라이언트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 --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 매출 대사로 돌려줘