// back-office

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

세금계산서와 실제 입출금이 안 맞을 때. 거래처·금액·날짜를 결산 전에 자동으로 대조합니다.

// 상황

이런 상황이라면

계산서와 입금이 어긋난다

세금계산서는 발행됐는데 입금이 없거나, 입금은 됐는데 계산서가 없을 때 결산 전에 잡아야 합니다.

거래처·금액·날짜 대조가 수작업

엑셀 두 개를 띄워 놓고 눈으로 맞추는 일은 느리고 빠뜨리기 쉽습니다.

미수금이 늦게 보인다

입금이 밀린 건을 결산 직전에야 발견합니다.

// 흐름

어떻게 동작하나

  1. 01

    양쪽 데이터 수집

    세금계산서(매출·매입)와 은행 입출금내역을 함께 받습니다.

  2. 02

    거래처·금액으로 대조

    발행·수취와 실제 입출금을 거래처·금액·날짜로 맞춥니다.

  3. 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 --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 매출 대사로 돌려줘
전체 가이드 페이지로 보기

// 더 보기

관련 시나리오

// faq

자주 묻는 질문

매출과 매입을 다 보나요?

매출·매입 세금계산서와 은행 입출금내역을 함께 받아 양방향으로 대조할 수 있습니다.

미수금 추적도 되나요?

발행했지만 입금되지 않은 건을 거래처별로 추려 확인할 수 있습니다.

대조 기준은 정할 수 있나요?

거래처·금액·날짜를 기준으로 매칭 로직을 구성합니다. 팀 규칙은 코드가 아닌 설정으로 두는 것을 권합니다.

// related

함께 보면 좋은 흐름

같은 데이터를 제품 연동, 내부 시스템, 자동화 작업 중 어디에 둘지에 따라 구현 방식이 달라집니다.

headless

첫 수집은 작게 시작합니다

가입하고 API 키를 만드세요. 짧은 기간의 데이터로 응답 형식을 먼저 확인할 수 있습니다.