매출 장부 자동화, 환불 빼면 숫자 틀립니다

매출 자동으로 장부에 쌓이는 모습

작성자

카테고리:

매출 장부, 매일 손으로 옮기고 계시잖아요

저도 한때 결제 관리자 페이지 들어가서, 엑셀 내려받아서, 장부 시트에 복붙하고, 환불 건 지우고, 이 사이클을 매달 반복했습니다. 1인 사업자 매출 장부 자동화하는 방법을 검색하면서 손으로 옮기는 게 싫어진 게 시작이었어요.

이 사이클의 진짜 문제는 귀찮음보다 숫자입니다. 복붙하다가 행 하나 놓치면 그대로 어긋나는데, 어긋난 이유를 나중에 찾으려면 결국 처음부터 다시 대조해야 하죠. 그리고 열에 아홉은 환불 건 처리를 잘못해서 틀어져 있었습니다.

숫자가 어긋나는 건 대부분 환불 때문

자동화해본 분들은 아실 겁니다. 결제 건만 모으면 장부는 쉽습니다. 문제는 취소, 부분취소, 그리고 취소 시점이 결제 월과 다른 경우예요. 이걸 어느 날짜 기준으로 어떤 상태값으로 넣을지 정하지 않으면, 월별 합계는 조용히 틀어집니다. 이 글에서는 연결 구조부터, 숫자가 어긋나는 지점, 죽었을 때 잡는 법, 비용까지 제가 굴리는 구조 기준으로 정리합니다.

사람 손 안 대고 매출이 쌓이게 만드는 연결 구조

제가 지금 굴리는 구조는 PG사 API에서 결제 내역을 주기적으로 가져와서, 상태값을 정규화하고, 스프레드시트 장부에 한 행씩 쓰는 겁니다. 월말이 되면 월별 시트에 합계가 저절로 만들어져 있어요.

PG사 API → 받는 통로 → 장부, 3단 연결

  1. PG사 개발자 페이지에서 API 키를 발급받습니다. 토스페이먼츠 같은 경우 시크릿 키 하나면 결제 내역 조회가 됩니다.
  2. 가져온 결제 건을 그대로 쓰지 않고, 상태값을 제 장부 규칙으로 바꿔서 저장합니다. 이 단계가 숫자가 맞느냐의 분기점입니다.
  3. 스프레드시트나 DB에 씁니다. 저는 시트를 원본 장부로 씁니다. 세무사에게 넘기기 편해서요.
  4. 매일 정해진 시간에 크론으로 돌립니다. 저는 서버에 크론을 두고 있는데, 지금 서버에 크론이 70개 돌고 있으니 하나 더 얹는 건 부담이 없습니다.
  5. 매일 아침 결과 알림을 받습니다. 이건 뒤에서 다시 씁니다.

노코드 툴로 시작할 때와 코드로 짤 때

매출 건수가 적고 PG가 하나라면 노코드 툴로 시작해도 충분합니다. 다만 노코드는 ‘PG가 둘 이상’이거나 ‘부분취소를 별도 행으로 분리’하는 같은 가공 로직이 필요해지면 금세 지저분해집니다. 저는 가공 규칙이 코드로 명시돼 있는 쪽을 좋아해서 스크립트로 짰는데, 상태 매핑 규칙이 코드에 그대로 남아서 나중에 어긋났을 때 추적이 쉽습니다.

환불·취소·부분취소, 여기서 숫자가 틀어집니다

처음 만들 때 저는 취소 건을 결제가 일어난 날짜 행에 반영했습니다. 그러니까 8월에 결제되고 9월에 취소된 건을 8월 매출에서 빼버린 거죠. 8월 장부를 이미 세무사에 넘긴 뒤에 환불이 들어오니, 9월 매출은 실제보다 크고 8월은 이미 확정돼 있는 상태가 됐습니다. 이때 ‘아, 취소는 취소된 날에 마이너스로’라고 방향을 바꿨는데, 이게 부가세 신고 기준과도 맞아떨어졌습니다. 다만 세무 처리 기준은 세무사와 확인하셔야 합니다. 저는 제 상황을 확인받은 수준입니다.

