우리택배 조회 API

우리택배 소개

우리택배는 호남물류가 운영하는 택배 서비스로, 전라도 지역을 중심으로 지역 밀착형 배송 네트워크를 구축하고 있습니다. 고객센터 번호는 1588-7766이며, 공식 조회 페이지는 호남물류 홈페이지에서 확인할 수 있습니다.

송장번호 형식

우리택배 송장번호는 숫자 10자리로 구성됩니다. API 요청 시 하이픈(-) 없이 숫자만 입력해야 합니다.

API 연동 예시

아래 curl 예시로 우리택배 배송조회 API를 즉시 테스트할 수 있습니다. {API_KEY}와 {SECRET_KEY}는 발급받은 실제 키로 교체하세요.

curl -X POST https://api.deliveryapi.co.kr/v1/tracking/trace \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {API_KEY}:{SECRET_KEY}" \
  -d '{
    "items": [
      {
        "courierCode": "woori",
        "trackingNumber": "5035629174"
      }
    ]
  }'

배열 형식의 items를 사용하므로 한 번의 요청으로 여러 송장번호를 동시에 조회할 수 있습니다. 응답 형식 및 전체 API 명세는 API 문서를 참고하세요.

배송 상태 코드 매핑

우리택배는 내부적으로 SCANGB 코드를 사용하여 배송 단계를 구분합니다. 아래 표는 각 코드에 대응하는 배송 상태입니다.

SCANGB 코드	배송 상태	설명
05	상품준비중	판매자가 발송을 준비하고 있습니다.
10	집하상차	택배사가 물건을 수거하여 차량에 상차했습니다.
30	T/M출고	터미널에서 출고되어 이동 중입니다.
40	HUB T/M도착	허브 터미널에 도착했습니다.
50	영업소출고	배송 담당 영업소에서 출고되었습니다.
60	배송중	배송 기사가 배송 중입니다.
80	영업소입고	영업소에 물건이 입고되었습니다.
90	배송완료	물건이 수령인에게 전달되었습니다.

자주 묻는 질문 (FAQ)

우리택배 API courier code는 무엇인가요?

우리택배의 API courier code는 woori입니다. API 요청 시 "courierCode": "woori"로 지정하면 됩니다.

우리택배 송장번호 자릿수가 맞지 않아요

우리택배 송장번호는 반드시 10자리 숫자여야 합니다. 하이픈(-)이나 공백이 포함된 경우 제거하고, 10자리인지 확인한 후 API에 전달하세요.

조회 결과가 반환되지 않아요

집하 이전 단계(상품준비중)에서는 조회 결과가 없거나 빈 배송 이력이 반환될 수 있습니다. 집하 완료 후 재조회하면 정상적으로 확인됩니다. 문의가 필요한 경우 고객센터(1588-7766)로 연락하시기 바랍니다.

호남 지역 이외에도 배송이 되나요?

우리택배는 호남권(전라도)을 중심으로 운영되지만, 전국 배송도 지원합니다. 다만 호남 권역 내 배송이 특화되어 있어 해당 지역 발착 물량에 주로 사용됩니다.