돈생역전은 주문관리, 상품소싱, 로스관리, 수익분석을 한 화면 흐름으로 연결하고, 크롬 확장프로그램을 통해 구매 마켓의 주문 자동입력, 송장 수집, 판매처 송장 자동입력까지 처리하는 셀러 운영 도구입니다.
크롬 확장프로그램 설치
눌러야 하는 버튼
대시보드 상단 우측의 보라색 `확장프로그램 다운로드 v0.1.109` 버튼을 누릅니다. 초록색 `사용가이드` 버튼은 현재 사용자용 안내 페이지로 이동하는 버튼입니다.
1
2
3
4
크롬 확장 아이콘을 누르면 보이는 화면
- `마켓 로그인`에서 자주 쓰는 구매 마켓 로그인 화면으로 이동합니다.
- `플로팅 버튼`을 표시/숨김으로 바꿔 마켓 화면 우측 MX 버튼 노출을 제어합니다.
- `미로그인 마켓 전체 로그인`으로 등록된 마켓 로그인을 한 번에 점검합니다.
- `수동 송장 수집`, `베스트 상품 수집`, `대시보드 열기`를 팝업에서 바로 실행합니다.
- `핫딜 수집`은 커뮤니티 특가 목록에서 후보 상품을 수집해 핫딜 화면에 반영합니다.
- `셀렉터`, `API 레코더`, `가격 규칙`, `마켓 추가` 계열은 관리자/운영자가 마켓 화면 파싱 규칙을 점검할 때 사용하는 보조 기능입니다.
- 대시보드 우측 상단의 `확장프로그램 다운로드` 버튼을 누릅니다.
- 다운로드된 zip 파일의 압축을 해제합니다.
- 크롬 주소창에 `chrome://extensions`를 입력합니다.
- 우측 상단 `개발자 모드`를 켭니다.
- `압축해제된 확장 프로그램을 로드`를 누르고 압축 해제한 확장 폴더를 선택합니다.
- 설치 후 마켓 페이지 또는 돈생역전 페이지에서 MX 플로팅 버튼이 보이는지 확인합니다.
확장 업데이트 방법
플랫 `W` 버튼 오른쪽 위에 `UP` 표시가 보이면 새 확장 버전이 있다는 뜻입니다. 아래 두 방법 중 하나로 업데이트합니다.
- 새 버전 zip을 다운로드해 압축을 풀고, 기존 확장 폴더에 파일을 덮어쓴 뒤 `chrome://extensions`에서 해당 확장의 새로고침 버튼을 누릅니다.
- 덮어쓰기가 헷갈리면 기존 확장을 제거한 뒤, 새로 압축 해제한 폴더를 `압축해제된 확장 프로그램을 로드`로 다시 설치합니다.
확장 버전은 현재 `0.1.109` 기준이며, 주문입력, 셀렉터 설정, 송장수집, 팝업 열기 기능을 제공합니다.
지원 마켓 현황
위 이미지는 확장프로그램의 주문 자동입력과 송장 수집 기준입니다. 주문수집 API 설정 가능 마켓과는 별도로 봐야 합니다.
구매정보 자동입력 지원 마켓
구매 마켓 주문내역에서 주문번호, 결제정보, 판매처 정보를 읽어 주문관리 구매정보 컬럼에 자동 입력할 수 있는 마켓입니다.
| 마켓 | 사용 위치 | 입력되는 주요 컬럼 |
|---|---|---|
| 네이버 | 네이버 주문내역의 `주문관리 입력` 버튼 | 결제플랫폼, 결제ID, 결제URL, 주문번호, 결제일자, 판매처명, 사업자명, 사업자등록번호 |
| G마켓 | G마켓 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명 |
| 옥션 | 옥션 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명 |
| 11번가 | 11번가 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명 |
| 올리브영 | 올리브영 주문내역의 `주문관리 입력` 버튼 | 결제플랫폼, 결제ID(빈칸), 결제URL, 주문번호, 결제일자, 결제가, 판매처명, 사업자명(빈칸), 사업자등록번호(빈칸) |
| 롯데온 | 롯데온 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명, 사업자명, 사업자등록번호 |
| 롯데홈쇼핑 | 롯데홈쇼핑 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명, 사업자명, 사업자등록번호 |
| CJ온스타일 | CJ온스타일 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명, 사업자명, 사업자등록번호 |
| GS SHOP | GS SHOP 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명, 사업자명, 사업자등록번호 |
| 신세계라이브쇼핑 | 신세계라이브쇼핑 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명 |
| SSG | SSG 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 판매처명 |
| 현대Hmall | 현대Hmall 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드 |
| NS홈쇼핑 | NS홈쇼핑 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 판매처명, 사업자등록번호 |
| 오늘의집 | 오늘의집 주문내역의 `돈생역전입력` 버튼 | 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 결제카드, 상품명. 주문자 입력은 기존 배송지 선택과 배송지 추가 모달 2가지 케이스를 지원합니다. 팝업 모달 바깥을 클릭하면 닫히는 화면은 마우스 우클릭 입력 방식으로 진행합니다. |
| 하이마트, 홈앤쇼핑, 쇼핑엔티, SK스토아, KT알파쇼핑, 전자랜드, 코스트코 | 각 마켓 주문내역의 `돈생역전입력` 버튼 | 플랫폼 제공 정보 기준으로 결제플랫폼, 결제ID 드롭다운, 결제URL, 주문번호, 결제일자, 결제가, 판매처명을 입력 |
지원 마켓이 추가되면 이 표에 마켓별 입력 위치와 자동입력 컬럼을 함께 갱신합니다.
주문수집 API 설정
마켓별 API 키를 발급받은 뒤 돈생역전 서버에 저장하는 설정입니다. 아래 순서대로 위치를 확인하고, 각 마켓 API센터에서 IP와 권한을 맞춘 뒤 계정을 등록합니다.
한눈에 보는 주문수집 API 순서
`설정 > 주문수집 API (서버 API 연동)` 탭으로 들어갑니다. `마켓 계정` 탭이 아니라 주문수집 API 탭입니다.
스마트스토어, 쿠팡, 11번가 등 각 마켓의 API센터에서 주문 조회 권한이 포함된 키를 발급받습니다.
마켓 API센터의 허용 IP 또는 호출 IP 입력란에 `134.185.124.146`을 등록합니다.
`+ API 계정 등록`을 눌러 마켓, 스토어명, 발급받은 키 값을 저장합니다.
목록의 `연결테스트`가 성공해야 서버에서 직접 주문수집을 실행할 수 있습니다. 실패하면 IP, 권한, 키 값을 먼저 확인합니다.
돈생역전 입력 위치 찾기
설정 화면에서 `주문수집 API (서버 API 연동)` 탭을 선택합니다.
`설정 > 주문수집 API (서버 API 연동) > + API 계정 등록`에서 마켓별 API 값을 저장합니다.
마켓 API센터에 서버 IP 등록
마켓 API센터의 `API 호출 IP`, `허용 IP`, `화이트리스트 IP`, `서버 IP` 입력칸에 아래 IP를 넣습니다.
가이드와 캡처에는 이 IP만 표시하고 사용합니다.
API 계정 등록 버튼 클릭
마켓별로 발급받은 키는 오른쪽 상단 `+ API 계정 등록`에서 저장합니다.
1
2
1. 오른쪽 상단 `+ API 계정 등록`을 눌러 마켓별 API 키를 등록합니다.
2. 등록 후 목록의 `연결테스트`로 정상 여부를 확인합니다.
Smartstore Commerce API
스마트스토어 API 키 발급하기
네이버 커머스API센터에서 애플리케이션을 만들고, 발급된 값을 돈생역전 `주문수집 API` 설정에 저장합니다.
네이버 커머스API센터에서 애플리케이션 등록
`내 스토어 애플리케이션` 화면에서 `등록하기`를 눌러 새 애플리케이션을 만듭니다.
애플리케이션 이름은 `돈생역전 주문수집`처럼 알아보기 쉽게 입력합니다.
`문의`, `상품/N배송`, `정산`, `주문 판매자`, `판매자정보` 5개 API 그룹을 전부 추가합니다.
애플리케이션 ID와 시크릿 확인
발급 화면에서 APP ID와 APP Key로 사용할 값을 확인합니다. 실제 키는 외부에 노출하지 않습니다.
애플리케이션 ID는 돈생역전 `APP ID` 입력칸에 넣습니다.
애플리케이션 시크릿은 돈생역전 `APP Key` 입력칸에 넣습니다.
돈생역전에 API 계정 등록
설정 화면에서 스마트스토어를 선택하고 판매자 ID, APP ID, APP Key를 저장합니다.
1
2
3
4
5
`스마트스토어`를 선택합니다.
네이버 커머스API센터의 판매자 ID를 그대로 입력합니다.
애플리케이션 상세 화면에서 확인한 ID와 시크릿 값을 각각 입력합니다.
저장 후 목록의 `연결테스트`로 정상 여부를 확인합니다.
전체 순서 정리
- 1. 네이버 커머스API센터에 접속합니다.
- 2. 계정 생성 후 `내 애플리케이션`으로 이동합니다.
- 3. 애플리케이션 등록을 누르고 이름과 설명을 입력합니다.
- 4. API 그룹 5개를 전부 추가합니다.
- 5. OPEN API 키 수정에서 `자체개발(직접입력)`을 선택합니다.
- 6. 업체명 `돈생역전`, URL `https://moneyexpress.co.kr`, IP `134.185.124.146`을 입력합니다.
- 7. 애플리케이션 ID와 시크릿을 확인합니다.
- 8. 돈생역전 `+ API 계정 등록`에 값을 저장합니다.
돈생역전에 입력할 값
| 마켓 | 스마트스토어 |
| 스토어명 | 사용자가 구분할 이름. 예: 스마트스토어 메인 |
| API 연동용 판매자 ID | 커머스API센터의 판매자 ID 값을 그대로 입력 |
| APP ID | 애플리케이션 상세에서 확인한 APP ID |
| APP Key | 애플리케이션 상세에서 확인한 APP Key |
쿠팡 API 키 발급하기
1
2
3
4
5
쿠팡 입력 기준
- `Vendor ID`는 쿠팡 Wing 추가판매정보의 업체코드입니다.
- `Access Key`, `Secret Key`는 쿠팡 Open API에서 발급받은 값입니다.
- 키를 넣은 뒤 저장하고 목록에서 `연결테스트`를 눌러 확인합니다.
- 쿠팡 Wing 판매자센터에 로그인합니다.
- 우측 상단의 계정명 메뉴를 엽니다.
- `추가판매정보`를 클릭합니다.
- 화면에 표시되는 `업체코드`를 확인합니다.
- 이 `업체코드`가 돈생역전의 `Vendor ID` 입력값입니다.
- 쿠팡 Wing의 Open API 메뉴로 이동합니다.
- API 사용 신청 또는 키 발급을 진행합니다.
- 주문 조회 권한이 포함되도록 신청합니다.
- 허용 IP 항목이 있으면 추가할 IP `134.185.124.146`을 입력합니다.
- Access Key와 Secret Key를 발급받습니다.
돈생역전에 입력할 값
- `Vendor ID`에는 쿠팡 Wing `추가판매정보`의 업체코드를 입력합니다.
- `Access Key`와 `Secret Key`는 쿠팡에서 발급된 값을 그대로 입력합니다.
- 스토어명은 `쿠팡 본계정`처럼 사용자가 구분하기 쉬운 이름으로 입력합니다.
- 키 앞뒤 공백이 들어가면 인증 실패가 날 수 있습니다.
쿠팡 계정이 2개 이상일 때
- 각 쿠팡 계정에서 API 키를 각각 발급받습니다.
- 각 쿠팡 계정의 허용 IP에 추가할 IP `134.185.124.146`을 모두 입력합니다.
- 돈생역전에서 `+ API 계정 등록`을 계정 수만큼 반복합니다.
- 스토어명은 `쿠팡 본계정`, `쿠팡 2호점`처럼 구분되게 입력합니다.
- 각 계정의 Vendor ID, Access Key, Secret Key를 서로 섞지 말고 저장합니다.
동일한 쿠팡 키를 복사해서 2개 계정처럼 등록하면 주문이 중복되거나 다른 계정 주문을 찾지 못할 수 있습니다.
플레이오토(플토)와 함께 사용할 때
- 쿠팡 복수업체를 운영하면서 플레이오토(플토)도 함께 쓰는 경우입니다.
- 각 쿠팡 계정의 허용 IP 입력란에 플레이오토 IP `52.79.173.222`와 돈생역전 서버 IP `134.185.124.146`을 콤마(,)로 구분해 함께 입력합니다.
- 예시: `52.79.173.222,134.185.124.146`
한쪽 IP만 입력하면 다른 솔루션의 주문수집이 차단될 수 있습니다.
캡처에 표시할 때 가릴 정보
우측 상단 계정명, 담당자 이름, 업체코드 전체값, Access Key, Secret Key는 문서에 넣을 때 반드시 일부 또는 전체를 가립니다.
ESM(옥션/지마켓) 현재 미지원
1
2
주문수집 API 계정 등록 화면에서 `G마켓`과 `옥션`은 현재 선택 불가 상태입니다. 지원 확정 전에는 주문수집 API 키를 등록하지 않습니다.
지원 전 확인 기준
- 설정 모달의 마켓 목록에는 `G마켓 (현재 미지원)`, `옥션 (현재 미지원)`으로 표시됩니다.
- 두 항목은 비활성화되어 선택하거나 저장할 수 없습니다.
- 추후 지원되면 별도 안내에 따라 API 키 발급 절차와 입력값을 추가합니다.
11번가 연동하기
11번가 Open API Center에서 먼저 설정
11번가 Open API Center에 접속한 뒤 `API 관리` 메뉴에서 `인증하기`를 진행하고, 접속권한은 `IP 직접 입력 > 사용`으로 선택합니다.
IP 직접 입력에 돈생역전 서버 IP 등록
개발서버 IP, 개발자 PC, 상용서버 IP에 모두 `134.185.124.146`을 입력합니다. 다른 업체와 함께 사용하는 경우에는 기존 IP 뒤에 `,` 콤마를 입력한 뒤 추가 IP를 이어서 넣습니다.
OPEN API 키 수정에서 자체개발 선택
업체 입력 방식은 `자체개발(직접입력)`을 선택하고, 업체명은 `돈생역전`, URL은 `https://moneyexpress.co.kr`, IP 주소는 `134.185.124.146`으로 입력한 뒤 확인합니다. 발급된 `openapikey` 값을 돈생역전의 `API Key (openapikey)` 칸에 저장합니다.
1
2
3
11번가 입력 기준
- `API Key (openapikey)`에 11번가에서 발급받은 openapikey 값을 넣습니다.
- 스토어명은 `11번가 메인`처럼 계정 구분용 이름을 넣습니다.
- 저장 후 목록에서 `연결테스트`를 눌러 정상 여부를 확인합니다.
- 11번가 Open API 신청 페이지 https://openapi.11st.co.kr/openapi/OpenApiServiceRegister.tmall 에 접속합니다.
- 주문 조회 API 사용 신청을 진행합니다.
- API Key 또는 openapikey 값을 발급받습니다.
- 허용 IP 입력란이 있으면 추가할 IP `134.185.124.146`을 입력합니다.
- 돈생역전에서 마켓을 `11번가`로 선택하고 API Key를 입력합니다.
돈생역전에 입력할 값
`API Key (openapikey)` 칸에 11번가에서 발급받은 openapikey 값을 넣습니다.
자주 막히는 원인
- 마켓 API센터에 추가할 IP `134.185.124.146`을 등록하지 않은 경우
- 주문 조회 권한 없이 상품/정산 권한만 신청한 경우
- API Key와 Secret을 서로 바꿔 입력한 경우
- 판매자 ID, 업체코드, 스토어 ID를 다른 계정 값으로 입력한 경우
- 마켓 쪽 API 승인 대기 상태인데 돈생역전에 먼저 저장한 경우
연결테스트 결과 화면
1
2
목록의 `연결테스트`를 누르면 결과가 화면 중앙 모달로 표시됩니다. `성공`이 나오면 키 형식과 서버 통신이 정상이라는 뜻입니다.
실패가 나오면 마켓 API센터의 허용 IP, 주문 조회 권한, 입력한 키 값을 먼저 확인합니다.
주문관리 시트
검색/날짜 필터
검색 대상, 검색어, 주문일/결제일, 기간을 지정한 뒤 `검색`을 누릅니다. 검색어는 주문번호, 상품명, 수령자, 담당자처럼 주문관리 셀에 저장된 값을 기준으로 찾습니다. `미발주`는 주문번호가 비어 있는 행만 보여줍니다.
주문관리 화면을 열 때마다 항상 최근 30일(주문일 기준)로 새로 조회합니다 — 이전에 다른 기간으로 조회했어도 기억하지 않고 매번 최근 30일부터 시작합니다(전체 데이터가 계속 누적되는 시트라 무기한 전체를 매번 불러오면 느려지기 때문). 다른 기간이 필요하면 기간 드롭다운(1/7/14/30/60/90일)이나 날짜 입력칸을 직접 사용하세요. `필터 초기화` 버튼은 검색어/컬럼필터/미발주/정렬/상태 뱃지 필터만 초기화하고 날짜 범위는 그대로 유지합니다.
행/엑셀/관리 버튼
`+ 행 추가`, `행 삭제`, `파일 가져오기`, `내보내기`, `출고중지조회`, `등록상품 DB`, `수수료표`, `블랙리스트`, `컬럼`을 이 영역에서 실행합니다.
주문관리 기능 전체 색인
아래 항목은 실제 주문관리 화면의 버튼, 셀 동작, 모달, 자동 연동 기능을 기준으로 정리한 색인입니다. 왼쪽 주문관리 하위 탭에서 항목을 누르면 해당 설명 위치로 이동합니다.
전체/담당자 기준, 주문일/결제일, 기간 검색, 주문번호가 빈 행만 보기.
빈 행 추가, 체크 행 삭제, 선택 건수 확인.
선택한 컬럼 데이터 입력, 셀 단위 저장, 새로고침 유지.
드래그 범위 선택, 엑셀/구글시트 복수값 붙여넣기.
오른쪽 아래 핸들로 값 복사, 끝 숫자 자동 증가.
헤더 클릭 정렬, 우클릭 정렬 해제, 여기까지 틀고정.
헤더 우클릭 `필터`로 컬럼 값 체크리스트를 열고 여러 컬럼을 AND 조건으로 적용.
팀원 변경분이 몇 초 안에 자동 반영. 중복 처리 방지.
표시/숨김, 순서, 너비, 사용자 컬럼, 헤더 이름 변경.
주문 파일 입력, 전체/플레이오토/커스텀 양식 출력.
체크한 주문만 출력 대상으로 사용하는 흐름.
쿠팡 주문 ID 매칭으로 취소/정상 표시.
상품명-판매처 기준 수수료/카테고리 등록과 미등록 배지 처리.
주소 제보/승인/매칭 표시, 관리자 목록 관리.
주문 행 필수값으로 로스관리 케이스 생성.
마켓 주문 상세에서 결제카드, 결제ID, 판매처 정보를 주문관리로 입력.
송장수집 저장 결과가 주문관리 택배사/송장번호에 반영.
기본 사용
- `주문관리` 메뉴로 이동합니다.
- 헤더 행 아래 셀에 주문 정보를 입력합니다.
- 판매마켓, 구매마켓, 주문번호, 상품명, 수취인, 연락처, 주소, 배송메모를 확인합니다.
- 값을 수정하면 변경된 셀 단위로 저장됩니다.
- 새로고침 후에도 값이 유지되는지 확인합니다.
주의할 점
- 삭제는 빈 값 저장으로 처리되므로, 실수로 지운 셀은 다시 입력해야 합니다.
- 주문관리의 헤더와 셀 값은 사용자가 직접 관리하는 원본입니다.
- 자동입력과 송장수집은 주문관리의 저장값을 기준으로 동작합니다.
- 저장 성공은 화면 표시와 새로고침 후 유지까지 확인해야 합니다.
정렬과 열고정
컬럼 헤더를 클릭하거나 우클릭 메뉴의 `정렬`을 누르면 오름차순, 내림차순, 해제 순서로 바뀝니다. 정렬 중인 컬럼은 헤더에 ▲ 또는 ▼ 표시가 붙습니다.
상단의 `정렬 해제` 버튼 또는 헤더 우클릭 메뉴의 `정렬 해제`를 누르면 기본 행 순서로 돌아갑니다.
고정하고 싶은 마지막 컬럼 헤더를 우클릭해 `여기까지 틀고정`을 선택합니다. 체크박스부터 선택한 컬럼까지 왼쪽에 고정됩니다.
컬럼 우클릭 필터 (엑셀식 값 필터)
컬럼 헤더를 우클릭하면 정렬/틀고정 메뉴에 `필터` 항목이 함께 나옵니다. `필터`를 누르면 그 컬럼에 저장된 값 목록이 체크리스트로 뜨고, 원하는 값만 체크해 `적용`하면 전체 페이지 기준으로 해당 값의 행만 표시됩니다.
1. 헤더 우클릭. 필터하려는 컬럼 헤더에서 우클릭해 `필터 (컬럼명)`를 선택합니다.
2. 값 선택 후 적용. 값 검색으로 좁히고 전체선택/해제로 조정한 뒤 `적용`을 누릅니다. 여러 컬럼에 동시에 걸 수 있습니다(AND 조건).
필터가 걸린 컬럼은 헤더에 필터 표시가 붙고, 상단 필터 배너에 `필터: 컬럼명(개수)`로 나옵니다. 해제는 헤더 우클릭 `필터 해제` 또는 팝업에서 전체선택 후 적용입니다.
필터(미발주만 보기 포함)가 걸린 상태에서 셀을 수정해 조건을 벗어나면 그 행은 저장 즉시 목록에서 사라집니다. 예: 미발주 필터 중 주문번호를 입력하면 해당 행이 바로 빠집니다.
팀원 실시간 동기화
같은 시트를 쓰는 다른 팀원이 수정/삭제한 내용이 몇 초 안에 내 화면에 자동 반영됩니다. 새로고침하지 않아도 다른 사람이 처리한 주문이 표시되어, 같은 주문을 두 명이 중복 구매하는 손실을 막습니다. 내가 편집 중인 셀은 동기화가 덮어쓰지 않습니다.
컬럼 변경과 출력양식 설정
상단 `컬럼` 버튼을 누르면 표시할 컬럼을 선택하고 순서와 너비를 조정할 수 있습니다. 헤더를 드래그하면 위치가 바뀌고, 오른쪽 경계를 끌면 폭이 저장됩니다.
컬럼 설정 모달의 `+ 컬럼 추가`로 사용자 컬럼을 만들 수 있습니다. 헤더를 더블클릭하면 표시 이름을 바꿀 수 있고, 원래 컬럼명은 헤더 도움말에 남습니다.
`내보내기 ▾`에서 `전체 양식`은 현재 주문관리 데이터를 전체 컬럼으로 내려받고, `플레이오토 송장 양식`은 주문고유번호, 배송사명, 송장번호만 내려받습니다.
`+ 커스텀 양식 만들기`에서 양식 이름과 출력할 컬럼을 선택해 저장합니다. 저장된 양식은 내보내기 목록에 표시되고 필요하면 삭제할 수 있습니다.
주문관리 탭 버튼 기능
| 위치 | 버튼/항목 | 기능 |
|---|---|---|
| 상단 검색 | 전체 / 담당자 | 검색 기준을 선택합니다. 전체는 주문 데이터 전체에서 찾고, 담당자는 담당자 값만 기준으로 찾습니다. |
| 상단 검색 | 검색 | 입력한 검색어와 날짜 조건으로 주문관리 행을 다시 불러옵니다. 검색창에서 Enter를 눌러도 실행됩니다. |
| 상단 검색 | 미발주 | 주문번호가 비어 있는 행만 조회합니다. 미발주 필터 중 주문번호를 입력하면 저장 후 해당 행은 목록에서 빠집니다. |
| 날짜 필터 | 주문일 / 결제일 | 날짜 조회 기준을 선택합니다. 같은 기간이라도 주문일과 결제일 기준 결과가 다를 수 있습니다. |
| 날짜 필터 | 📅 | 시작일과 종료일을 달력으로 선택합니다. 직접 입력할 때는 YYYYMMDD 형식을 사용합니다. |
| 날짜 필터 | 기간 빠른선택 | 1/7/14/30/60/90일 중 골라 오늘 기준 해당 일수로 바로 조회합니다. 현재 조회 기간과 일치하면 자동으로 표시됩니다. |
| 필터 | 필터 초기화 | 검색어/컬럼 우클릭 필터/미발주/정렬/상태 뱃지 필터만 초기화합니다. 날짜 범위는 건드리지 않습니다 — 날짜는 필터가 아니라 화면 기본 동작이라 항상 최근 30일부터 시작하고, 바꾸려면 기간 빠른선택이나 날짜 입력칸을 직접 사용해야 합니다. |
| 상태 요약 | 전체 / 선택 / 처리 / 중복 / 블랙 / 취소 뱃지 | 현재 조회 중인 날짜 범위 전체 기준(페이지 무관)으로 집계된 건수입니다. 처리/중복/블랙/취소는 클릭하면 해당 상태만 걸러 보여주고(날짜 범위는 유지), 다시 클릭하거나 `전체`를 클릭하면 해제됩니다. |
| 도움말 | 사용가이드 | 등록상품 미등록, 날짜형식 컬럼 우클릭, 출고중지조회 기준을 간단히 확인하는 도움말입니다. |
| 행 관리 | + 행 추가 | 빈 주문 행을 추가합니다. 새 행에 직접 값을 입력한 뒤 저장 상태와 새로고침 후 유지 여부를 확인합니다. |
| 행 관리 | 행 삭제 | 체크박스로 선택한 주문 행을 삭제합니다. 선택한 행이 없으면 비활성화됩니다. |
| 엑셀 | 파일 가져오기 | 엑셀 파일의 주문 행을 불러옵니다. 헤더명은 주문관리 컬럼명으로 매핑되고, 중복 행은 제외될 수 있습니다. |
| 엑셀 | 내보내기 ▾ | 다운로드 양식을 선택합니다. 전체 양식은 모든 컬럼을 내보내고, 플레이오토 송장 양식은 송장 업로드용 컬럼만 내보냅니다. 플레이오토 송장 양식을 체크박스 선택 없이 내보내면 이미 출력한 행은 자동으로 건너뛰어 중복 출력을 막습니다. 이미 출력한 행을 일부러 다시 출력하려면 해당 행을 체크박스로 선택한 뒤 내보내야 합니다(선택한 행은 이미 출력됐어도 그대로 다시 내려받음). |
| 쿠팡 | 출고중지조회 | 쿠팡 API에서 받은 출고중지 주문 ID를 주문관리의 `판매사이트 주문번호`와 매칭해 `출고중지여부` 칸에 반영합니다. 자동으로 확인이 안 되는 주문은 `출고중지여부` 칸을 클릭해 사용자가 직접 `취소` 등을 입력할 수도 있습니다. |
| 상품 매칭 | 📦 등록상품 DB | 판매처와 상품명별 수수료율을 관리합니다. 모달 안에서 엑셀 가져오기, 양식 다운로드, 수정, 삭제를 할 수 있습니다. |
| 상품 매칭 | 미등록 배지 | 주문 행의 상품이 등록상품 DB와 매칭되지 않았다는 표시입니다. 배지를 눌러 마켓, 짧은 표시명, 카테고리, 수수료율, 과세 유형을 등록합니다. |
| 수수료 | 📊 카테고리 수수료 정보 | 기본 카테고리 수수료표를 확인합니다. 등록상품 수수료율을 정할 때 참고합니다. |
| 블랙리스트 | 🚫 | 블랙리스트 목록과 제보 화면을 엽니다. 관리자는 직접 추가/삭제하고, 일반 사용자는 의심 주소를 제보합니다. 등록 주소의 배송주소 기본 주소 부분만 비교하므로(상세주소/동호수는 비교하지 않음), 일치해도 특정인을 지목하는 게 아니라 의심 신호로만 활용해야 합니다. |
| 컬럼 | 컬럼 | 표시할 컬럼, 컬럼 순서, 컬럼 너비를 조정합니다. 모달 안에서 기본값 복원, 취소, 저장을 선택합니다. |
| 셀 편집 | 선택한 컬럼 데이터 | 현재 선택한 셀 값을 상단 입력칸에서 바로 수정합니다. 입력 후 저장되어야 새로고침 뒤에도 유지됩니다. |
| 표 선택 | 헤더 체크박스 / 행 체크박스 | 행 삭제 같은 선택 기반 작업에 사용할 행을 지정합니다. 헤더 체크박스는 현재 화면의 행을 한 번에 선택합니다. |
| 페이지 | ◀ / ▶ | 이전 페이지와 다음 페이지로 이동합니다. 현재 선택 건수는 페이지 영역의 선택 요약에 표시됩니다. |
| 로스처리 | 📤 | 해당 주문 행의 수령자, 연락처, 주소, 상품명, 결제가 등 필수값을 기준으로 로스 케이스를 전송합니다. 전송된 행은 전송됨으로 표시됩니다. |
버튼을 눌렀다는 것만으로 정상 처리로 보지 말고, 주문관리 셀 값이 화면에 반영되고 새로고침 뒤에도 유지되는지까지 확인해야 합니다.
출고중지조회 사용법
출고중지조회는 쿠팡 주문의 출고중지 상태를 서버 API로 확인해서 주문관리 `출고중지여부` 칸에 반영하는 기능입니다. 쿠팡 API 연동이 먼저 되어 있어야 합니다.
`설정 > 주문수집 API`에서 쿠팡 API 계정을 등록하고 `연결테스트`가 성공해야 합니다. 쿠팡 API센터에는 돈생역전 서버 IP `134.185.124.146`이 허용되어 있어야 합니다.
조회 매칭 기준은 `판매사이트 주문번호`입니다. 쿠팡 API에서 받은 출고중지 주문 ID가 이 칸의 값과 일치하면 해당 행을 출고중지 대상으로 봅니다. 공백이나 콤마로 여러 번호가 들어간 경우 각각 나눠 비교합니다.
매칭되면 `출고중지여부` 값이 `취소`로 저장되고 화면에는 빨간 `취소`가 표시되며, 해당 행 전체 글자와 왼쪽 세로 줄도 빨간색으로 강조됩니다. 매칭되지 않으면 저장값은 비워지고, 화면에서는 주문 데이터가 있는 행에 `정상`으로 표시됩니다.
쿠팡 API로 자동 확인이 안 되는 주문(다른 마켓, API 미연동 등)도 `출고중지여부` 칸을 클릭해 직접 `취소` 등을 입력할 수 있습니다. 자동 조회 결과를 덮어써야 할 예외 상황에도 수동으로 고칠 수 있습니다.
버튼 실행 후 토스트의 출고중지 대상 건수, 취소 표시 건수, 해제 건수를 확인하고 주문관리 화면의 `출고중지여부` 칸이 `취소` 또는 `정상`으로 표시되는지 새로고침 후에도 확인합니다.
등록상품 DB와 수수료 계산
등록상품 DB는 주문관리에서 상품명과 판매처를 기준으로 카테고리, 수수료율, 표시명을 저장하는 기능입니다. 파일 가져오기나 주문 수집으로 들어온 주문이 등록상품과 매칭되면 `등록상품`, `수수료`, `정산금액`, `부가세`, `마진금액`, `마진율` 계산에 사용됩니다.
주문 행에 빨간 미등록 배지가 표시되면 해당 상품이 아직 등록상품 DB와 매칭되지 않은 상태입니다. 배지를 눌러 판매사이트명, 상품명, 카테고리, 수수료율, 과세 유형을 저장합니다.
상단 `📦` 버튼으로 전체 등록상품 목록을 확인합니다. 모달에서 엑셀 가져오기, 입력 양식 다운로드, 수정, 삭제를 할 수 있습니다.
`📊` 버튼은 기본 카테고리 수수료표를 보여줍니다. 새 등록상품 수수료율을 정할 때 참고용으로 사용합니다.
등록 후 같은 판매사이트명+상품명 행에 등록상품 상태와 수수료/마진 계산이 반영되는지 확인합니다. 새로고침 후에도 같은 값이어야 합니다.
블랙리스트 사용법
블랙리스트는 문제가 있었던 주소를 등록해두고, 주문관리의 배송주소가 그 주소와 일치하면 해당 주문 행을 검정 배경 + 흰 글씨로 강하게 경고 표시하는 기능입니다.
주문관리 상단의 `🚫` 버튼을 누르면 블랙리스트 모달이 열립니다. 모달에는 `목록/관리` 탭과 `제보하기` 탭이 있습니다.
관리자 계정은 `목록/관리` 탭에서 이름, 전화번호, 지번주소, 도로명/추가주소, 사유를 입력해 블랙리스트를 바로 추가할 수 있습니다. 필요 없는 항목은 삭제할 수 있습니다.
일반 사용자는 직접 등록하지 않고 `제보하기` 탭에서 의심 주소를 접수합니다. 또는 구매 마켓의 MX `주문자 N건` 목록에서 주문 상세를 펼친 뒤 `블랙리스트 제보` 버튼으로 바로 제보할 수 있습니다. 제보는 `reported` 상태로 저장되고 관리자가 검토합니다.
승인 대기 제보는 관리자에게 표시됩니다. 주소가 부정확하면 기본 주소와 추가주소를 수정해 `주소저장` 후 `승인`합니다. 승인되면 active 블랙리스트가 됩니다.
등록 주소와 주문의 `배송주소`는 공백, 하이픈, 점, 괄호 같은 기호를 제거한 값으로 비교합니다. 주문 배송주소 안에 등록 주소가 포함되면 해당 주문 행이 검정 배경 + 흰 글씨로 표시됩니다. 이미 `주문번호`가 입력된(처리 완료) 행은 검사 대상에서 빠집니다.
비교는 등록 주소의 기본 주소(도로명/지번) 범위까지만 이뤄지고, 동/호수 같은 상세주소는 비교하지 않습니다. 그래서 검정 표시가 뜨더라도 "이 사람이 맞다"고 특정하는 게 아니라, 같은 건물/도로명 주소를 쓴 이력이 있어 의심해볼 만하다는 경고일 뿐입니다 — 실제 처리 전 반드시 사람이 다시 확인하세요.
블랙리스트 표시 행이 동시에 출고중지(`출고중지여부`='취소')이면, 행 배경은 그대로 검정을 유지하지만 글자색은 빨간색(취소)이 우선해서 표시됩니다.
주소를 너무 짧게 등록하면 정상 주문까지 검정으로 표시될 수 있습니다. 동/호수까지 구분이 필요한 경우에도 매칭 자체는 기본 주소 기준이라는 점(위 6번)을 감안하고, 등록 후 주문관리 화면을 새로고침해 표시 여부를 확인합니다.
상태 요약 뱃지와 행 색상 표시
주문관리 상단 `선택한 컬럼 데이터` 입력칸 오른쪽에 전체/선택/처리/중복/블랙/취소 건수가 뱃지로 표시됩니다. 각 상태는 행의 왼쪽 세로 줄과 글자색으로도 구분됩니다.
화면에 로드된 페이지가 아니라, 현재 조회 중인 날짜 범위 전체(페이지 무관)를 기준으로 집계됩니다. 예: 페이지당 100건만 보여도, 블랙 매칭 건이 134번째 행에 있으면 뱃지에도 정확히 반영됩니다.
전체=데이터가 있는 행(빈 행 제외). 처리=주문번호가 입력된 행. 중복=판매사이트 주문번호+상품명+주문선택사항이 같은 다른 행이 있는 행. 블랙=블랙리스트 매칭. 취소=출고중지여부가 '취소'인 행. 선택=체크박스로 선택한 행 수(클라이언트 값).
처리/중복/블랙/취소 뱃지를 누르면 해당 상태만 걸러서 보여줍니다(날짜 범위 등 다른 조건은 그대로 유지). 같은 뱃지를 다시 누르거나 `전체`를 누르면 필터가 풀립니다.
초록 세로줄=처리. 회색 세로줄+회색 글자=송장출력완료(플레이오토 업로드 완료 — 처리보다 나중 단계라 처리와 겹치면 회색이 우선). 빨간 세로줄+행 전체 빨간 글자=취소(출고중지). 검정 배경+흰 글자=블랙리스트 의심 매칭(위 블랙리스트 안내 참고). 파란 배경=체크박스로 선택한 행.
취소와 블랙리스트가 동시에 해당하면, 행 배경은 블랙리스트(검정)를 유지하지만 글자색과 왼쪽 세로줄은 취소(빨강)가 우선합니다. 처리와 송장출력완료가 동시에 해당하면 송장출력완료(회색)가 우선합니다(더 나중 단계이기 때문).
`주문수량`이 2개 이상이면 숫자에 노란 배지가 붙어 한눈에 띄게 강조됩니다.
로스/구매정보/송장 연동
주문관리 행은 다른 기능의 기준 데이터입니다. 자동입력, 구매정보 입력, 송장수집, 로스관리 전송이 같은 행의 주문번호, 수령자, 주소, 결제 정보, 송장 정보를 사용합니다.
마켓 주문 상세에서 `돈생역전입력`을 누르면 주문관리의 결제플랫폼, 결제카드, 결제ID, 결제가, 결제URL, 판매처명, 사업자명/번호 같은 칸을 채우는 데 사용합니다.
송장수집이 DB에 저장되면 주문관리의 `택배사`, `송장번호`, `주문송장번호`, `플토송장업로드` 확인 흐름으로 이어집니다. 수집 성공 문구가 아니라 실제 저장값을 확인합니다.
행의 `📤` 버튼은 수령자, 연락처, 배송주소, 상품명, 결제가 등 필수값으로 로스 케이스를 생성합니다. 전송된 행은 로스관리 탭에서 후속 처리합니다.
복수 선택과 복수 붙여넣기
주문관리 시트는 엑셀처럼 여러 셀을 선택하고 붙여넣을 수 있습니다.
- 첫 셀을 클릭합니다.
- 마우스로 드래그하거나 범위를 선택합니다.
- 엑셀, 구글시트, 메모장 등에서 복사한 값을 붙여넣습니다.
- 행과 열이 맞는지 확인합니다.
- 저장 후 새로고침해서 붙여넣은 값이 유지되는지 확인합니다.
오른쪽 아래 모서리 드래그 복사
셀을 선택하면 오른쪽 아래에 작은 핸들이 표시됩니다. 핸들을 아래로 드래그하면 선택한 셀 값을 같은 열의 다음 행으로 복사하고, 값 끝이 숫자이면 구글시트처럼 숫자 증가 패턴으로 채울 수 있습니다. Ctrl을 누른 상태에서는 숫자 처리 방식을 전환해 고정 복사 또는 증가 복사를 선택할 수 있습니다.
붙여넣기 결과가 예상과 다르면 즉시 같은 범위를 다시 선택해 올바른 값으로 덮어씁니다.
주문자 자동입력
구매 마켓 화면에서 MX 플로팅 버튼을 열고, 주문관리의 미처리 주문 정보를 배송지 입력 화면에 자동으로 넣는 기능입니다. 자동입력 후에는 반드시 마켓 화면에서 수령자, 연락처, 주소, 배송메모를 확인합니다.
Extension Settings
확장프로그램 설정
MX 플로팅 버튼의 설정 메뉴에서 사용할 마켓, 상세주소 입력 방식, 표시/주문입력 단축키를 정합니다. 체크된 마켓만 바로가기와 주문자 입력에 사용됩니다.
1. 플로팅 버튼 메뉴에서 `설정`을 엽니다.
2. 사용할 마켓을 체크하고, 순서 화살표로 플로팅 버튼 표시 순서를 조정합니다.
3. `대표 상세주소 입력 방식`에서 `상세주소` 또는 `상세주소+(배송문의 고객전화번호)`를 선택합니다.
4. 거리, 버튼 간격, 아이콘 크기, 방향 각도와 단축키를 조정한 뒤 `개인 설정 저장`을 누릅니다.
Step 01
마켓 화면 우측 MX 플로팅 버튼 확인
구매 마켓에 로그인한 뒤 화면 우측에 표시되는 MX 플로팅 버튼 위치를 확인합니다. `주문자 N건`을 누르면 입력 가능한 주문 목록이 열립니다.
- 1. `주문자 N건`은 현재 자동입력 대기 주문 수입니다.
- 2. `주문자 N건`을 눌러 목록을 열고, 각 주문의 `입력`으로 해당 주문의 배송지 정보를 마켓 입력칸에 넣습니다.
- 3. `설정`에서 주문자 입력 단축키를 켜면 1~9, 0 키로 1~10번째 주문 입력을 시작할 수 있습니다.
- 4. 플랫의 `내 연락처`에 번호를 입력하면 주문입력 설정의 연락처 번호에도 저장됩니다.
Step 02
주문 상세 확인 후 입력
주문 행을 펼치면 수령자, 전화번호, 기본주소, 상세주소를 확인할 수 있습니다. 주소가 맞는 주문만 `입력` 또는 `결제` 흐름으로 진행합니다.
1. 현재 마켓과 주문자 건수를 확인합니다.
2. `입력`은 선택 주문의 수령자/연락처/주소를 자동 입력합니다.
3. `결제`는 입력 확인 후 결제 단계로 이동할 때 사용합니다.
4. 주문 상세를 펼친 상태에서 `블랙리스트 제보`를 누르면 해당 주문의 의심 주소를 바로 제보할 수 있습니다.
Step 03
배송지 추가 화면이 나오면 먼저 `+ 배송지 추가하기`
마켓에 기존 배송지가 없거나 배송지 변경 모달이 뜨면 자동입력 전에 `+ 배송지 추가하기`를 먼저 누릅니다. 배송지 입력칸이 열린 뒤 주문자 목록의 `입력`을 실행해야 주소가 들어갑니다.
입력 후 확인 기준
- 수령자 이름이 주문관리의 주문자와 일치하는지 확인합니다.
- 휴대폰 번호와 안심번호가 마켓 입력칸에 정상 반영됐는지 확인합니다.
- 기본주소와 상세주소가 분리되어 들어갔는지 확인합니다.
- 배송메모가 필요한 주문은 메모까지 입력됐는지 확인합니다.
확장 플랫 기능
구매 마켓 화면 오른쪽의 플랫 `W`/RS 버튼은 마켓 바로가기, 주문자 자동입력, 송장수집, 주문 카드 보조 기능을 한곳에서 실행하는 확장 도구입니다.
Floating Button
플랫 `W`/RS 버튼에서 실행하는 기능
화면 오른쪽의 `rs-float-container` 안에 메인 버튼, `송장수집` 버튼, `주문자 N건` 버튼이 함께 표시됩니다.
메인 버튼을 누르면 `openShortcutOverlay()`가 열리고, 등록된 마켓 바로가기 버튼을 부채꼴로 펼칩니다.
`송장수집` 버튼은 `invoiceBtn`이며, 클릭하면 `MANUAL_INVOICE_COLLECT` 메시지를 보내 수동 송장수집을 요청합니다.
`주문자 N건` 버튼은 `orderBtn`입니다. 목록에서 `입력`을 누르면 `startQueuedOrderInput()`이 선택 주문을 자동입력 상태로 저장하고 입력을 시작합니다.
자동입력이나 송장수집이 진행 중이면 메인 버튼이 `중지`로 바뀌며, 주문 입력 상태(`rs_auto_input`)를 지우거나 `STOP_INVOICE_COLLECT`를 보냅니다.
Shortcut Settings
마켓 바로가기와 부채꼴 버튼 설정
바로가기 설정은 `rs_fab_shortcut_settings`에 저장되고, 설정창 id는 `rs-shortcut-settings-modal`입니다.
1. `설정`에서 사용할 마켓을 체크합니다. 일반 사용자는 마켓명과 URL을 읽기 전용으로 보고, `사용` 체크와 ▲/▼ 순서만 조정합니다.
2. 메인 버튼을 누르면 `rs-fan-overlay`에 선택된 마켓 버튼이 펼쳐지고, 각 버튼은 해당 마켓 URL을 새 탭으로 엽니다.
3. `거리`, `버튼 간격`, `아이콘 크기`, `방향 각도 미세조정` 슬라이더로 부채꼴 위치와 크기를 조정합니다. 아이콘 크기는 `icon_size_px` 값입니다.
4. 설정창의 실시간 미리보기는 `buildShortcutPositionOffsets()`와 `positionShortcutOverlayButtons()` 기준으로 실제 펼침 위치를 보여줍니다.
Hotkeys
표시/숨김 단축키와 주문 입력 단축키
단축키는 설정창의 `단축키 설정` 영역에서 바꾸며, 저장 시 크롬 로컬 저장소에 반영됩니다.
`rs_fab_toggle_hotkey`는 플랫을 숨기거나 다시 표시하는 키입니다. 기본값은 `Alt+Shift+H`이며, Ctrl/Alt/Shift 중 하나 이상을 포함해야 저장됩니다.
`rs_order_input_hotkey_settings`를 켜면 선택한 수식키와 `1~9`, `0` 조합으로 1~10번째 주문 입력을 시작합니다.
`shouldIgnoreGlobalFabHotkeyTarget()` 기준에 따라 INPUT, TEXTAREA, SELECT, 편집 가능한 영역에서는 플랫 단축키가 실행되지 않습니다.
우클릭 메뉴의 `버튼 숨기기`는 `rs_fab_hidden`을 저장하고 `applyFabVisibility()`로 플랫 전체를 숨깁니다. 다시 표시할 때는 설정한 표시 단축키를 사용합니다.
Address Detail
상세주소와 배송메모 자동입력
카카오 주소검색 결과를 선택한 뒤 이어지는 단계에서 상세주소와 배송메모를 다시 입력합니다.
`ORDER_STEP_TEMPLATE`의 `4.상세+메모` 단계에는 `address_detail` 입력과 `delivery_memo` 선택이 포함됩니다.
`resolveValue()`는 주문 주소에서 상세주소를 분리해 `address_detail`에 넣고, 주문의 배송메모를 `delivery_memo` 값으로 사용합니다.
대표 상세주소 입력 방식은 `address_detail` 또는 `address_detail_with_phone` 중 선택할 수 있습니다.
`address_detail_with_phone`은 상세주소 뒤에 설정한 전화번호 문구와 고객 전화번호를 붙여 입력합니다.
Order List Tools
주문 카드에서 함께 제공되는 보조 기능
`주문자 N건` 목록을 열면 주문 입력 외에도 확인·복사·결제·제보 기능을 사용할 수 있습니다.
`내 연락처` 입력칸은 `rs_order_phone`에 저장되고, 로그인 상태에서는 `/api/auth/order-phone`에도 저장을 요청합니다.
주문 상세의 수령자, 전화번호, 우편번호, 기본주소, 상세주소, 메모 값은 클릭하면 클립보드에 복사됩니다.
결제카드 입력칸은 카드 후보를 열고, 선택·직접 입력한 값은 주문관리 `결제카드` 값으로 저장됩니다.
`결제` 버튼은 `triggerPaymentAutoClick()`으로 네이버 또는 ESM 결제 버튼 자동 클릭 흐름을 실행합니다.
`블랙리스트 제보`는 선택 주문의 주소, 이름, 전화번호와 제보 사유를 `/api/blacklist/report`로 보냅니다.
각 주문의 `×` 버튼은 현재 큐 저장소에서 해당 주문을 제거하고 목록을 다시 그립니다.
우클릭 메뉴에서 일반 사용자가 보는 항목
- `설정`: `openShortcutSettingsModal()`을 열어 사용 마켓, 상세주소 방식, 버튼 거리/간격/크기/각도, 표시·주문입력 단축키를 바꿉니다.
- `버튼 숨기기`: `applyFabVisibility(true)`를 실행하고 `rs_fab_hidden`을 저장해 플랫 전체를 숨깁니다.
돈생역전입력 (구매정보 자동입력)
구매 마켓 주문내역에서 주문번호, 결제정보, 판매처 정보를 읽어 주문관리 시트의 구매정보 컬럼에 자동으로 입력하는 기능입니다. 배송지 입력용 `주문자 자동입력`과 별도 기능입니다.
Naver Buy Info
네이버 주문내역에서 주문관리 입력
네이버 주문내역에서 각 주문 카드 위의 `주문관리 입력`을 누르면 주문관리 시트 행과 매칭해 구매정보를 채웁니다. 이미지의 주문번호, 주소, 금액, ID, URL, 사업자번호는 모자이크 처리했습니다.
- 1. 네이버 주문내역에서 주문별 `주문관리 입력` 버튼을 누릅니다.
- 2. 오늘 일치 행이 없으면 후보 모달에서 주문일, 수령자, 상품, 주소를 보고 입력할 주문관리 행을 선택합니다.
- 3. 주문관리에는 `결제플랫폼`, `결제ID`, `결제URL`, `주문번호`, `결제일자`, `판매처명`, `사업자명`, `사업자등록번호`가 자동 입력됩니다.
Payment Card
플랫 주문 카드의 결제카드 선택
플랫 주문 카드에서 결제카드를 드롭다운으로 선택하거나 목록에 없는 카드명을 직접 입력할 수 있습니다. 선택한 값은 주문관리 `결제카드` 컬럼에 저장됩니다.
주문관리 `결제카드` 컬럼에 값이 있으면 플랫 주문 카드에도 같은 카드명이 기본값으로 표시됩니다.
결제카드 입력칸을 클릭하면 카드사 후보가 열립니다. 후보를 선택하면 해당 주문 행의 `결제카드` 컬럼에 저장됩니다.
드롭다운에 없는 카드나 메모성 카드명은 텍스트로 직접 입력할 수 있습니다. 입력 후 저장된 값은 다음에 플랫을 열 때 기본값으로 보입니다.
플랫에서 바꾼 결제카드는 서버에 저장되며, 주문관리 화면이 열려 있으면 해당 행의 `결제카드` 값도 갱신됩니다.
송장수집 (자동)
수집 전 참고 — 주문관리 컬럼과 결제플랫폼 표기
송장수집은 주문관리시트의 아래 컬럼을 기준으로 동작합니다. 특히 결제플랫폼과 주문번호가 채워져 있어야 수집됩니다.
① 송장수집이 참고하는 컬럼
| 컬럼명 | 용도 | 입력/자동 |
|---|---|---|
| 결제플랫폼 | 구매한 마켓(송장을 조회할 곳)을 식별합니다. 아래 표기 중 하나로 입력. | 입력 필요 |
| 주문번호 | 구매 마켓의 주문번호. 이 번호로 택배사·송장번호를 조회합니다. | 입력 필요 |
| 택배사 | 수집 결과로 자동 기록되는 택배사명. | 자동 기록 |
| 주문송장번호 | 수집 결과로 자동 기록되는 송장(운송장)번호. | 자동 기록 |
② 결제플랫폼 칸에 입력하는 플랫폼 이름 (송장수집 지원 마켓)
아래 마켓만 송장 자동수집을 지원합니다. 결제플랫폼 칸에 대표 표기 또는 허용 표기 중 하나를 입력하면 됩니다.
| 대표 표기 | 허용 표기(아무거나 입력 가능) |
|---|---|
| 네이버 | 네이버, 스마트스토어 |
| G마켓 | G마켓, 지마켓, gmarket |
| 옥션 | 옥션, auction |
| 11번가 | 11번가, 11st |
| 올리브영 | 올리브영, oliveyoung |
| SK스토아 | SK스토아, sk stoa, skstoa |
| 쇼핑엔티 | 쇼핑엔티, shoppingnt |
| 롯데온 | 롯데온, lotte on, lotteon |
| 신세계라이브쇼핑 | 신세계쇼핑, 신세계TV쇼핑, 신세계라이브쇼핑 |
| SSG | SSG, SSG닷컴, 신세계몰 |
| 롯데홈쇼핑 | 롯데홈쇼핑, lottehomeshopping |
| 현대Hmall | 현대Hmall, 현대몰, hmall |
| NS홈쇼핑 | NS홈쇼핑, ns홈쇼핑, nsmall |
| 하이마트 | 하이마트, highmart |
| 홈앤쇼핑 | 홈앤쇼핑, homeandshopping |
| 오늘의집 | 오늘의집, ohouse |
| GS SHOP | GS SHOP, gsshop |
| 코스트코 | 코스트코, costco |
| KT알파쇼핑 | KT알파쇼핑, KT알파, ktalpha, kt alpha, K쇼핑 |
| 전자랜드 | 전자랜드, electroland |
| CJ온스타일 | CJ온스타일, CJONSTYLE, cjonstyle, cj onstyle |
※ 결제플랫폼 표기가 위 마켓과 다르거나 미지원 마켓이면 결과에 `불일치`로 표시되고 송장이 수집되지 않습니다.
크롬 확장프로그램에서 송장수집 실행
구매 마켓에 로그인한 뒤 확장 팝업 또는 MX 플로팅 버튼에서 송장수집을 실행합니다.
1
- 1. 확장프로그램 팝업에서 `수동 송장 수집`을 누릅니다.
- 2. 마켓 화면에서는 MX 플로팅 버튼을 열어 `송장수집`을 실행합니다.
- 3. 현재 로그인된 구매 마켓 기준으로 택배사와 송장번호를 찾습니다.
- 4. 수집된 값은 서버 저장 후 주문관리의 택배사, 송장번호 셀에 반영됩니다.
송장 수집 결과 확인
수집이 끝나면 마켓별 결과가 표시됩니다. 수집 건수는 `0건 수집`처럼 숫자와 함께 확인합니다.
해당 마켓에서 이번 실행으로 저장할 송장이 없거나, 조건에 맞는 주문이 없다는 의미입니다.
주문관리의 구매마켓 정보와 현재 로그인한 마켓이 다르거나, 지원 마켓 판정이 맞지 않을 때 표시됩니다.
성공한 송장은 주문관리 탭의 `택배사`, `송장번호` 셀에 자동 반영됩니다.
판매처에 송장 자동입력
수집된 송장을 판매처 관리자 페이지에 입력할 때 사용합니다.
- 1. 판매처 관리자 페이지로 이동합니다.
- 2. 확장프로그램에서 송장 자동입력을 실행합니다.
- 3. 미입력 송장 목록을 확인합니다.
- 4. 판매처 화면에 택배사와 송장번호가 정확히 입력됐는지 확인합니다.
추적상품 개발중
추적상품 탭은 위치만 안내합니다.
현재 가격추적/가격 이력 수집 기능은 개발중이므로 실제 사용 절차로 안내하지 않습니다. 기능이 완성되기 전까지는 상품소싱 리서치와 마진계산 기능만 사용 기준으로 봅니다.
상품소싱과 마진계산
1. 리서치 표에서 후보 상품 가격 비교
1
2
3
4
- `리서치` 탭에서 후보 상품을 입력합니다.
- `컬럼설정`은 보일 마켓 컬럼과 순서를 조정하고, `+ 리서치 행 추가`는 비교할 상품 행을 추가합니다.
- `가격변동참고`에는 비교 기준이나 확인 메모를 적습니다. 옆의 그래프 아이콘은 전체 가격 추적 그래프를 엽니다.
- 네이버, 에누리, 쿠팡 등 마켓별 가격 칸 옆 아이콘은 해당 마켓의 날짜별 가격 이력 입력 창을 엽니다.
2. 마켓별 가격 이력 입력
1
2
3
- `+ URL 행 추가`는 같은 마켓 안에서 비교할 상품 URL을 추가합니다. `+ 날짜 열 추가`는 날짜별 가격 기록 칸을 늘립니다.
- 각 URL 행에 날짜별 가격을 입력하면 그래프에서 선으로 표시됩니다. 같은 마켓에 여러 URL이 있으면 범례는 `URL 1`, `URL 2`처럼 구분되고, 그래프 아래 매핑 목록에서 어떤 URL인지 확인합니다.
- 그래프 점에 마우스를 올리면 URL 구분값과 전체 URL, 해당 날짜의 가격 기록이 함께 표시됩니다.
- `저장`을 누르면 해당 마켓의 가격 이력이 리서치 행에 반영되고, 가장 낮은 가격은 `최저가` 계산에 사용됩니다.
3. 마진계산기에서 판매가 확인
1
2
3
4
- `마진계산기` 탭으로 이동하면 리서치 행의 상품명과 최저 매입가가 계산 표로 이어집니다.
- `매입가(원)`은 리서치 표의 최저가 기준으로 계산에 사용됩니다.
- `목표마진율(%)`을 바꾸면 스마트스토어, 톡스토어, 오픈마켓, 쿠팡 등 판매처별 권장 판매가가 다시 계산됩니다.
- `엑셀 내보내기`로 현재 소싱/마진 계산 결과를 파일로 저장할 수 있습니다.
베스트상품
베스트상품은 마켓별 인기 상품을 빠르게 훑고 상품소싱 후보를 찾는 화면입니다. 여기서 바로 판매가를 확정하지 말고, 후보를 고른 뒤 상품소싱의 리서치/마진계산으로 이어서 검토합니다.
Best Products
인기 상품 목록 확인
마켓별 인기 상품명, 가격대, 노출 흐름을 보면서 소싱 후보를 찾습니다. 화면을 훑을 때는 상품명만 보지 말고 판매가, 카테고리, 반복 노출 여부를 같이 확인합니다.
1. 반복해서 보이는 상품군은 소싱 후보로 따로 기록합니다.
2. 가격이 너무 낮거나 옵션이 복잡한 상품은 마진계산 전까지 확정하지 않습니다.
베스트상품을 소싱 후보로 넘기는 기준
- 1. 상품명 또는 대표 키워드를 상품소싱 리서치 행에 입력합니다.
- 2. 네이버, 에누리, 쿠팡 등 구매 후보 마켓 가격을 비교합니다.
- 3. 가격 이력 그래프가 필요한 상품은 날짜별 가격을 저장합니다.
- 4. 마진계산기에서 배송비, 수수료, 목표마진율을 넣고 판매 가능 여부를 판단합니다.
수집과 추세 확인
수집. 확장프로그램 팝업의 `베스트 상품 수집`(deoreborn84 전용 수집기 브라우저)으로 마켓별 베스트 상품을 저장합니다. 서버는 수집하지 않고 저장/공유만 합니다. 저장 건수가 0이면 해당 마켓 페이지 구조나 로그인 상태를 확인합니다.
목록. 베스트상품 화면은 저장된 상품의 마켓, 순위, 상품명, 가격, 상품 URL, 썸네일을 보여줍니다. 썸네일이 이벤트 이미지로 보이면 실제 상품 페이지 링크를 다시 확인합니다.
추세. `트렌드` 데이터는 반복 노출되는 상품군을 찾는 데 사용합니다. 하루만 오른 상품보다 여러 번 노출되는 상품을 우선 검토합니다.
관련 API. 주요 API는 `/api/best-products/collect`, `/api/best-products`, `/api/best-products/trends`입니다.
핫딜
핫딜은 커뮤니티 특가 정보를 보고 단기적으로 가격이 내려간 상품을 찾는 화면입니다. 특가 상품은 수량, 쿠폰, 배송비 조건이 자주 바뀌므로 캡처된 가격만 믿지 말고 실제 구매 페이지에서 다시 확인합니다.
Hot Deals
특가 상품 후보 확인
핫딜 목록에서 상품명, 특가 가격, 판매처, 게시 시점, 품절 가능성을 확인합니다. 오래된 글은 가격이 바뀌었을 가능성이 높으므로 우선순위를 낮춥니다.
1. 가격이 좋아 보여도 쿠폰 조건, 배송비, 옵션가를 실제 페이지에서 다시 확인합니다.
2. 품절 또는 가격 변경 가능성이 큰 상품은 상품소싱 가격 이력에 메모를 남깁니다.
핫딜 상품 검토 순서
- 1. 핫딜 목록에서 후보 상품을 고르고 실제 구매 링크를 확인합니다.
- 2. 현재 구매가, 배송비, 쿠폰 적용 가능 여부를 상품소싱 리서치에 기록합니다.
- 3. 가격변동 그래프에 날짜별 가격을 추가해 일시 특가인지 반복 특가인지 봅니다.
- 4. 마진계산 후 판매처 수수료를 반영해 실제 판매 가능한 가격인지 판단합니다.
공통 키워드, 실시간 검색/수집, 즐겨찾기
공통 키워드. 자주 찾는 키워드(예: 햇반, 기저귀)를 상단에 저장해 둡니다. 저장한 키워드 칩을 클릭하면 아래 검색창에 들어가 그 키워드 하나로 검색됩니다.
개별 키워드. 소스 관리에서 커뮤니티 소스마다 개별 키워드를 따로 지정할 수 있습니다. 비우면 공통 키워드를 사용합니다.
지원 소스. 기본 소스는 네이버 카페와 뽐뿌, 클리앙, 루리웹, 퀘이사존, 펨코, 아카 커뮤니티입니다. 소스 관리에서 URL, 활성 여부, 최소 조회수/추천수 기준을 확인합니다.
실시간 검색/수집. `키워드 즉시 수집`은 공통 키워드와 검색창 키워드를 합쳐 활성 소스를 바로 검색하고 결과 요약을 보여줍니다. 커뮤니티는 최신 목록을 최대 3페이지까지 훑고, 네이버 카페는 최신글 범위에서 키워드를 적용합니다. 확장프로그램이 설치·활성화되어 있어야 합니다.
정기 수집. 각 소스의 `수집 주기(분)`가 지나면 해당 소스만 수집합니다. 커뮤니티는 여러 페이지를 저장 대상으로 훑고, 네이버 카페는 마지막 수집 글 이후 새 글을 여러 페이지 확인해 누락을 줄입니다.
보관/검색. 수집된 핫딜은 180일 보관되며, 검색창 키워드로 저장 데이터에서 다시 찾을 수 있습니다. 검토할 상품은 즐겨찾기로 따로 관리합니다.
관련 API는 `/api/hotdeals/collect`, `/api/hotdeals`, `/api/hotdeals/search`, `/api/hotdeals/favorites`, `/api/hotdeals/{id}/favorite`, `/api/hotdeal-sources`입니다.
가격변동 그래프 개발중
가격변동 그래프는 아직 사용 기능으로 안내하지 않습니다.
현재 화면 탭은 남겨두되, 가격추적 그래프·가격 이력 입력·추적상품 연동 설명은 개발 완료 전까지 사용가이드에서 제외합니다.
수익분석
수익분석은 주문관리 시트에 저장된 값을 그대로 집계해 보여주는 화면입니다. 리셀은 주문이 들어와도 가격/수량 문제로 전부 처리하지 못할 수 있으므로, 받은 주문 전체의 매출액과 별개로 실제 구매·발송을 완료한 주문의 매출(실매출)과 처리율을 중심으로 봅니다.
지표 기준 (주문관리 컬럼 참조)
총매출액은 기간 내 모든 주문의 `판매가` 합입니다. 실매출은 구매 `주문번호`가 입력된(발주 완료) 주문의 `판매가` 합으로, 상태가 `취소`류인 행은 제외됩니다. 미발주 필터와 같은 기준입니다.
처리 완료 건수 ÷ 주문 건수 × 100. 받은 주문을 얼마나 소화했는지 보는 핵심 지표입니다.
완료 주문의 `마진금액` 합과, 마진 ÷ 실매출 × 100입니다. 날짜는 `주문일` 기준으로 묶입니다.
최근 7/30/90일/1년 프리셋을 고르면 시작일·종료일이 자동 입력되고, 직접 날짜를 지정할 수도 있습니다. 일간/주간/월간을 바꾸면 표와 그래프가 해당 단위로 묶입니다.
일별 로그표와 팀 선택
날짜·요일별 주문건수, 매출액, 처리건수, 실매출, 건수처리율, 마진, 마진율을 표로 보여주고 맨 아래 노란 합계행이 붙습니다. 매출액 vs 실매출 그래프와 건수처리율 선으로 처리 흐름을 한눈에 봅니다.
관리자 계정은 상단 팀 선택 버튼으로 팀을 검색해 복수 선택하면 선택한 팀 전체의 데이터를 합쳐 봅니다. 일반 계정은 자기 팀 데이터만 표시됩니다.
로스관리
케이스 목록과 등록
반품, 오배송, 택배사고, 파손 등 손실 케이스를 등록합니다. 주문번호, 마켓, 상품, 수량, 결제금액, 귀책, 담당자를 함께 입력합니다.
여러 건은 가져오기 기능으로 등록합니다. 가져온 뒤 누락된 주문정보와 비용 항목을 목록에서 다시 확인합니다.
상태, 담당자, 팀, 기간 조건으로 케이스를 좁혀 봅니다. 담당자가 바뀌면 상세 화면에서 담당 저장을 눌러 기록합니다.
잘못 등록한 케이스는 삭제할 수 있습니다. 삭제 전 이미 처리 이력이나 정산 근거로 사용 중인지 확인합니다.
케이스 상세 처리
`시작`, `다음 단계`, `이전` 버튼으로 처리 단계를 이동합니다. 단계 변경은 이력에 남기고, 필요한 경우 메모에 근거를 남깁니다.
종결 유형을 선택한 뒤 `종결 확정`을 누릅니다. 최종 로스 금액은 브라우저 임의 계산이 아니라 서버 계산 기준으로 확인합니다.
회수 상품을 재판매, 폐기, 보류 등으로 처리하고 `재판매 처리 저장`을 누릅니다. 처리 결과는 케이스 상세와 로그에서 확인합니다.
정상 단계로 종결할 수 없는 예외 케이스는 `강제종결`을 사용합니다. 닫힌 케이스를 다시 진행해야 하면 `케이스 재개`를 사용합니다.
팀, 관리자 통계, 로그
로스팀을 만들고 초대 링크를 복사/재발급합니다. 팀 PIN 저장, 멤버 승인, 멤버 제거, 팀 삭제는 권한이 있는 계정만 처리합니다.
관리자는 전체 통계, 월별 통계, 사용자별/팀별 현황을 봅니다. `오늘 등록 일괄 삭제`는 테스트나 오등록 정리용이므로 실행 전 대상 날짜와 건수를 확인합니다.
로그 화면에서 누가 어떤 케이스를 수정했는지 확인합니다. 금액, 담당자, 종결 상태가 예상과 다르면 상세 이력과 로그를 함께 봅니다.
주요 API는 `/api/loss/cases`, `/cases/import`, `/cases/export.xlsx`, `/cases/{id}/history`, `/cases/{id}/force-close`, `/teams`, `/logs`, `/admin/stats`, `/admin/monthly-stats`, `/admin/today-delete`입니다.
엑셀 출력
로스관리 상단의 `엑셀 출력` 버튼은 현재 검색/팀/탭 필터에 맞는 케이스를 내려받습니다. 출력 파일에는 로스관리 DB 전체 컬럼과 `잠정로스`, `최종로스`, `재판매대기`, `재판매이익` 컬럼이 함께 포함됩니다.
구독, 팀, 권한
- `구독` 메뉴에서 현재 플랜과 만료일을 확인합니다.
- STANDARD 카드 안의 기간 선택에서 `월구독`, `6개월 구독`, `12개월 구독` 중 하나를 고릅니다.
- 6개월/12개월처럼 장기 기간을 선택하면 할인 배지, 취소선이 있는 기간 기준 정가, 월 환산 금액이 함께 표시됩니다.
- 이름이 저장되어 있어야 `구독하기`로 결제를 시작할 수 있습니다. 이름을 바꾸었다면 먼저 저장한 뒤 진행합니다.
- 팀원 추가 카드는 구독 기간과 수량을 선택해 필요한 좌석만큼 추가 구독합니다.
추가로 확인할 기능
- 마켓 슬롯은 기본 슬롯과 추가 구매 슬롯을 합산해 적용됩니다.
- 결제 직후에는 `승인 대기` 상태가 보일 수 있으므로, 구독 상태가 활성화되었는지 확인합니다.
- 팀원은 구매한 좌석 수 안에서 추가할 수 있으며, 사용 중인 팀원과 추가 가능 인원은 구독 화면에서 확인합니다.
- PRO는 가격추적 개발 후 제공 예정으로 표시되며, 현재 구독 버튼은 비활성 상태입니다.
설정과 마켓 계정
- `마켓 계정`은 주문수집 API 설정이 아닙니다.
- 현재는 가격추적, 송장수집, 마켓 자동로그인 보조 용도로만 이해하면 됩니다.
- 주문 자동입력에 사용할 본인 CS/전환번호는 `마켓 계정 > 주문입력 설정 > 주문입력용 연락처 번호`에 저장합니다. 플랫의 `내 연락처`에 입력해도 같은 값으로 저장됩니다.
- 주문을 서버 API로 수집하려면 반드시 `주문수집 API (서버 API 연동)` 탭에서 등록합니다.
- 확장이 마켓에서 동작하지 않으면 웹 로그인, 확장 로드 상태, 현재 크롬 프로필을 먼저 확인합니다.
주문 자동입력용 연락처 번호
수령인 연락처에 기본으로 넣을 본인 CS/전환번호를 여기에 저장합니다. 주문자 자동입력 시 이 번호가 기본 연락처로 사용됩니다. 플랫 주문자 목록의 `내 연락처` 입력칸에서 저장해도 이 설정값에 반영됩니다.
설정 화면에서 헷갈리기 쉬운 부분
- `마켓 계정`은 송장/배송 수집, 가격추적, 마켓 자동로그인 보조 계정입니다.
- `주문수집 API`는 서버가 직접 주문을 수집하기 위한 API 키 저장소입니다.
- 쿠팡 출고중지조회, 주문수집 화면의 서버 수집은 `주문수집 API` 계정이 연결되어야 정상 동작합니다.
- 마켓 계정 저장 후에도 마켓 로그인 쿠키가 끊기면 확장 기능은 다시 로그인해야 합니다.
알림과 AI 상담
알림
- 상단 우측 알림 아이콘을 누르면 최근 알림 목록이 열립니다.
- 읽지 않은 알림 수가 배지로 표시됩니다.
- 주문 관련 경고가 있으면 연결된 페이지로 이동해 확인합니다.
AI 상담
- 우측 하단 AI 상담 버튼을 누릅니다.
- 사용가이드, 오류 상황, 기능 위치를 질문합니다.
- 답변을 확인하고 필요한 화면에서 실제 상태를 다시 검증합니다.