🔗에이전트 연결 확인
에이전트 창 아래 상태 줄이 모두 초록이면 개통이 된 것입니다.
- 메인포스 PC(포스 먼저 설치)
- 서버코드 · API 키
상태 줄 읽기#
| 표시 | 정상 | 아니면 |
|---|---|---|
| 서버 | ●연결됨 | 인터넷 · API 키(401) 확인 |
| 로컬 8765 | ●사용 | '미사용' — 다른 프로그램이 8765 포트를 씀, 태블릿 · 동기화 모두 멈춤 |
| POS | ●가능 | 메인포스 판매 프로그램(백엔드)이 꺼짐 |
| 연동 · 업데이트 | 정상 · 최신 | 구버전 · 새 버전 — [업데이트 확인] |
| 매출 | N분 전 | 마지막 매출 전송 시각 |
서버코드 · API 키 다시 넣기#
- 1트레이의 SMARTPOS Agent 아이콘 → [열기] → 오른쪽 위 ⚙
- 2[서버 접속] 탭 — 서버 URL https://asp.posagent.kr, 서버코드, API Key
따로 설치했다면 서버 URL이 비어 있거나 localhost이니 꼭 고칩니다.
- 3[연결 테스트] — '✓ 인증완료 · 서버코드 ○○ (매장명)'
'✗ 인증 실패 (401)'이면 서버코드 · 키를 다시 확인합니다. 나온 매장명으로 대조하세요.
- 4[POS] 탭 — POS API 주소는 비워 둡니다 → [연결 테스트] '✓ POS 연결 OK'
- 5[저장]
서버 접속 값은 바로 적용, POS 주소 · 동기화 주기는 에이전트를 다시 켜야 적용됩니다.
머리줄 [동기화]는 지금 바로 전체 동기화(서버 메뉴 · 설정 → 포스, 매출 → 서버)합니다. 평소에는 2분마다 저절로 합니다.
원본 매뉴얼 자세히#
화면 그림의 번호 설명은 그림 바로 아래에 있습니다. 아래는 원본 매뉴얼의 나머지 내용입니다.
›📘 매장코드 · API 키 등록
에이전트 창 오른쪽 위 ⚙ → '설정' 창의 [서버 접속] 탭에서 서버와 연결합니다. 포스 마법사로 설치했다면 이미 들어가 있으니 확인만 합니다.
1. 트레이의 SMARTPOS Agent 아이콘 → [열기] → 머리줄 오른쪽 ⚙.
2. 서버 URL — https://asp.posagent.kr (따로 설치하면 비어 있거나 localhost 로 되어 있으니 꼭 고칩니다).
3. 서버코드(STORE_CODE) — 매장 등록 때 정한 서버코드(예: CS1005).
4. API Key — 매장 상세에서 받은 키(가려져 보입니다).
5. [연결 테스트] — '✓ 인증완료 · 서버코드 ○○ (매장명)'이면 맞습니다. '✗ 인증 실패 (401) · 서버코드/API Key 확인'이면 서버코드 · 키를 다시 확인합니다.
6. [POS] 탭 — 'POS API 주소'는 비워 둡니다(같은 PC 의 포스 = http://127.0.0.1:8900). [연결 테스트]에 '✓ POS 연결 OK · 매장명 · v버전'.
7. [저장] — '✓ 저장 완료' 뒤 창이 닫힙니다. 서버 접속 값은 바로 적용되고, POS 주소 · 동기화 주기는 에이전트를 다시 켜야 적용됩니다.
참고 — 서버에서 [API 키 재발급]을 하면 예전 키는 바로 무효입니다 — 에이전트에 새 키를 넣어야 '서버 ●연결됨'으로 돌아옵니다. 키는 이 PC 에 암호화해 저장됩니다.
자주 하는 실수 — 서버코드와 다른 매장의 API 키를 넣었다 — 401 로 실패합니다. [연결 테스트]에 나온 매장명으로 대조합니다.
›📘 에이전트 창 읽기 · 직접 동기화
에이전트 창 아래 모니터링 줄(2초마다 갱신)로 상태를 봅니다.
1. 서버 ●연결됨/끊김 · 로컬 ●8765(태블릿 · 직원 폰이 붙는 문) · 태블릿 n/n · 직원폰 · 주문 대기/실패.
2. POS ●가능/불가(포스 백엔드) · 연동 ●정상/구버전 · 업데이트 ●최신/새 버전 · 매출 N분 전(마지막 매출 전송).
3. 머리줄 [동기화] — 지금 바로 전체 동기화(서버 메뉴 · 설정을 포스로, 매출을 서버로). 테이블오더를 쓰는 매장은 켜질 때도 한 번 저절로 합니다(그 밖에는 주기 동기화 2분을 기다리거나 이 버튼).
4. [테이블오더] 탭 — 주문내역 · 메뉴구성 · 사이드메뉴 · 연결 태블릿 · 연결상태 확인. 오른쪽은 로그.
5. 상태바 v버전 · [업데이트 확인] — 새 버전이 있으면 받아 설치하고 다시 켜집니다(평소에는 10분마다 스스로 확인).
자주 하는 실수 — '로컬 ●미사용' — 8765 포트를 다른 프로그램이 쓰고 있습니다. 태블릿 연결과 포스 동기화가 모두 멈추니 그 프로그램을 끕니다.
'서버 ●끊김' — 인터넷 · API 키(401)를 확인합니다.
'POS ●불가' — 메인포스 판매 프로그램(백엔드)이 꺼져 있습니다.