# StoreSync 대리점 가이드

## 시작하기

- [대리점 가이드에 오신 걸 환영합니다](https://0.0.0.0:3100/api/site/5/md?path=%2Fwelcome): 매장 개통부터 운영 · 장애 대응까지, 설치 담당자가 현장에서 찾기 쉽게 정리했습니다.
- [매장 개통 순서](https://0.0.0.0:3100/api/site/5/md?path=%2Fopening-checklist): 처음부터 끝까지 이 순서대로 하면 빠지는 것이 없습니다.
- [방문 전 준비물](https://0.0.0.0:3100/api/site/5/md?path=%2Fbefore-visit): 현장에서 막히지 않게 출발 전에 챙길 정보와 파일입니다.
- [대리점 로그인 · 계정](https://0.0.0.0:3100/api/site/5/md?path=%2Flogin): asp.posagent.kr/agency/login — 첫 로그인 때 비밀번호를 바꿔야 다른 화면이 열립니다.
- [라이선스 확인 · 추가 요청](https://0.0.0.0:3100/api/site/5/md?path=%2Flicenses): 매장 1곳 × 기능 1개 = 라이선스 1개. 모자라면 본사에 요청합니다.

## 매장 개통

- [매장 등록](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fregister): 등록하는 순간 포스 라이선스 1개가 차감되고 API 키가 발급됩니다.
- [API 키 · 사장님 계정](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fapi-key): API 키는 등록 직후 한 번만 보입니다. 사장님 로그인은 비밀번호를 넣어야 열립니다.
- [설치 순서 — 포스 먼저, 에이전트는 함께](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Finstall-order): 메인포스 설치 마법사가 동기화 에이전트까지 깔고 매장코드 · API 키를 넣어 줍니다.
- [설치본 받기](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fdownload): 대리점 로그인 뒤 [시스템 게시판]에서만 받습니다.
- [메인포스 설치](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fmain-pos): 매장에 1대만. 매장 자료(DB)를 이 PC가 보관합니다.
- [오더포스 설치](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Forder-pos): 주문만 받는 추가 포스. 여러 대 가능하고 메인포스에 붙어 일합니다.
- [에이전트 연결 확인](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fagent): 에이전트 창 아래 상태 줄이 모두 초록이면 개통이 된 것입니다.
- [에이전트 따로 설치](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fagent-install): 포스 마법사가 함께 깔지 못했을 때(UAC 거절 등)나 다시 깔 때만.
- [동기화 옵션](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fagent-options): 이 PC에만 걸리는 값입니다. 보통은 그대로 둡니다.
- [프린터 연결](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fprinter): 영수증 프린터는 보통 시리얼(COM), 주방 프린터는 LAN으로 연결합니다.
- [출력 설정 · 메뉴별 프린터](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fprinter-output): 누가 출력할지(담당 포스), 어떤 메뉴를 어느 프린터로 보낼지 정합니다.
- [컵 라벨 프린터](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fcup-label): 음료 잔마다 주문번호 · HOT/ICE · 옵션을 찍은 라벨을 뽑습니다.
- [기준 매장에서 설정 불러오기](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fcopy-settings): 비슷한 매장의 메뉴 · 운영 설정을 한 번에 가져옵니다.
- [사장님께 넘기기](https://0.0.0.0:3100/api/site/5/md?path=%2Fsetup%2Fhandover): 개통 마지막 단계. 사장님이 혼자 쓸 수 있게 계정과 안내를 넘깁니다.

## 카드결제

- [카드결제 준비 · 안전 규칙](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Frules): 돈이 오가는 장비입니다. 설치 전에 순서와 지킬 것을 먼저 보세요.
- [서버에 VAN 설정](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Fserver-van): 서버 관리자 [매장 수정] → '카드결제 (VAN)' 구역. 포스마다 따로 정합니다.
- [VAN사 에이전트 받기](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Fdownload): [시스템 게시판 → VAN사 에이전트]에서 VAN사 · 기기에 맞는 설치파일을 받습니다.
- [KIS 설치 · 설정 (Windows)](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Fkis): KIS-NAGT를 카드를 받을 포스 PC마다 설치하고 가맹점 다운로드까지 합니다.
- [KOVAN 설치 · 설정 (Windows)](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Fkovan): VPos PlusLite를 C:\KOVAN에 설치합니다. 포스는 VPos를 직접 불러 승인합니다.
- [태블릿 카드결제 (KOVAN 안드로이드)](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Ftablet-card): 테이블오더 태블릿에서 주문과 동시에 카드 결제를 받습니다. 태블릿 전용 단말기번호가 필요합니다.
- [포스에서 연동 확인](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Fcheck): 실제 거래 없이 VAN 연결을 점검합니다. 맨 위에 '승인을 보낼 수 있습니다' 판정이 나옵니다.
- [시험 결제 · 승인 확인](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Ftest-pay): 점검표가 통과하면 매장 카드로 소액 결제를 하고 바로 반품합니다.
- [카드 오류 코드](https://0.0.0.0:3100/api/site/5/md?path=%2Fcard%2Ferror-codes): 결제가 거절되면 화면의 코드로 원인을 찾습니다.

## 주문 기기

- [테이블오더 · 직원 폰 앱](https://0.0.0.0:3100/api/site/5/md?path=%2Fdevices%2Ftable-order): 앱을 깔면 같은 와이파이의 메인포스를 스스로 찾습니다. 페어링 코드는 없습니다.
- [주방 화면 (KDS)](https://0.0.0.0:3100/api/site/5/md?path=%2Fdevices%2Fkds): 주방 모니터 · 태블릿 브라우저로 http://<메인포스 IP>:8900/kds 를 엽니다.
- [고객 호출 화면 (DID)](https://0.0.0.0:3100/api/site/5/md?path=%2Fdevices%2Fdid): 장비를 따로 사지 않아도 됩니다 — 듀얼모니터 · 태블릿/TV 박스 · 스마트 TV 중 고르세요.

## 운영 · 관리

- [매장 운영현황](https://0.0.0.0:3100/api/site/5/md?path=%2Fmanage%2Fstore-status): 담당 매장 중 문제가 있는 매장이 위로 옵니다. 매일 아침 한 번 보세요.
- [버전 · 자동 업데이트](https://0.0.0.0:3100/api/site/5/md?path=%2Fmanage%2Fupdates): 새 버전은 매장 단말이 스스로 받습니다. 재설치하러 갈 필요가 없습니다.
- [진단 로그](https://0.0.0.0:3100/api/site/5/md?path=%2Fmanage%2Flogs): 매장에 가지 않고 최근 24시간 로그를 받아 원인을 봅니다.
- [원격 지원 연결](https://0.0.0.0:3100/api/site/5/md?path=%2Fmanage%2Fremote): 매장의 [원격 지원] 버튼이 무엇을 띄울지 그 PC에서 정합니다.
- [본사에 요청 · 오류 접수](https://0.0.0.0:3100/api/site/5/md?path=%2Fmanage%2Frequest): 기능 요청 · 오류는 [요청 · 오류 접수]에서 본사에 올립니다.
- [근태 · 급여 · 시재 서버 화면](https://0.0.0.0:3100/api/site/5/md?path=%2Fmanage%2Fworkforce): 매장 포스의 출퇴근 · 급여 · 금고 기록을 서버에서 보고, 개통 때 설정을 대신 넣어 줍니다.

## 문제 해결

- [증상으로 찾기](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fstart): 매장에서 전화가 왔을 때 — 증상을 고르세요. 영업에 바로 영향을 주는 것부터 놓았습니다.
- [카드 결제 무응답](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fcard-no-response): 카드를 긁어도 응답이 없을 때
- [시험 출력은 성공인데 종이가 안 나옴](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fno-paper): 프린터 화면 [테스트 출력]이 '성공'인데 출력이 없을 때
- [같은 전표번호 오류](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fduplicate-receipt): 결제 · 주문 저장 때 전표번호 중복 오류가 날 때
- [에이전트 경고 띠 · 동기화 안 됨](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fagent-warning): 메인포스 위 빨간 띠: '동기화 에이전트가 실행되고 있지 않습니다'
- [오더포스가 메인포스를 못 찾음](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Forder-pos): 설치 마법사 · 로그인 화면의 찾기가 실패할 때
- [업데이트가 반복되거나 안 됨](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fupdate-loop): 같은 버전을 계속 설치하거나, 새 버전이 안 깔릴 때
- [근태 · 시재가 서버에 안 보임](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fworkforce-missing): "아직 올라온 … 없습니다"가 뜨거나 숫자가 오래됐을 때 — 버전 · 에이전트 · 전송 순서로
- [VCRUNTIME140_1.dll 오류](https://0.0.0.0:3100/api/site/5/md?path=%2Fhelp%2Fvcruntime): 깨끗한 Windows에서 실행이 막힐 때

## 새 소식

- [2026년 10월](https://0.0.0.0:3100/api/site/5/md?path=%2Fupdates%2F2026-10): VAN사 에이전트 장이 생기고, 근태 · 급여 · 시재를 서버에서 봅니다.
- [매뉴얼 변경 이력](https://0.0.0.0:3100/api/site/5/md?path=%2Fupdates%2Fmanual-history): 원본 대리점용 매뉴얼(PDF)의 판별 변경 내용입니다. 이 가이드는 v1.3을 바탕으로 다시 썼습니다.