# 에이전트 연결 확인

> 에이전트 창 아래 상태 줄이 모두 초록이면 개통이 된 것입니다.

> **누가** 대리점 설치 기사 · **걸리는 시간** 10분
> **준비물** 메인포스 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분마다 저절로 합니다.

## 원본 매뉴얼 자세히

화면 그림의 번호 설명은 그림 바로 아래에 있습니다. 아래는 원본 매뉴얼의 나머지 내용입니다.

<details>
<summary>📘 매장코드 · API 키 등록</summary>

에이전트 창 오른쪽 위 **⚙** → '설정' 창의 **[서버 접속]** 탭에서 서버와 연결합니다. 포스 마법사로 설치했다면 이미 들어가 있으니 확인만 합니다.

**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 로 실패합니다. [연결 테스트]에 나온 매장명으로 대조합니다.
</details>

<details>
<summary>📘 에이전트 창 읽기 · 직접 동기화</summary>

에이전트 창 아래 **모니터링 줄**(2초마다 갱신)로 상태를 봅니다.

**1.** **서버 ●연결됨/끊김** · **로컬 ●8765**(태블릿 · 직원 폰이 붙는 문) · **태블릿 n/n** · **직원폰** · **주문 대기/실패**.

**2.** **POS ●가능/불가**(포스 백엔드) · **연동 ●정상/구버전** · **업데이트 ●최신/새 버전** · **매출 N분 전**(마지막 매출 전송).

**3.** 머리줄 **[동기화]** — 지금 바로 전체 동기화(서버 메뉴 · 설정을 포스로, 매출을 서버로). 테이블오더를 쓰는 매장은 켜질 때도 한 번 저절로 합니다(그 밖에는 주기 동기화 2분을 기다리거나 이 버튼).

**4.** [테이블오더] 탭 — 주문내역 · 메뉴구성 · 사이드메뉴 · 연결 태블릿 · 연결상태 확인. 오른쪽은 로그.

**5.** 상태바 v버전 · **[업데이트 확인]** — 새 버전이 있으면 받아 설치하고 다시 켜집니다(평소에는 10분마다 스스로 확인).

**자주 하는 실수** — '로컬 ●미사용' — 8765 포트를 다른 프로그램이 쓰고 있습니다. 태블릿 연결과 포스 동기화가 모두 멈추니 그 프로그램을 끕니다.
'서버 ●끊김' — 인터넷 · API 키(401)를 확인합니다.
'POS ●불가' — 메인포스 판매 프로그램(백엔드)이 꺼져 있습니다.
</details>