클라이언트가 마흔 곳이면, 월말 자료 수집은 마흔 번의 로그인이 아니라 기관 수까지 곱한 횟수가 됩니다. 은행·홈택스 매출·홈택스 매입을 클라이언트마다 따로 받아 폴더에 정리하던 그 며칠을, 매트릭스 한 번 설정으로 일괄 처리할 수 있습니다. 담당자는 받은 자료를 검토하는 데에만 시간을 쓸 수 있습니다.

회계법인·세무대리 실무자를 위한 글입니다. 코드는 부록 수준입니다.

누가, 언제 겪는 일인가

여러 클라이언트의 기장·신고를 대리하는 회계법인·세무사무소가 매월 겪는 일입니다.

빈도: 매월 기장 마감, 분기 부가세·연말 신고철에 가중됩니다.
현재 방식: 클라이언트별로 받은 인증서·아이디로 은행과 홈택스에 차례로 접속해 자료를 내려받고, 클라이언트 폴더에 손으로 분류합니다.
방치 비용: 클라이언트가 늘면 담당자가 선형으로 더 필요해집니다. 한 클라이언트 자료가 다른 클라이언트 폴더에 잘못 섞이면 그건 단순 실수가 아니라 사고입니다.

어디까지 자동화되나

수집과 클라이언트별 분류는 자동, 자료 검토와 회계 판단은 사람이 맡습니다.

단계	지금 (수기)	headless 도입 후
클라이언트 N × 기관 접속	사람이 하나씩 로그인	자동 (매트릭스 병렬 수집)
기관별 자료 다운로드	은행·홈택스 따로	자동 (표준 형식으로 통일)
클라이언트별 분류	손으로 폴더 정리	자동 (클라이언트별 디렉터리 분리)
자료 검토·기장	사람	사람 (남는 일)

수집 대상은 보통 세 가지입니다 — 은행 입출금내역, 홈택스 매출 세금계산서, 홈택스 매입 세금계산서. 클라이언트마다 같은 기간(전월)으로 받아 클라이언트 코드 폴더에 떨어집니다. 어느 기관에서 받아도 형식이 같아서, 받은 뒤 기장 도구에 넣는 코드는 클라이언트가 바뀌어도 그대로 쓸 수 있습니다.

한 달 마감이 도는 과정

매트릭스는 "클라이언트 목록 × 받을 자료"를 한 표로 봅니다. 클라이언트를 한 줄 추가하면 그 클라이언트가 다음 마감부터 수집에 포함됩니다.

클라이언트 A·B·C … 각각 전월 은행·매출·매입이 병렬로 수집됩니다.
결과는 클라이언트코드/2026-05/ 식으로 갈라져 저장됩니다. 섞일 자리가 없습니다.
한 클라이언트 수집이 실패해도 나머지는 멈추지 않습니다(부분 실패 허용). 실패한 클라이언트만 다시 돌리면 됩니다.

클라이언트 한 곳을 새로 받기 시작하는 데 필요한 변경은 목록에 한 줄과 그 클라이언트 자격증명 등록뿐입니다. 수집 로직은 건드리지 않아도 됩니다.

비용과 ROI

추정이라 자기 클라이언트 수로 바꿔 보면 됩니다.

시간: 클라이언트 40곳·각 3개 기관 기준, 수기 수집이 월 2~4일. 자동화 후 담당자는 수집 시간 대신 검토에만 시간을 쓸 수 있습니다.
금액: 담당자 한 명이 맡을 수 있는 클라이언트 수가 늘어 신규 채용 없이 수임을 더 받을 수 있습니다. 한 클라이언트의 자료가 다른 폴더에 섞이는 사고를 구조적으로 막는 값도 포함됩니다.
요금: headless는 수집 요청 단위 과금입니다. 클라이언트 × 기관 × 월 1회로 계산됩니다. 현재 가격은 요금 페이지에서 확인할 수 있습니다.

도입하는 법

경로 1 — 개발자에게 요청. 아래를 그대로 전달하세요.

매월 1일 클라이언트 목록대로 전월 은행 bank.transactions.cb.v1, 홈택스 매출·매입 세금계산서를 매트릭스로 병렬 수집해서, 클라이언트별 폴더로 분리해 한 번에 올려줘. 클라이언트별 자격증명·키는 분리해 등록할게.

경로 2 — 낮은코드. 클라이언트 목록을 한 표로 두고 일정만 돌리는 형태입니다. 클라이언트 추가는 표에 한 줄, 자격증명 1건이면 됩니다. 자료를 받아오는 기본 흐름은 Claude Code에서 5분 만에 거래내역 받아오기와 같고, 클라이언트만 여러 개로 늘어난 구조입니다.

안전한가

클라이언트별 자격증명은 분리해 등록하고, 봉투 암호화로 저장한 뒤 수집 시점에만 메모리에서 복호화됩니다. 클라이언트 자료는 클라이언트 폴더로 갈라져 저장되어, 한 클라이언트 자료가 다른 곳에 섞이지 않습니다. 회계법인 단위로 클라이언트를 횡단 관리하는 키도 발급할 수 있지만, 그 경우 접근 권한 정책을 먼저 검토하시기 바랍니다 — 편의보다 격리가 우선입니다. 키 관리 모델은 보안 페이지에 있습니다.

도입 체크리스트

대상 클라이언트 목록과 클라이언트별 수집 기관 정리
클라이언트별 자격증명·키 분리 등록
클라이언트 폴더 네이밍 규칙 합의(코드/월)
첫 달 3~5곳으로 시범 → 분류·내용 검증
매월 마감일로 일정 고정, 실패 클라이언트 재시도 절차 정의

자주 막히는 곳

증상	원인	대응
특정 클라이언트만 0건	그 클라이언트 자격증명 만료·기관 거부	그 클라이언트만 자격증명 갱신 후 재시도
일부 클라이언트 실패, 나머지 정상	부분 실패 허용 동작	정상. 실패분만 다시 돌립니다
클라이언트 수 늘자 시간 급증	기관 차원까지 곱해진 매트릭스 폭증	기관을 별도 차원으로 분리하거나 배치 분할
자료가 엉뚱한 폴더에	폴더 네이밍 규칙 불일치	코드/월 규칙을 한 곳에서 강제

더 읽기

클라이언트가 1인 사장이라면: 1인 사장의 분기 부가세, 클릭 없이 자료 준비
수집한 매출을 입금과 맞추는 단계: 은행 입금과 매출 세금계산서, 매월 사람 손 없이 대사
이커머스 클라이언트의 PG 정산까지: 이커머스 PG 정산 ↔ 은행 입금 대사 자동화