headless

// use case

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

세금계산서 수취와 출금이 안 맞을 때. 매입 정합성을 결산 전에 정리합니다.

// schemas

사용 스키마

  • hometax.tax-invoices.purchase.v1
  • bank.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 --cert

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

    echo $NOTION_TOKEN $NOTION_DB_RECONCILE_PURCHASE

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

    아니면 — Notion integration 토큰 발급 + 매입 DB 공유 후 export.

02실행

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

프롬프트

지난 달 매입 세금계산서랑 은행 출금 양방향 대사해서 미매칭은 곧 송금 / 무계산서 지출 로 나눠 Notion DB 에 정리해줘.

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

03검증

  • Notion DB(Reconcile · Purchase)에 미매칭이 `곧 송금` / `무계산서 지출` 로 분리 누적.
  • 양방향(세금계산서→출금, 출금→세금계산서) 매칭 결과가 표시된다.

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

05변형

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

기간 바꾸기

terminal
2026-Q1 전체로 매입 대사 해줘

// related

다른 각도에서 보기

headless

Get started

지금 가입하고 API 키를 발급받으세요.