영카트5 플러그인
배송 어디쯤 왔나요?
이제 주문상세에서 바로 보여주세요
운송장번호만 입력하면 현재 배송 상태와 이동 이력이
고객 주문상세와 관리자 주문상세에 자동으로 표시됩니다.
| 영카트5 5.5 ~ 5.6 PHP 5.6 ~ 8.x |
PC · 모바일 · 관리자 주문상세 3개 화면 지원 |
스마트택배 API 무료 키로 시작 가능 |
이런 경험 있으신가요?
하루에도 몇 번씩 받는 배송 문의
| "제 택배 어디 있어요?" 전화, 게시판, 톡으로 들어오는 배송 문의에 운송장을 하나씩 조회해 답하고 계십니다. |
고객은 쇼핑몰을 떠납니다 [배송조회] 링크를 누르면 택배사 사이트로 이동합니다. 운송장번호를 다시 입력해야 할 때도 있습니다. |
관리자도 번거롭습니다 주문 처리 중에 배송 상황을 보려면 택배사 조회 화면을 따로 열어야 합니다. |
배송상태 자동조회를 설치하면
주문상세 [배송정보] 에
[배송상태] 한 줄이 생깁니다
아래는 실제 쇼핑몰에 적용된 화면입니다. (개인정보는 가렸습니다)
| 현재 상태 배지 | 배송준비중 / 집화완료 / 배송중 / 지점도착 / 배송출발 / 배송완료 를 한눈에 보여줍니다. |
|---|---|
| 이동 이력 | 시각, 장소, 처리 내용을 최신순으로 보여줍니다. 배송기사 연락처가 있으면 함께 표시합니다. |
| 새로고침 | 고객이 직접 최신 상태를 다시 조회할 수 있습니다. (5분 간격, 배송완료 후에는 숨김) |
주요 기능
운영자가 신경 쓸 일을 줄였습니다
 |
운송장만 입력하면 자동 조회 관리자가 평소처럼 배송회사와 운송장번호만 입력하면 됩니다. 고객이 주문상세를 열 때 현재 배송 상태와 이동 이력이 자동으로 표시됩니다. |
 |
고객 PC · 모바일 · 관리자 화면 모두 지원 고객 주문상세(PC, basic 테마, 모바일)와 관리자 주문상세에 같은 모양으로 표시됩니다. 비회원 주문조회로 들어온 고객도 볼 수 있습니다. |
 |
조회 결과 저장으로 API 호출 절약 같은 운송장은 배송 중 30분, 배송완료 90일 동안 저장한 결과를 보여줍니다. 하루 호출 상한도 설정할 수 있어 무료 키의 한도를 아낍니다. |
 |
