CJ대한통운 조회 API

택배사 소개

CJ대한통운은 1930년 조선미곡창고로 설립된 국내 최대 물류 기업입니다. 하루 수백만 건의 택배를 처리하며, 전국 단위의 배송 네트워크를 보유하고 있습니다. 고객센터 번호는 1588-1255이며, 공식 배송 조회는 CJ대한통운 홈페이지에서 할 수 있습니다.

송장번호 형식

CJ대한통운 송장번호는 12자리 숫자로 구성됩니다. API 요청 시 하이픈(-) 없이 숫자만 입력해야 합니다.

형식	자릿수	예시
숫자	12자리	123456789012

API 연동 예시

DeliveryAPI의 POST /v1/tracking/trace 엔드포인트에 택배사 코드 cj와 송장번호를 전달합니다. items 배열에 여러 건을 담아 한 번에 조회할 수 있습니다.

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

상태 코드 매핑

CJ대한통운 배송 상태는 내부 코드로 반환됩니다. DeliveryAPI는 이 코드를 통합 상태값으로 변환하여 제공하며, 원본 코드도 함께 응답에 포함됩니다.

상태 코드	상태명	설명
91	배송완료	수취인에게 배송이 완료된 상태
82	배송출발	배송 기사가 배송을 시작한 상태
44	간선상차	간선 차량에 상차된 상태
43	간선이동중	간선 차량으로 이동 중인 상태
42	간선하차	간선 차량에서 하차된 상태
21	SM입고	서브 터미널(SM)에 입고된 상태
R1	행낭포장	행낭(소형 화물 묶음)으로 포장된 상태
11	집화처리	발송인으로부터 택배를 수거한 상태

자주 묻는 질문

CJ대한통운 조회가 안 될 때는 어떻게 하나요?

집화처리 직후에는 시스템에 반영되기까지 수십 분이 소요될 수 있습니다. 송장 발급 후 최소 1~2시간 후에 조회를 시도하세요. 그래도 조회되지 않는다면 고객센터(1588-1255)에 문의하거나 CJ대한통운 공식 홈페이지에서 직접 확인하세요.

12자리가 아닌 송장번호를 받았어요

CJ대한통운의 표준 송장번호는 12자리이지만, 구형 시스템에서 발급된 10자리 번호가 사용되는 경우도 있습니다. API 요청 시 받은 번호 그대로 입력하면 됩니다. 조회가 안 되는 경우 발송처에 올바른 송장번호를 재확인하세요.

배송완료 상태인데 물건을 못 받았어요

상태 코드 91(배송완료)은 배송 기사가 완료 처리를 한 시점을 나타냅니다. 경비실 수령, 문 앞 놓고 감, 대리 수령 등의 경우 수취인이 인지하지 못할 수 있습니다. 주변을 확인한 후 고객센터(1588-1255)에 문의하세요.

DeliveryAPI로 CJ대한통운 외 다른 택배사도 조회할 수 있나요?

네. DeliveryAPI는 CJ대한통운을 포함한 국내 주요 택배사를 단일 API로 지원합니다. courierCode 값만 변경하면 동일한 방식으로 롯데택배, 한진택배, 우체국택배 등을 조회할 수 있습니다. 지원 택배사 전체 목록은 API 문서를 참고하세요.