취소를 ‘결제 날짜’에 넣으면 왜 월별 매출이 어긋나나

결제일 기준으로 취소를 소급 반영하면, 이미 확정된 과거 월의 숫자가 계속 바뀝니다. 월별 매출은 ‘그 달에 실제로 일어난 일’의 합계여야 다음 달에도 안 변합니다. 취소는 취소가 발생한 날짜에, 마이너스 금액의 별도 행으로 기록하면 어느 달을 다시 열어도 숫자가 변하지 않습니다.

부분취소는 마이너스 행으로 별도 기록하기

부분취소는 원결제 금액을 지우면 안 되고, 취소된 금액만큼 별도 행으로 빼야 합니다. 예컨대 30,000원 결제에 10,000원 부분취소라면 장부에는 원행 30,000원과 취소행 -10,000원, 두 행이 있어야 합니다. 저는 부분취소가 여러 번 되는 경우도 그때마다 행을 추가합니다. 합계만 보면 같아 보여도, 나중에 원결제와 취소를 대조할 때 행 단위 기록이 없으면 금방 길을 잃습니다.

PG사별 상태코드 매핑 표

PG마다 상태 이름이 다릅니다. 저는 받자마자 제 규칙으로 통일해서 저장합니다.

PG 원본 상태 제 장부 규칙
토스페이먼츠 DONE paid (결제 행)
토스페이먼츠 CANCELED refund (취소일 기준 마이너스 행)
토스페이먼츠 PARTIAL_CANCELED partial_refund (취소 금액만 마이너스 행)
토스페이먼츠 WAITING_FOR_DEPOSIT, IN_PROGRESS 등 pending (장부 합계에서 제외)
기타 PG 각사 문서의 결제/취소/부분취소 상태 위 네 규칙으로 통일 매핑

포인트는 pending 상태를 합계에서 제외한다는 겁니다. 가상계좌 입금 대기 건을 결제로 세면 입금 취소됐을 때 숫자가 또 틀어집니다.

매일 손으로 장부 옮기는 반복 작업

매일 돌리는 자동화가 죽으면 어떻게 아나

무인으로 돌리는 시스템의 진짜 적은 에러가 아니라 ‘조용히 죽는 것’입니다. 저는 서버와 노트북을 합쳐 크론을 70개 넘게 돌리는데, 이걸 다 사람이 지켜볼 수는 없어서 생존 확인 절차를 만들었습니다.

크론이 죽는 3가지 시나리오

  • 스크립트 자체가 에러로 죽는 경우. API가 일시적으로 응답을 안 주거나, 시트 쓰기 권한이 만료된 경우가 여기 해당합니다.
  • 크론은 도는데 조용히 아무것도 쓰지 않는 경우. 조건문이 빠져서 빈 결과를 ‘정상’으로 판단해버리는 케이스인데, 장부에 구멍이 뚫리는 걸 며칠 뒤에야 압니다.
  • API가 같은 내역을 두 번 돌려주는 경우. 페이지네이션이 꼬이거나 재시도 로직이 겹치면 중복 행이 쌓입니다.

중복 기록 잡는 법: 고유 키로 한 번만 쓰기

해결책은 idempotency, 우리말로 하면 ‘같은 요청을 여러 번 해도 결과는 한 번만 반영되는 성질’입니다. 구현은 단순합니다. PG의 결제 고유 ID를 키로 삼아서, 장부에 이미 그 키가 있으면 건너뛰는 겁니다. 취소 건은 결제 ID에 취소 시각을 붙인 복합 키로 잡습니다. 이 규칙 하나로 재시도를 마음껏 돌려도 중복이 안 쌓입니다.