간단한 설치, 깔끔한 삭제 폴더 2개를 올리고 주문상세 파일에 코드 몇 줄만 넣으면 됩니다. 파일 하나만 지우면 기능이 꺼지고, 넣어 둔 코드는 오류 없이 그대로 둘 수 있습니다. |
| 주문상세가 느려지지 않습니다 화면을 먼저 보여주고 배송 상태는 뒤에서 따로 불러옵니다. 택배사 조회가 늦어도 주문상세는 바로 열립니다. |
조회가 실패해도 빈 화면이 아닙니다 택배사 조회가 안 되거나 하루 한도를 넘으면 저장해 둔 이전 결과를 "이전 조회 결과" 로 보여줍니다. |
| 원인은 관리자에게만 보입니다 API 키 없음, 지원하지 않는 배송회사, API 오류 내용은 관리자 주문상세에만 표시하고 고객에게는 일반 안내 문구만 보여줍니다. |
남의 주문은 조회할 수 없습니다 영카트 주문상세와 같은 기준으로 권한을 확인합니다. (최고관리자, 주문내역 권한이 있는 부관리자, 주문한 회원 본인, 비회원 주문조회) |
화면 미리보기
고객 화면과 관리자 화면
고객 주문상세 (PC)
고객 주문상세 (모바일)
관리자 쇼핑몰설정 - 배송조회 API 키 입력
※ 위 3개 화면은 이해를 돕기 위한 예시 화면이며, 실제 모양은 사용하시는 테마의 표 디자인을 따릅니다.
동작 방식
필요할 때만 조회합니다
| 상태 | 저장한 결과를 보여주는 시간 |
|---|---|
| 배송 중 | 30분 |
| 배송완료 | 90일 |
| 택배사에 아직 등록되지 않은 운송장 | 10분 |
| 하루 실제 호출 상한 (쇼핑몰 전체) | 500회 |
※ 모든 값은 설정 파일(config.php)에서 사이트에 맞게 바꿀 수 있습니다.
지원 택배사
주요 택배사 5곳 기본 지원
| CJ대한통운 | 우체국택배 | 한진택배 | 로젠택배 | 롯데택배 |
주문에 입력한 배송회사 이름에 "대한통운", "CJ", "우체국", "한진", "로젠", "롯데" 가 들어 있으면 자동으로 조회합니다. (공백, 대소문자 무시)
스마트택배가 지원하는 다른 택배사는 설정 파일에 한 줄만 넣으면 추가할 수 있습니다.
설치 방법
3단계면 끝납니다
| 01 파일 올리기 plugin, extend 폴더를 사이트에 그대로 올립니다. 기존 파일과 겹치지 않습니다. |
02 주문상세에 코드 넣기 원본 그대로 쓰는 사이트는 동봉된 6개 파일을 덮어쓰고, 수정한 사이트는 매뉴얼의 코드를 붙여 넣습니다. |
03 API 키 입력 관리자 쇼핑몰설정의 [배송설정] 에 스마트택배 API 키를 입력하면 바로 동작합니다. |
그림과 함께 설명한 설치 매뉴얼(PDF)이 들어 있고, 테마나 스킨을 고쳐 쓰는 사이트를 위해 넣을 코드와 위치를 파일별로 안내합니다.
설치 환경
| 지원 버전 | 영카트5 5.5 ~ 5.6 (그누보드 5.5 ~ 5.6 + 쇼핑몰) 덮어쓰기용 수정파일은 5.6.41 기준이며, 다른 버전은 코드를 직접 넣는 방법으로 설치합니다. |
|---|---|
| PHP | PHP 5.6 이상 (7.x, 8.x 포함), curl 확장 필요 |
| 배송조회 API | 스마트택배(스윗트래커) 배송조회 API 키가 필요합니다. 무료 키가 있으며 호출 횟수 제한이 있습니다. 2026-10-30 부터 적용되는 POST 전용 방식으로 호출합니다. |
| 서버 | data/cache 폴더 쓰기 권한 (그누보드 기본 설치 상태면 이미 있습니다) |
| 구성 파일 | 플러그인 폴더(plugin/wz.delivery_track), extend 파일 1개, 덮어쓰기용 수정파일 6개, 설치 매뉴얼 |
자주 묻는 질문
Q. 스마트택배 API 키는 어떻게 받나요?
tracking.sweettracker.co.kr 에 가입 후 발급받습니다. 키 발급과 이용 조건은 스마트택배 정책을 따르며, 이 상품에 키는 포함되어 있지 않습니다.
Q. 테마와 스킨을 많이 고친 사이트에도 설치할 수 있나요?
가능합니다. 주문상세 파일 두 곳에 코드를 넣는 방식이라, 사용 중인 테마의 주문상세 파일에 매뉴얼의 코드를 그대로 넣으면 됩니다.
Q. 오래된 주문도 조회되나요?
택배사 정책에 따라 3개월이 지난 운송장번호는 조회되지 않을 수 있으며, 화면에도 같은 안내 문구가 표시됩니다.
Q. 나중에 삭제하기 어렵지 않나요?
extend 폴더의 파일 하나만 지우면 기능이 꺼집니다. 넣어 둔 코드는 플러그인이 없으면 아무 동작도 하지 않습니다.
기타 안내사항
- 구매하신 프로그램은 불법복제, 재판매가 불가합니다.
- 구매 후 1년간 업데이트 지원을 받으실 수 있으며, 1년 경과(365일) 이후 업데이트 지원 종료 및 다운로드가 제한됩니다.
- 프로그램에 대한 커스터마이징 작업은 별도 제작의뢰를 하시기 바랍니다.
- 솔루션 기반의 설치형 프로그램일 때 원본 프로그램의 수정이 많이 이루어진 경우 설치에 장애가 생길 수 있습니다.
- 사용이 가능한 빌더로 별도 표기되지 않은 빌더는 설치 및 사용이 불가할 수 있습니다.
- 고객님의 프로그램 추가, 변경, 수정에 의해 발생된 오류는 고객지원 대상이 아니며 제작의뢰를 통해서 유상처리 됩니다.
- 모든 판매 프로그램은 제품 특성상 초기 다운로드 이후부터는 환불 및 교환이 절대 불가합니다. (공정거래위원회 표준 약관에 의함)
영카트5 배송상태 자동조회 v1.0.0
BY WETOZ
- 구매하신 프로그램을 불법복제,재판매 불가합니다.
- 구매 후 3년간 업데이트 지원을 받으실 수 있으며 3년경과(1095일) 이후 업데이트 지원 종료 및 다운로드가 제한됩니다.
- 구매 후 1년이내 기술문의지원 가능하며 이후 유료 비용으로 상담지원 가능합니다.
- 프로그램에 대한 커스터마이징 작업은 별도 제작의뢰를 하시기 바랍니다.
- 솔루션기반의 설치형 프로그램 일때 원본 프로그램의 수정이 많이 이루어진 경우 설치에 장애가 생길 수 있습니다.
- 사용이 가능한 빌더로 별도 표기되지 않은 빌더는 설치 및 사용이 불가할 수 있습니다.
- 고객님의 프로그램 추가,변경,수정에 의해 발생된 오류는 고객지원 대상이 아니며 제작의뢰를 통해서 유상처리 됩니다.
- 모든 판매 프로그램은 제품 특성상 초기 다운로드 이후부터는 환불 및 교환이 절대 불가합니다. (공정거래위원회 표준 약관에 의함)
상품문의가 없습니다.