환경설정 시스템 전체 설정 관리
사이트 정보
회사명
시스템에 표시될 회사명
대표자명
법인 대표자
사업자등록번호
필수 — 세금계산서 자동반영 (XXX-XX-XXXXX)
법인등록번호
법인 등기상 번호 (선택)
사업장 주소
대표 이메일
대표 전화
서비스 URL
로고 업로드
jpg/png/svg/webp · 2MB 이하
파비콘
ico/png · 500KB 이하
결제수단
신청서 결제 시 사용할 내부 잔액과 외부 결제수단을 관리합니다. 차감 순서는 아래 순서 카드에서 조정합니다.
결제 차감 순서
위에서 아래 순서로 결제금액을 차감
외부 결제 연동
TossPayments Client Key
카드/간편결제 화면 호출용 공개 키
TossPayments Secret
서버 결제 승인용 비밀 키
PayPal 사용
해외 고객 결제 허용
혼합결제 허용
예치금+카드 등 분할 결제
G예치금 (Deposit)
회원이 미리 충전해 두고 배송비, 구매대행, 부가서비스, 관부가세 대납 비용을 차감하는 내부 선불금입니다. 잔액이 부족한 신청서는 별도 미납·출고보류 정책에서 처리합니다.
충전수단
회원이 G예치금을 충전할 때 허용할 결제수단
G포인트 (Point)
VAT 환급, 보상, 운영 보정 등으로 지급하는 포인트입니다. 만료와 소멸 알림 기준을 관리합니다.
VAT환급 지급비율
고객 G포인트 지급 비율 (기본 10%)
%
유효기간
발급일로부터 N일 후 소멸
일
소멸 알림
포인트 만료 전에 알림 발송
일 전
G캐시 (Cash)
이벤트, 추천인, 프로모션 등 혜택성 잔액입니다. 현금성 예치금과 구분해서 운영합니다.
이벤트 자동지급
사용 최소금액
원
추천인 보상
서비스 ON/OFF
OFF로 저장하면 고객 마이페이지의 신규 신청 접수가 차단됩니다. 관리자/스태프의 기존 신청서 처리와 출고 업무는 계속 가능합니다.
미납·출고보류 정책
결제대기 신청서가 오래 남지 않도록 알림, 출고보류, 자동 정리 기준을 관리합니다.
미납 알림 주기
결제 만기 후 선택한 시점에 알림
일 후
미납 알림 활성화
자동 출고보류 전환
미결제 N일 경과 후 자동 출고보류
일
자동 정리 보류일
미결제 N일 경과 후 관리자 목록에서 숨김 처리
일
🤖 재고 자동화 설정
ℹ️ 보관료 정책 통합 이전 안내
· 무료보관 기간 / 센터별 일단가 → 센터별 부가서비스 단가 → STORAGE (보관료) 로 이전.
· 센터별 N구간 단가 (T0 무료기간 / T1 단계 / T2 일단가) 로 더 정밀하게 설정 가능합니다.
· 본 섹션은 장기보관 경고·예치금 자동차감 등 자동화 정책 전용입니다.
장기보관 경고 기준
N일 이상 미반출 시 데드스톡 알림 (workers/deadstockWorker)
일
예치금 자동차감
월말 정산 시 보관료를 예치금에서 자동 차감
🏭 배송센터 관리 국가별 센터 / VAT / 통화 / 처리 기능
0건
순번국가센터 부가세통화 시간대현지법인 처리기능사용 정책 수정

💡 모든 화면에서 이 마스터 데이터를 동적 로드합니다 (1분 이내 자동 반영).
💡 VAT율은 센터별로 관리 — 같은 국가의 다른 센터(예: 일본 창고 0% vs 풀서비스 10%) 차등 가능.
💡 정책 컬럼 — 💰 VAT환급 · 🛃 세관신고 · 🏛 관부가세 모두 ✏️ 수정 모달의 4개 탭에서 관리.

센터별 무게/부피 측정 장비 tenant_settings.center_measurement_devices
센터 코드별 JSON입니다. 1차는 manual/keyboard를 즉시 지원하고, serial/network_api/local_bridge는 같은 구조로 연결됩니다.
수수료·거래처 바로가기
판매처/매입처는 이 탭 아래쪽에 있어 바로가기를 추가했습니다.
💰 VAT·세관·관부가세 통합설정 (센터별)
ℹ️ 배송센터 관리 모달로 통합 이전

