// back-office
매출·매입 대사 (세금계산서 ↔ 입출금)
세금계산서와 실제 입출금이 안 맞을 때. 거래처·금액·날짜를 결산 전에 자동으로 대조합니다.
// 상황
이런 상황이라면
계산서와 입금이 어긋난다
세금계산서는 발행됐는데 입금이 없거나, 입금은 됐는데 계산서가 없을 때 결산 전에 잡아야 합니다.
거래처·금액·날짜 대조가 수작업
엑셀 두 개를 띄워 놓고 눈으로 맞추는 일은 느리고 빠뜨리기 쉽습니다.
미수금이 늦게 보인다
입금이 밀린 건을 결산 직전에야 발견합니다.
// 흐름
어떻게 동작하나
- 01
양쪽 데이터 수집
세금계산서(매출·매입)와 은행 입출금내역을 함께 받습니다.
- 02
거래처·금액으로 대조
발행·수취와 실제 입출금을 거래처·금액·날짜로 맞춥니다.
- 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 --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 매출 대사로 돌려줘// 더 보기
관련 시나리오
- 클라우드 사용료-1,820,000매칭
- 사무실 임대-3,500,000곧 송금
- 정체불명 출금-420,000무계산서 지출
매입 대사 (세금계산서 ↔ 출금)
매입 세금계산서 ↔ 은행 출금 양방향 매칭. 미매칭은 `곧 송금` · `무계산서 지출` 로 분리해 Notion DB.
[알림] 비클라이언트 4월 세금계산서 입금 확인 요청
안녕하세요, 4월 12일자 세금계산서(공급가액 12,500,000원) 의 입금이 확인되지 않아 안내드립니다.
미수금 추적
매출 대사의 미매칭/후보를 30/60/90일 연체로 분류, 담당자별 Slack DM + 거래처별 독촉 메일 초안.
| 입금일 | PG 정산액 | 은행 실입금 | 차이 |
|---|---|---|---|
| 2026-04-29 | 1,840,200 | 1,839,200 | -1,000 |
| 2026-04-30 | 920,000 | 0 | -920,000 (다음 영업일) |
이커머스 셀러 PG ↔ 은행 정산 대사
네이버페이·카카오페이·토스·스마트스토어 정산서와 은행 실입금을 일자별로 매칭. 차이만 CSV로 추려 회계담당에게.
// faq
자주 묻는 질문
매출과 매입을 다 보나요?
매출·매입 세금계산서와 은행 입출금내역을 함께 받아 양방향으로 대조할 수 있습니다.
미수금 추적도 되나요?
발행했지만 입금되지 않은 건을 거래처별로 추려 확인할 수 있습니다.
대조 기준은 정할 수 있나요?
거래처·금액·날짜를 기준으로 매칭 로직을 구성합니다. 팀 규칙은 코드가 아닌 설정으로 두는 것을 권합니다.
// related
함께 보면 좋은 흐름
같은 데이터를 제품 연동, 내부 시스템, 자동화 작업 중 어디에 둘지에 따라 구현 방식이 달라집니다.
API 연동 — 플랫폼
API 연동 — 자체 ERP·어드민