매일 아침 알림 한 통으로 생존 확인

저는 ‘어제 몇 건 수집했는지’를 매일 아침 한 통 받습니다. 건수가 0이면 뭔가 죽은 거고, 건수가 갑자기 튀면 중복을 의심합니다. 매일 실행 로그를 남겨서, 며칠간의 건수 흐름과 비교하면 이상 감지가 꽤 됩니다. 알림 자체가 안 오면 그건 시스템이 아니라 알림 쪽이 죽은 거라서, 알림 채널은 장부 파이프라인과 분리해 두는 편입니다.

매출 자동 연결 구조 도식 일러스트

얼마 드나: 세팅 비용과 월 유지비 실제 내역

과장 없이 항목별로만 말씀드릴게요. 구체적 금액은 쓰는 도구와 임금에 따라 차이가 커서, 저는 지출 항목 구조로 정리합니다.

노코드로 시작할 때 vs 코드로 짤 때

노코드는 월 구독료가 나가는 대신 세팅 공임이 거의 없습니다. 코드는 세팅 공임이 크게 들어가는 대신 이후엔 서버비 수준으로 내려갑니다. PG 결제 조회 API는 보통 무료 구간이지만, 요청량이 늘면 호출 과금이 붙을 수 있으니 PG 요금 페이지에서 확인하세요. 외주를 준다면 비용 대부분은 이 초기 세팅 공임이고, 상태 매핑 로직까지 제대로 짜라고 요구하면 단순 연결보다 견적이 올라갑니다.

월 유지비 항목별 내역

항목 성격
자동화 툴 구독료 노코드로 갔을 때 발생, 월 고정
서버비 코드로 갔을 때 발생, 소규모면 매우 낮은 수준
API 호출비 결제 내역 조회는 보통 무료 구간이나, 요금제 확인 필요
세무사 확인 공임 최초 1회, 장부 양식이 신고에 사용 가능한지 점검받는 비용

월 매출 규모별 손익분기

거래 건수가 적고 PG가 하나뿐인 초창기라면, 손으로 하는 시간이 자동화 공임보다 작은 경우도 있습니다. 월에 몇 건 안 되는데 세팅에 공임을 들이는 건 배보다 배꼽입니다. 거래가 매주 쌓이고 PG가 둘 이상이 되는 시점부터 자동화가 이득이 되는 경우가 많습니다.

환불 때문에 장부 숫자 어긋나는 상황

이 장부, 세무사한테 그대로 넘겨도 되나

저는 세무사에게 이 장부 양식을 보여드리고 ‘이대로 쓸 수 있는지’ 물어봤습니다. 세무 상식을 제가 단정하는 건 위험하고, 그래서 확인받은 수준에서만 씁니다.

부가세 신고에 쓸 수 있는 장부의 최소 조건

확인받은 바로는 날짜, 금액, 상태(결제/취소/부분취소), 그리고 원결제와 취소를 연결할 수 있는 키가 있으면 대응이 가능하다고 했습니다. 합계만 있는 장부는 안 되고, 행 단위로 원표를 추적할 수 있어야 합니다.

넘기기 전에 확인할 5가지

  • pending 상태가 매출 합계에 섞여 있지 않은지
  • 부분취소가 별도 마이너스 행으로 남아 있는지
  • 원결제와 취소 행이 키로 연결돼 있는지
  • PG 정산금액과 장부 합계가 일치하는지 한 번 대조했는지
  • 부가세 포함 금액 기준인지 공급가액 기준인지 표기돼 있는지

이 중에서 정산금액 대조는 자동화 장부가 있어야 현실적으로 됩니다. 손장부로는 하기 싫은 작업이거든요. 이게 자동화의 진짜 이득이라고 생각합니다. 시간 절약이 아니라 대조가 가능해진다는 것.

정리: 오늘 하루 만에 시작하는 첫 걸음