센터별 VAT/세관/관부가세 정책은 기본설정 → 🏭 배송센터 관리 → ✏️ 수정 의 4개 탭 에서 관리합니다:
· 📋 기본 — 코드/이름/국가/VAT율/통화/시간대/담당법인/처리기능
· 💰 VAT 환급 — 환급가능 토글, 분배비율(고객/현지/한국), G포인트, 배송대행 VAT환급
· 🛃 세관신고 — 구매대행/배송대행/재고발송 단가 방식
· 🏛 관부가세 — 면세한도/관세율/예치금 자동차감/에스컬레이션/건기식 경고

→ 배송센터 관리로 이동
💳 구매대행 수수료
처음부터 구매대행으로 접수된 신청서와, 배송대행/배대지 신청 중 센터가 대신 상품을 구매·결제하는 건에 공통으로 적용하는 수수료입니다. 센터별 · 결제수단별 · 회원등급별로 정액/정률 기준을 다르게 설정합니다. 판매처 수수료는 아래 판매처 수수료 관리에서 쇼핑몰별로 관리합니다.
개인: lv8 기본 → lv1 우수 VIP: 관리자 수동 우수 사업자: BIZ3 기본 → BIZ1 우수
최소 수수료원
최대 수수료 상한원 (0=무제한)
기준금액 이하는 정액, 기준 초과는 구매금액 × 정률로 청구합니다.
🚚 무게별 배송비 통합 계단식 누적 · 개인/사업자 베이스 + 센터 지불 원가 + 등급별 할인율
ℹ️ 계단식 누적 모델 — 각 구간의 가격은 "증가무게(kg) 1 step 당 가산 금액"입니다 (총가격 X). 여러 구간이 같은 증가무게(예: 0.5kg)를 공유할 수 있고, 단가만 다릅니다.
  예) 1.5kg 배송비 계산: ~0.5(step=0.5, +12,500) + ~1(step=0.5, +1,200) + ~3까지 1 step(+2,200) = 15,900
  예) 990kg 배송비 계산: ~30까지 누적(176,100) + ~990 구간 960 step × 8,000 = 7,856,100 (마지막 구간 step=1kg)
  아래 미리보기 표에서 누적 결과 자동 갱신.
