워드프레스 플러그인

한국 택배 운송장을 우커머스에 제대로 붙이기

주문에 운송장번호를 등록하면 고객이 클릭 한 번으로 택배사 조회 페이지에 도착합니다. 국내 택배사 8곳을 지원하는 무료 플러그인을 만들었습니다.

OSC 한국형 운송장 관리v1.0.0GPL 라이선스

왜 만들었나

우커머스로 국내 쇼핑몰을 운영하면 반드시 막히는 지점이 있습니다. 상품을 보내고 나서 고객에게 운송장번호를 알려줘야 하는데, 우커머스에는 한국 택배사라는 개념이 없습니다. 해외 배송사 목록만 들어 있고, 그마저도 국내 택배사는 CJ대한통운 정도가 겨우 끼어 있는 수준입니다.

그래서 대부분의 국내 쇼핑몰이 운송장번호를 주문 메모에 손으로 적거나, 고객에게 문자로 따로 보냅니다. 고객은 번호를 복사해서 택배사 홈페이지를 직접 찾아 들어가 붙여넣습니다. 네이버나 쿠팡에서는 한 번만 누르면 되는 일입니다.

이 플러그인은 그 격차를 없애는 것 하나만 합니다. 주문 화면에서 택배사를 고르고 운송장번호를 입력하면, 고객은 주문 메일과 내 계정 화면에서 조회 버튼을 보게 됩니다. 누르면 해당 택배사의 조회 결과 페이지가 새 창으로 열립니다.

지원 택배사

국내에서 실제로 많이 쓰이는 8곳을 넣었습니다. 자릿수는 각 택배사가 자기 홈페이지에서 실제로 검증하는 기준을 따랐습니다.

택배사	운송장 자릿수	바로가기
CJ대한통운	10 또는 12	지원
우체국택배	13	지원
한진택배	10 · 12 · 14	지원
롯데택배	9 – 14	지원
로젠택배	11	지원
경동택배	9 – 14	지원
GS25 편의점택배	9 – 14	지원
CU 편의점택배	9 – 14	조회 페이지

가장 공들인 부분은 링크가 깨지지 않는 것

고객이 배송조회를 눌렀는데 오류 페이지가 뜨면, 없느니만 못합니다. 그래서 개발하면서 가장 많은 시간을 쓴 곳이 택배사 조회 주소를 확인하는 일이었습니다.

국내 블로그에 널리 퍼져 있는 택배사 조회 주소를 하나씩 실제로 호출해 봤습니다. 상당수가 이미 죽어 있었습니다.

롯데택배널리 퍼진 linkView 주소는 운송장번호를 아예 무시합니다. 번호를 넣든 안 넣든 똑같은 화면이 나옵니다.

경동택배newDeliverySearch.kd 주소는 403 오류를 반환합니다.

CUlocalResult.cupost 주소는 404입니다. 페이지 자체가 사라졌습니다.

CJ대한통운예전에 쓰이던 nexs.cjgls.com은 도메인이 더 이상 존재하지 않습니다.

최종적으로 코드가 만들어내는 주소 8개를 전부 실제 택배사 서버에 요청해서 정상 응답을 확인했습니다. 이 검증은 자동 테스트로 고정해 두었습니다. 누군가 나중에 주소를 잘못 고치면 테스트가 실패합니다.

CU만 예외입니다

CU 편의점택배는 운송장번호로 바로 연결되는 링크를 제공하지 않습니다. 번호를 주소에 넣어도 무시하고 빈 결과 화면을 보여줍니다.

그래서 CU만은 조회 페이지로 이동시키고 운송장번호를 크게 함께 표시합니다. 고객이 번호를 복사해 넣는 한 단계가 더 필요합니다. 억지로 링크를 걸면 고객이 조회 결과 없음을 보게 되는데, 그게 더 나쁩니다.

메일은 언제 나가야 하나

만들면서 가장 고민한 부분입니다. 우커머스는 주문 상태가 바뀔 때 메일을 한 번 보냅니다. 그런데 실제 쇼핑몰은 운송장번호를 저녁에 몰아서 입력하는 경우가 많습니다. 그러면 배송완료 메일은 이미 나간 뒤라, 그 고객은 배송조회 링크를 영영 받지 못합니다.

두 가지 길을 모두 열어두는 것으로 해결했습니다.

• 운송장 등록 시 주문 상태 자동 변경. 등록하는 순간 상태가 바뀌면서 원래 나가던 메일에 배송조회가 실려 나갑니다. 메일 한 통으로 끝납니다.
• 배송 시작 안내 메일. 운송장을 등록하면 즉시 별도 메일이 나갑니다. 주문 상태를 언제 바꾸든 상관없습니다.

둘 다 켜면 고객이 메일을 두 통 받으니, 설정 화면에 그 경고를 함께 적어두었습니다. 메일 문구는 우커머스 이메일 설정에서 그대로 수정할 수 있고, 테마에서 템플릿을 덮어쓸 수도 있습니다.

택배사를 매번 고르지 않아도 됩니다

한 택배사만 쓰는 쇼핑몰이 대부분입니다. 그래서 설정에서 택배사를 자주 쓰는 순서대로 끌어 정렬할 수 있게 했습니다. 맨 위에 둔 택배사가 새 주문에서 자동으로 선택되어 있습니다. 운송장번호만 입력하고 버튼을 누르면 끝입니다.

보안

운송장번호는 저장 전에 숫자만 남기고 전부 지웁니다. 하이픈이나 공백이 섞인 채로 붙여넣어도 알아서 정리되고, 동시에 태그나 다른 주소를 끼워 넣는 공격이 구조적으로 불가능해집니다. 택배사 주소는 코드에 고정되어 있어 입력값이 주소를 바꿀 수 없습니다.

공격 시도 형태 6종을 테스트에 넣어 전부 무력화되는 것을 확인했고, 관리자 요청에는 권한 검사와 위조 방지 토큰을 모두 적용했습니다.

설치 정보

필요 환경워드프레스 6.5 이상, 우커머스 8.0 이상, PHP 7.4 이상검증 범위PHP 8.1 및 8.3에서 확인주문 저장 방식고성능 주문 저장소(HPOS) 호환언어한국어 번역 포함외부 통신없음. API를 쓰지 않고 데이터를 어디로도 보내지 않습니다라이선스GPL v2 이상, 무료

워드프레스 공식 플러그인 저장소에 등록을 신청해 두었습니다. 승인되면 관리자 화면에서 바로 검색해 설치하실 수 있습니다.

만든 곳 · OSC Studio
문의는 스튜디오 연락처로 주시면 됩니다.