// platform

마켓플레이스 PG ↔ 은행 정산 연동

결제대행 정산과 실제 입금이 안 맞을 때. 셀러별 정산 차이를 자동으로 뽑아 내 서비스에 연동합니다.

// 상황

이런 상황이라면

정산액과 입금이 안 맞는다

결제대행 정산 내역과 실제 통장 입금이 어긋나면, 셀러별 차이를 손으로 맞추는 일이 줄지 않습니다.

셀러가 늘수록 대조가 폭증

셀러 수만큼 대조 건수가 늘어 사람이 따라가기 어렵습니다.

차이의 원인 추적이 느리다

어디서 빠졌는지 찾으려면 여러 화면을 오가야 합니다.

// 흐름

어떻게 동작하나

은행 입금 수집

정산 대상 계좌의 입출금내역을 받습니다.

정산 데이터와 대조

결제대행 정산 내역과 실제 입금을 셀러·금액·날짜로 맞춥니다.

차이만 제품에 연동

맞지 않는 건만 뽑아 내 서비스나 알림으로 보냅니다.

// schemas

사용 데이터 형식

이 시나리오에서 받는 데이터입니다. 기관이 달라도 같은 모양으로 옵니다. 필드 전체 명세는 각 데이터 형식 문서에서 확인할 수 있습니다.

기업뱅킹 입출금내역

은행기간 지정

기간별 입출금 거래. 거래일시·금액(입금 +/출금 −)·적요·거래 후 잔액을 계좌 유형 구분과 함께 받습니다.

bank.transactions.cb.v1

매출 (세금)계산서

홈택스기간 지정

발행한 전자세금계산서·면세계산서. 공급가액·세액·합계와 공급받는자 정보를 받습니다.

hometax.tax-invoices.sales.v1

// 결과물

손에 남는 것

셀러별 정산 차이 자동 추출

실제 입금 기준의 정산 확인

수동 대조 시간 단축

차이 건만 추려 후속 처리로

// 실행 가이드

그대로 따라 하면 됩니다

사전 점검부터 검증까지 이 페이지에서 끝납니다. 실행 방식이 여럿이면 하나만 고르면 됩니다.

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
PG 정산서 CSV가 준비돼 있다
ls ./pg-settlement/
네이버페이·카카오페이·토스 등 정산서 CSV가 보인다
대안으로 각 PG 관리자에서 주간 정산서를 내려받아 한 폴더에 둔다(은행 측은 자동 수집).

02실행

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

프롬프트

지난 주 PG 정산서랑 은행 입금 일자별로 매칭하고 차이만 pg-bank-gap-<주차>.csv 로 정리해줘.

내부적으로 도는 수집 명령: h6s fetch bank.transactions.cb.v1 --provider CB_KB --from 2026-04-27 --to 2026-05-03 --output csv

03검증

PG 정산액 vs 은행 실입금이 일자별로 매칭된다.
차이 있는 행만 pg-bank-gap-<주차>.csv 로 추려진다(다음 영업일 입금 등 사유 표기).

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

이번 달 전체 PG-은행 정산 대사 해줘

전체 가이드 페이지로 보기

// 더 보기

자주 묻는 질문

결제대행 데이터도 받아 주나요?

은행 입출금내역을 표준으로 제공합니다. 결제대행 정산 내역과의 대조 로직은 제품 쪽에서 구성합니다.

셀러별로 나눌 수 있나요?

거래 적요와 금액을 기준으로 셀러 단위 대조를 구성할 수 있습니다.

세금계산서도 함께 보나요?

필요하면 매출 세금계산서를 함께 받아 정산과 증빙을 한 흐름에서 확인할 수 있습니다.

// related