원가 통화
환율 (1 → KRW)
캐리어
서비스 타입
무게~ (kg) 증가무게(kg) 👤 개인 베이스 🏢 사업자 베이스 🏭 센터 지불
(증가단위당)		 개인 마진 사업자 마진 센터 마진
(평균)
💡 등급별 가격은 배송비 등급 체계에 등록된 등급과 등급별 배송비 할인율을 베이스 요금에 적용해 자동 계산됩니다. 개인 등급은 개인 베이스, BIZ1~BIZ3 사업자 등급은 사업자 베이스를 사용합니다.
증가무게: kg 💡 한 번 클릭으로 누적 표 작동 확인 가능
단일 미리보기: kg → -
📊 누적 배송비 (계산 결과) — 구간 정의 변경 시 자동 갱신
🎯 배송비 등급 체계 개인 lv1~lv8 + VIP · 사업자 BIZ1~BIZ3 단계 운영
ℹ️ 개인은 lv8(기본) → lv1(우수), 사업자는 BIZ3(기본) → BIZ1(우수) 단계로 운영합니다. VIP는 관리자 수동 지정 등급이며, 등급별 실제 할인율은 아래 등급별 배송비 할인율에서 설정합니다.
코드 표시명 (label) 등급 조건 필요 기준값 우선순위 사용
🔄 등급 자동 변경 정책 — 회원 등급이 언제·어떻게 변경되는지 결정
마지막 정책 변경: -
💸 등급별 배송비 할인율 표준요금 × (1 − 할인율%) = 등급별 청구가
적용 범위:
💡 0% = 할인 없음 (표준요금 그대로 청구). 등급별 셀에 할인율 % 입력 후 저장.
센터별 부가서비스 단가 센터별 청구/지불 단가표
옵션명, 옵션코드, 카테고리, 과금단위, 사용 여부는 부가서비스 관리에서만 수정합니다. 이 화면에서는 선택된 옵션의 센터별 단가, 통화, 구간 가격만 관리합니다.
옵션: — — 항목 관리
옵션을 선택하면 과금방식과 입력 화면이 자동으로 적용됩니다. 관리자는 아래 센터별 단가만 입력하면 됩니다. 옵션을 선택하세요.
배송센터 부과기준 (T0 무료 / T1 단계 / T2 추가) — 고객 · 센터 동시
💡 데이터 단일 진실: option_service_pricing_tiers · 부가서비스 관리의 항목 원본과 연결 · 저장 시 GENERATED 마진 자동 · 음수 마진 차단 (Hard Stop)
🤝 파트너 단가 통합 이전됨
⚠️ 이 섹션의 항목들은 더 정밀한 화면으로 분산 이전되었습니다 (2026-05-05)
파트너 단가의 5개 항목을 역할별 단일 진실 화면으로 이전:
옛 항목 → 이전 위치 이유
구매수수료율 (%) 매입처 관리 · purchase_vendors.vendor_fee_rate 매입처마다 차등 (%)
판매수수료율 (%) 판매처 수수료 · sales_marketplace_fees.market_fee 채널별 차등 (네이버/쿠팡/11st...)
현지배송비 (EUR) 🛠 센터 부가서비스 → 🚚 현지배송비 옵션 LOCAL_SHIPPING (A 정액)
송금수수료 (EUR) 🛠 센터 부가서비스 → 💸 송금수수료 옵션 REMITTANCE_FEE (A 정액)
추가수수료 (EUR) 🛠 센터 부가서비스 → 💼 파트너 기타 수수료 옵션 PARTNER_EXTRA (A 정액)
🛠 센터 부가서비스로 이동 정산 카테고리에 3 옵션 (LOCAL_SHIPPING / REMITTANCE_FEE / PARTNER_EXTRA) 신규 추가됨
기존 데이터는 어떻게 되나요?
• tenant_settings.partner_rates JSON 데이터 보존 (롤백 대비)
• 기존 GET /api/config/partner_rates 는 동작 (그대로 호환)
• 신규 등록은 부가서비스 관리 / 매입처관리 / 판매처수수료 화면 사용 권장
• 마진 계산 코드 폴백: 새 위치 → 없으면 옛 partner_rates JSON 참조
배송비 할인
적용 기준
구분 하한 (원) 상한 (원) 개인 등급별 할인율 (%) 사업자 등급별 할인율 (%)
lv3 lv4 lv5 lv6 lv7 실버 골드 플래티넘
상한이 없으면 비워두세요 (마지막 구간) · 구분 변경 시 비활성 컬럼은 회색
서비스 설정
배송비 계산 기준
청구무게 = Max(실무게, 부피무게)
목록통관 한도
USD
합포장 최대 박스 수
박스
소수점 처리
VAT환급 배송비 설정
처리비 — BMnT
EUR
처리비 — GSP
EUR
처리비 — GVF
EUR
처리비 — BL
EUR
처리비 — IT
EUR
현지GSP 지급비율
%
VAT환급 최소금액
EUR
배송대행 VAT환급
관부가세 설정
목록통관 면세 한도
USD
부가세 10% 자동적용
예치금 자동차감
미납 에스컬레이션 D+N
국가별 기본 관세율
국가코드관세율 (%)
독일DE
프랑스FR
영국GB
이탈리아IT
일본JP
🛒 판매처 수수료 관리 코스모스 호환 - 오픈마켓 × 샵아이디 × 카테고리
🔄
코스모스 동기화 대기 중
0건
순서코드 오픈마켓샵아이디 국가 쇼핑몰 조정합마켓수수료 행사율조정율 달러관세기준관세율 분류정보분류코드 소스관리

💡 코스모스 형식 100% 호환 (배수 형식: 1.05 = 5%)
💡 조정율 = 마켓수수료 × 행사율 (자동 계산)
💡 조정합 = 더해지는 KRW 값 (예: 10000, -1000)
💡 🔒 잠금된 행은 코스모스 동기화 시 보호됨

🏪 매입처 관리 구매 국가의 쇼핑몰 (AboutYou·Zalando·Selfridges 등)
0건
No국가매입처명사이트 매입처수수료(%)추가수수료(%) 현지배송료송금수수료(원) 통화연결센터 VAT환급사용관리

💡 구매대행 신청서에서 URL 입력 시 등록된 매입처 자동 매핑됩니다.
💡 엑셀 컬럼: 매입처명·사이트URL·국가코드·센터코드·매입처수수료·추가수수료·현지배송료·송금수수료·통화·VAT환급·메모·사용

