Skip to Content
권대환매뉴얼

문제 해결

참고: CSO 정산 포털의 정산 업무는 2026-09-29에 다른 정산 시스템으로 옮겼습니다. 이 쪽은 운영 당시 구성의 기록입니다.

운영 중 자주 나온 문제를 증상별로 정리합니다. 회원사가 직접 풀 수 있는 문제는 자주 묻는 질문에 있습니다.

로그인과 계정

증상원인조치
”승인 대기 중입니다. 관리자 승인 후 로그인 가능합니다.”가입 승인 전입니다.회원 관리의 회원 목록에서 서류를 확인하고 승인합니다.
”로그인 5회 실패로 계정이 잠겼습니다.”비밀번호를 다섯 번 틀렸습니다.회원사가 자동 발송된 메일의 링크로 새 비밀번호를 정합니다. 메일을 못 받으면 관리자가 비밀번호 초기화를 합니다.
로그인 직후 다시 로그인 화면이 나옴브라우저가 쿠키를 막았거나 24시간 세션이 끝났습니다.쿠키를 허용하고 다시 로그인합니다. 시크릿 창이면 일반 창에서 시도합니다.
관리자 화면 메뉴가 안 보임계정 등급이 관리자나 뷰어가 아닙니다.다른 관리자가 회원 정보 수정의 회원 등급을 바꿉니다.
관리자 화면에서 저장·업로드가 거절됨뷰어 등급은 조회만 할 수 있습니다.변경이 필요하면 관리자 등급 계정으로 합니다.

회원사가 자료를 못 봄

증상원인조치
조회 가능한 정산 데이터가 없습니다그 사업자번호에 CSO 매칭이 없습니다.거래처 매핑 탭에서 새 매핑 추가로 정산서 표기를 잇습니다.
매칭이 있는데 자료가 없음매칭 표기와 정산서 CSO관리업체 표기가 글자 하나라도 다릅니다.정산서 표기를 새 꼬리표로 더합니다. 기존 표기는 지우지 않습니다.
특정 달이 정산월 목록에 없음그 달이 조회 기준 연월보다 앞섭니다.데이터 관리의 정산서 조회 제한에서 기준 연월을 확인합니다.
정산월 목록이 통째로 비었음EDI 검토기간 전체 차단이 켜져 있습니다.검토가 끝났으면 전체 차단 해제를 누릅니다.
”일일 다운로드 횟수(5회)를 초과했습니다.”회원사의 하루 엑셀 다운로드 한도입니다.다음 날 다시 받거나, 관리자가 마스터 조회에서 받아 전달합니다.

정산서 업로드

증상원인조치
파일이 올라가지 않음.xlsx·.xls가 아니거나 25MB를 넘습니다.엑셀 통합 문서로 다시 저장하고 불필요한 시트를 지웁니다.
필수 컬럼 누락사업자번호나 정산월 열이 짝지어지지 않았습니다.컬럼 매핑 확인 창에서 두 열을 직접 고릅니다.
일부 열이 비어 들어감SIT 양식의 열 이름이 바뀌어 자동 짝짓기가 빗나갔습니다.매핑 창의 매칭율이 낮은 줄을 직접 고른 뒤 다시 올립니다. 같은 달은 통째로 바뀌므로 다시 올리면 됩니다.
금액이 원본과 다름업로드 때 숫자 칸을 잘못 읽었습니다.데이터 관리의 합계를 원본과 대조하고, 다르면 그 달을 지운 뒤 원본을 다시 올립니다.

메일

증상원인조치
메일이 큐 대기에서 안 움직임SMTP 방식인데 이메일 워커가 멈췄습니다.서버에서 이메일 워커 서비스 상태와 저널 기록을 보고 다시 시작합니다.
큐가 있는데 워커가 “page not found”를 냄Supabase REST 서버가 발송 대기열 함수를 아직 모릅니다(스키마 캐시).Supabase REST 서버에 스키마 다시 읽기 신호를 보낸 뒤 이메일 워커를 다시 시작합니다.
Resend 발송이 실패함API 키가 만료됐거나 발송 한도를 넘었습니다.이메일 이력의 오류 내용을 보고 키를 바꾸거나 SMTP로 돌립니다.
연결 테스트가 실패함SMTP 정보가 틀렸거나 워커가 멈췄습니다.이메일 설정의 호스트·포트·계정을 확인하고 워커 상태를 봅니다.
발송 성공인데 받지 못함스팸함으로 갔거나 회원 이메일이 틀렸습니다.스팸함을 확인하고 회원 목록에서 주소를 확인합니다.

서버와 배포

증상원인조치
배포 뒤 화면이 오류를 냄빌드 결과물이 덜 만들어졌거나 설정이 빠졌습니다.배포 스크립트가 직전 결과물로 되돌렸는지 확인합니다. 로컬에서 pnpm run build로 같은 오류가 나는지 봅니다.
시스템 정보에서 데이터베이스가 오류공용 Supabase가 멈췄거나 키가 바뀌었습니다.Supabase 컨테이너 상태와 환경 파일의 키를 확인합니다.
EDI 검토 OCR이 진행되지 않음OCR 워커가 멈췄을 수 있습니다.OCR 워커 저널을 보고 다시 시작합니다. 자세한 내용은 EDI 검증 매뉴얼에 있습니다.

확인 기준: 2026-11-18, csoweb 저장소 기준.