물애담 총판 정산관리 시스템

카페24 주문을 총판과 연결하고 월별 정산까지 관리하는 웹 시스템

고객: 물애담 (Mooldam)
분류: 웹 소프트웨어 · 관리자 시스템
연동: 카페24 Admin API · 웹훅
사용자: 본사 관리자 · 총판

카페24 주문을 총판의 추천인 정보와 연결하고, 본사와 총판이 각자의 권한에 맞게 매출·커미션·월별 정산을 확인하는 웹 시스템을 제작했습니다. 주문 수집, 추천인 연결, 커미션 계산 근거 확인, 본사의 정산 확정, 총판의 결과 조회를 하나의 흐름으로 묶었습니다.

01해결한 과제

주문과 총판, 커미션과 정산을 한 화면에서 잇는 일

쇼핑몰 주문을 소개한 총판에 연결하고, 주문별 커미션과 환불·취소 내역을 월별 정산에 반영할 수 있는 별도의 업무 화면이 필요했습니다. 본사는 전체 정산 근거를 확인하고 최종 지급액을 관리하되, 총판은 구매자의 개인정보 없이 본인 실적과 정산 내역만 확인하도록 구성했습니다.

핵심 방향: 카페24 연동 · 총판 정산관리 · 본사·총판 권한 분리 · 관리자페이지 개발
사용 기술: React · TypeScript · Vite · React Router · Supabase Auth · PostgreSQL · Supabase Edge Functions · 카페24 Admin API·웹훅 · Cloudflare Pages · QR 코드 생성

02주요 기능

주문 연동부터 총판 정산 조회까지 네 가지 기능

카페24 주문 연동과 추천인 연결

카페24 Admin API와 웹훅으로 주문 상태를 수집하고 추천인에 따라 총판에 연결했습니다. 총판별 추천 링크와 QR을 제공하고, 해당 링크로 들어온 회원의 가입 화면에 추천인 정보가 자동으로 입력되도록 했습니다.
본사 대시보드와 주문 검산

최근 주문, 환불·보류 건, 총판 현황을 대시보드에 모았습니다. 검산용 주문서에서는 주문월 기준 주문 건수·실결제액과 추천인·커미션·환불 내역을 함께 대조할 수 있습니다.
월별 정산 확정과 이월 관리

상품별 단가와 수량으로 커미션을 계산하고, 본사가 월별 정산 근거를 확인해 최종 지급액을 입력·확정합니다. 최소 지급액 미달 이월, 계산서 발행 여부, 송금 후 지급 완료 표시를 함께 관리합니다. 송금과 세금계산서 발행은 본사가 직접 처리하고, 시스템에는 그 결과를 기록합니다.
총판 전용 정산 조회

총판은 본인의 월별 매출과 확정 대기·지급 대기·정산 완료 금액, 지급 예정일을 확인합니다. 구매자 명단과 개인정보는 표시하지 않도록 본사와 총판의 조회 범위를 나눴습니다.