17TRACK 통합 배송조회 연동 배송/통관 버튼 공통 조회 엔진
ℹ️ 배송 버튼과 통관 버튼은 모두 17TRACK 조회 결과를 사용합니다.
· 배송: 전체 배송 이벤트 표시
· 통관: 17TRACK 이벤트 중 세관/통관 관련 내용을 필터링 표시
· 코스모스는 상품 URL·단가·이미지·품절·코드 매칭 전용으로 사용합니다.
연동 사용
API Key
Webhook Secret
17TRACK 웹훅 검증용 비밀값
Webhook URL
17TRACK 관리자 화면에 등록
운송장 자동등록
상태 자동반영
테스트 모드
🇰🇷 국내 운송장번호 대역대 국내 택배사 자동 채번 · 잔여 부족 시 알림 ＋ 대역 추가 (신규 페이지)
ℹ️ 국내 택배사 (CJ대한통운 / 우체국 / 한진 / 롯데 / 로젠 / 경동 등) 의 발급받은 운송장 대역을 등록.
· 잔여 1,000건 미만 → 경고 / 소진 시 출고 자동 차단
· 배송조회/통관조회는 위 17TRACK 통합 연동을 사용
신규 운송장 대역 현황 0건 대역 관리 열기
택배사 센터 1차 대역 2차 대역 전체 사용 잔여 상태
로딩 중...
💱 환율 관리 매매기준율 + 송금 스프레드 = 실제 송금환율
ℹ️ 매매기준율 + 송금 스프레드 = 송금환율
· 매매기준율 — 한국은행 ECOS (USD/JPY/EUR/GBP 자동) / 그 외 수동 입력
· 송금 스프레드 (%) — 시중은행 가산 (예: EUR 1.5%) — 실제 송금 시 적용
· 송금환율 = 매매기준율 × (1 + 스프레드%) — 마진 계산은 이 값 사용 권장
로딩 중...
자동 갱신 (ECOS)
마지막 ECOS 갱신: -
알림 설정

알림템플릿 페이지(/alerts.html)에서 관리합니다

🌳 품목분류 EU/한국 세관신고 자동화 — 영문명 + HS 코드 + 세율
ℹ️ HS 코드 = 국제 표준 (앞 6자리 동일)
· 🌐 HS 6자리 (예: 4202.21) = WCO 국제 표준 — 한국/독일/일본 모두 동일
· 🇪🇺 CN 8자리 (예: 4202.21.10) = EU 통합 (독일/이탈리아 등 모든 EU 국가 동일)
· 🇰🇷 HSK 10자리 (예: 4202.21.0000) = 한국 세부 — 입력 필드
→ 한국 HSK 10자리만 입력하면 EU CN 8자리 / 국제 HS 6자리 자동 도출
선택 후 [＋ 자식] / [✏ 수정] / [✕ 삭제] 0건
트리에서 항목 선택
권한 설정

권한 설정은 준비 중입니다

외부 API / Worker ON-OFF
꺼진 API는 수동 호출도 차단되고, 꺼진 Worker는 다음 주기부터 실행을 건너뜁니다. 설정값이 없으면 기존 운영 영향 방지를 위해 ON으로 동작합니다.
외부 API 호출 허용
Worker 자동화 허용
외부 API 연동
샵링커 API Key
샵링커 고객사코드
샵링커 로그인 계정
샵링커 API URL
샵링커 쇼핑몰 코드 리스트 경로
샵링커 쇼핑몰 코드 XML URL
신규주문 조회 경로
주문상세 조회 경로
송장등록 경로
쇼핑몰 송장전송 경로
주문 XML URL
클레임 수집 경로
CS 수집 경로
CS 처리 경로
타임아웃(ms)
코스모스 API Key
코스모스 API URL
코스모스 Timeout(ms)
AllTalk API URL
AllTalk API Key
AllTalk Sender Key
AllTalk SMS URL
AllTalk SMS Sender
AllTalk Timeout(ms)
Naver TalkTalk Reply Endpoint
Naver TalkTalk Access Token
Naver TalkTalk API Key
Naver TalkTalk Channel ID
Naver TalkTalk Timeout(ms)
Kakao Channel Reply Endpoint
Kakao Channel Access Token
Kakao Channel API Key
Kakao Channel ID
Kakao Channel Timeout(ms)
UNI-PASS API Key
UNI-PASS REST URL
UNI-PASS Timeout(ms)
한국은행 ECOS Key
🤖 Claude AI (Anthropic)
Anthropic Claude API 연동. 키 미설정 시 모든 AI 기능은 자동으로 OFF (폴백).
API Key
기본 모델
월 사용량 한도 (USD)
⚙️ 자동화 기능 ON/OFF
각 기능은 독립 ON/OFF. API Key 미설정이면 ON 이어도 자동 폴백.
파손 자동 감지
입고/출고 사진 분석 (사고 자동 등록)
송장 OCR
송장/인보이스 이미지 → 텍스트 자동 추출
상품 분류 자동화
신규 상품 → HS코드/카테고리 자동 추천
문의 자동 응답
FAQ 매칭 → 1차 자동 답변 (담당자 검수 후 발송)
이상 거래 감지
패턴 분석 → security_anomalies 자동 등록
마진 이상치 알림
역마진/저마진 자동 감지 → 알림 발송
📊 AI 사용 통계 (이번 달)
통계 표시는 ai_usage_logs 테이블 추가 후 연결 예정.