세팅 전 확인 5문 + 운영 후 매주 확인 5문

세팅 전: PG가 몇 개인가. 부분취소가 발생하는가. 취소 기준을 취소일로 둘 것인가. 장부를 시트에 둘 것인가, DB에 둘 것인가. 세무사에게 넘길 형태가 무엇인가.

운영 후 매주: 지난주 수집 건수가 정상 범위인가. 중복 키 경고는 없었나. 취소 행이 마이너스로 제대로 들어왔나. PG 관리자 페이지 합계와 장부 합계가 같은가. 실행 로그에 빈 날이 있지 않은가.

자동화하지 말아야 할 경우

거래가 드물고 PG가 하나이며, 매달 손으로 해도 스트레스가 없다면 안 하는 게 이득입니다. 자동화는 유지비와 감시 의무가 따라옵니다. 저처럼 크론을 수십 개 굴리는 입장에서도, 새 파이프라인은 ‘죽었을 때 내가 알 수 있는가’부터 설계합니다.

다음 실험은 PG 정산 데이터와 장부를 자동 대조해서 어긋나면 알려주는 크론입니다. 결과가 어떻게 되든 이 블로그에 남기겠습니다. 제가 굴리는 자동화 구경은 wallenstein.dev에 있습니다.


글쓴이 정보

1인 빌더 아일리고가 씁니다. 잘된 것도 망한 것도 적습니다. 영상은 제가 만든 ClipSquare 에서 나옵니다.

자주 나오는 질문

1인 사업자 매출 장부 자동화는 어떻게 시작하나요?

PG사 개발자 페이지에서 API 키를 발급받고, 결제 내역을 주기적으로 가져와 상태값을 정규화한 뒤 스프레드시트나 DB에 한 행씩 쓰면 됩니다. 매일 정해진 시간에 크론으로 돌리고 결과 알림을 받는 구조면 손을 안 대도 장부가 쌓입니다. 결제 건수가 적고 PG가 하나라면 노코드 툴로 시작해도 충분합니다.

매출 장부를 자동화했는데 월별 합계가 자꾸 틀립니다. 왜인가요?

대부분 환불 처리 규칙이 없어서입니다. 취소를 결제가 일어난 날짜에 소급 반영하면 이미 확정된 과거 월의 숫자가 계속 바뀌어서 어긋납니다. 취소는 취소가 발생한 날짜에 마이너스 금액의 별도 행으로 기록하면 어느 달을 다시 열어도 숫자가 변하지 않습니다.

부분취소는 장부에 어떻게 기록해야 하나요?

원결제 금액을 지우면 안 되고, 취소된 금액만큼 별도 마이너스 행으로 빼야 합니다. 예컨대 30,000원 결제에 10,000원 부분취소면 장부에 원행 30,000원과 취소행 -10,000원 두 행이 있어야 합니다. 나중에 원결제와 취소를 대조하려면 행 단위 기록이 꼭 필요합니다.

노코드 툴과 직접 코드로 짜는 방식 중 뭘 골라야 하나요?

매출 건수가 적고 PG가 하나면 노코드로 충분합니다. 다만 PG가 둘 이상이거나 부분취소를 별도 행으로 분리하는 가공 로직이 필요해지면 노코드는 금세 지저분해집니다. 가공 규칙이 코드에 명시돼 있으면 나중에 숫자가 어긋났을 때 추적이 쉽습니다.

매일 돌아야 하는 자동화가 조용히 죽었는지는 어떻게 확인하나요?

무인 시스템의 진짜 적은 에러가 아니라 조용히 죽는 것이라, 생존 확인 절차를 별도로 만들어야 합니다. 스크립트가 에러로 죽는 경우, 크론 자체가 안 돌는 경우, 성공했는데 데이터가 비어 있는 경우를 나눠서 각각 다르게 알림을 받도록 설계하는 게 기본입니다.