영카트5 순정 환경에 설치하는 배송추적 및 배송완료 자동처리 플러그인입니다.
주문목록에 송장번호가 등록되면 배송상태를 조회하고,
배송완료 확인 후 설정한 유예시간이 지나면 주문을 자동으로 완료 처리할 수 있습니다.

■ 주요 기능
- 송장번호 등록 후 택배 배송상태 자동 조회
- 관리자 주문목록과 구매자 주문조회 화면에서 배송상태 확인
- 배송완료 확인 후 주문 자동 완료 처리
- 배송완료 유예시간 설정
- Tracker Delivery API 연동
- 설치 도메인별 라이선스 인증
- API 연결 상태, 인증정보 만료일 및 갱신 안내

■ 설치 전 준비
1. 순정 영카트5 설치 환경의 관리자 계정
2. 상품 구매 시 사용한 구매자 이메일 주소
3. Tracker Delivery API Client ID와 Client Secret
4. 판매자 확인 및 승인 후 자동 발급되는 라이선스

■ 설치 및 라이선스 인증 절차
1. 압축파일의 www 폴더 안 파일을 영카트 설치 루트에 업로드합니다. 기존 파일은 먼저 백업해 주세요.
2. 브라우저에서 https://구매자도메인/track/install.php 를 엽니다.
3. 상품 구매 시 사용한 구매자 이메일 주소를 입력하고 ‘라이선스 신청’을 클릭합니다. 주문 확인을 위해 구매 시 입력한 이메일과 설치 도메인을 정확히 입력해야 합니다.
4. 신청 정보가 판매자의 라이선스 관리자 페이지에 접수됩니다.
5. 판매자가 주문 내역을 확인하고 승인하면 해당 설치 도메인에 대한 라이선스 키가 자동 발급됩니다. 승인 전에는 임의의 키를 입력해도 인증되지 않습니다.
6. 설치 페이지를 열어 둔 상태라면 승인 후 자동으로 키가 저장됩니다. 설치 페이지를 닫았더라도 같은 사이트의 관리자 배송추적 설정 페이지를 다시 열면 승인 상태를 자동 확인하고 라이선스 키를 자동 저장합니다.
7. 따라서 구매자는 일반적으로 라이선스 키를 직접 입력할 필요가 없습니다.

■ API 인증정보 발급 및 입력
압축파일에 있는 install.md를 확인해주세요!

■ API 인증정보 유효기간 및 갱신
- 무료 API 자격증명은 등록일을 기준으로 21일 동안 사용할 수 있습니다.
- 관리자 설정 화면에 만료일과 연결 상태가 표시됩니다.
- 만료 전에는 관리자 화면에 갱신 안내가 표시됩니다.
- 만료되기 전에 Tracker Delivery 콘솔에서 새 인증정보를 발급하고 Client Secret을 관리자 설정에 다시 입력해 저장하세요.
- 새 Client Secret을 정상 저장하면 만료일이 다시 등록일 기준 21일로 자동 설정됩니다.
- 인증정보가 만료되면 배송상태 조회 및 자동 완료 처리가 중단될 수 있습니다.

■ 주의사항
- 라이선스는 설치 도메인 기준으로 인증되며 별도 쇼핑몰·별도 서버·복제 설치에는 별도 라이선스가 필요합니다.
- 구매자 이메일과 설치 도메인은 주문 확인에 사용되므로 정확히 입력해야 합니다.
- Client Secret과 라이선스 키를 타인에게 공개하지 마세요.
- 설치 완료 후 보안을 위해 /track/install.php 파일의 접근을 차단하거나 삭제하는 것을 권장합니다.
- 자동 주문완료 기능은 실제 운영 정책에 맞게 활성화하고 유예시간을 설정하세요.

■ 문제 해결
- 라이선스 신청이 승인 대기 중이면 판매자의 주문 확인 및 승인을 기다려 주세요.
- 승인 후에도 키가 보이지 않으면 관리자 배송추적 설정 페이지를 새로고침하세요.
- ‘연결 안 됨’이면 Client ID·Client Secret을 다시 확인하고 API 연결 테스트를 실행하세요.
- 만료 경고가 나오면 Tracker Delivery 콘솔에서 인증정보를 갱신한 뒤 Client Secret을 다시 저장하세요.