택배사 가이드

CU편의점택배 조회 API

CU편의점택배는 전국 CU 점포를 접수·수령 창구로 쓰는 편의점 기반 택배 서비스입니다. courier code cupost로 배송조회 API에 연동하며, cu도 같은 택배사로 인식됩니다.

CU편의점택배(CUPOST) 소개

CU편의점택배는 주식회사 비지에프네트웍스(BGF네트웍스)가 운영하며 서비스 브랜드명은 CUPOST입니다. 영업소에 물건을 맡기거나 기사 방문을 기다리는 일반 택배와 달리, 발송인이 가까운 CU 점포에서 직접 접수하고 수령인도 점포에서 찾아가는 구조라 접수·수령 시점이 점포 운영 시간에 맞춰 움직인다는 점이 특징입니다.

취급 상품은 국내택배, CU반값택배, CU내일보장택배, 편의점 pick-up, 국제특송으로 나뉩니다. 공식 조회 화면은 CUPOST 배송조회 페이지에서 확인할 수 있습니다.

기본 정보

택배사명	CU편의점택배
운영사	주식회사 비지에프네트웍스(BGF네트웍스)
서비스 브랜드	CUPOST
API courier code	`cupost` (별칭: `cu`)
고객센터	1688-1211 (국내택배·반값택배·내일보장택배) / 1566-1025 (픽업·제휴·회원)
취급 상품	국내택배, CU반값택배, CU내일보장택배, 편의점 pick-up, 국제특송
지원 범위	조회(tracking) 전용 — 계정 기반 등록·출력은 지원하지 않습니다

송장번호 형식

CU편의점택배 송장번호는 숫자만 11~20자리입니다. 고정 자릿수가 아니라 범위이므로, 자릿수로 다른 택배사와 구분하려는 로직은 피하는 편이 안전합니다.

이 범위는 CUPOST 조회 화면 동작에서 확인한 값입니다. 입력값이 11자리 미만이면 조회 자체가 거부되고, 입력칸의 maxlength가 20으로 제한되며, 숫자 이외의 문자는 입력 즉시 제거됩니다. 따라서 API로 보내기 전에 하이픈이나 공백을 모두 걷어내고 숫자만 남겨야 합니다.

송장번호 예시

실측 샘플: 460362123664 (12자리) — 허용 범위 11~20자리 안에 들어갑니다.

API 연동 예시

아래 요청 하나로 CU편의점택배 송장을 조회할 수 있습니다. {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": "cupost",
        "trackingNumber": "460362123664"
      }
    ]
  }'

items가 배열이므로 CU편의점택배 송장 여러 건을, 혹은 다른 택배사 송장과 섞어서 한 요청에 담을 수 있습니다. 응답 스키마와 오류 코드는 API 문서에 정리되어 있습니다.

상품별 배송 단계

같은 CUPOST 송장이라도 상품에 따라 거치는 단계 수가 다릅니다. 일반 국내택배는 4단계로 끝나지만, CU반값택배는 지정 점포까지 옮겨 간 뒤 수령인이 찾아가야 끝나는 구조라 수령 단계가 하나 더 붙어 5단계가 됩니다.

국내택배 (4단계)	CU반값택배 (5단계)
접수완료	접수완료
배송중	택배수거
배송출발	이동중
배송완료	점포도착
—	수령완료

반값택배의 마지막 단계가 배송완료가 아니라 수령완료인 이유는, 물건이 수령인 주소가 아니라 지정 점포에 도착하고 수령인이 직접 찾아가야 끝나기 때문입니다. 즉 점포도착은 아직 배송이 끝난 상태가 아닙니다.

배송 상태 코드 매핑

실제 조회 화면에서 확인되는 상세 이력은 집하완료 → 발송/도착(터미널·집배센터) → 배달완료 순으로 쌓입니다. API는 이 문구들을 아래와 같이 통합 상태값으로 정규화해 돌려줍니다.

CUPOST 표기	통합 상태	설명
집하완료	`PICKED_UP`	접수된 물건을 택배사가 인수했습니다.
택배수거	`PICKED_UP`	반값택배 접수 점포에서 물건을 걷어갔습니다.
발송 / 도착	`IN_TRANSIT`	터미널·집배센터를 거쳐 이동 중입니다.
점포도착	`IN_TRANSIT`	수령 점포에 도착했지만 아직 수령 전입니다.
배달완료	`DELIVERED`	수령인에게 배달이 완료되었습니다.
수령완료	`DELIVERED`	수령인이 점포에서 물건을 찾아갔습니다.

자주 묻는 질문 (FAQ)

CU편의점택배의 courier code는 무엇인가요?

표준 코드는 cupost입니다. 요청 본문에 "courierCode": "cupost"로 지정하세요. 기존 시스템에서 cu를 쓰고 있었다면 별칭으로 등록되어 있으므로 그대로 보내도 동일하게 처리됩니다. cvsnet은 CU가 아니라 GS편의점택배의 별칭이니 주의하세요.

송장번호가 몇 자리인지 확실하지 않습니다

CU편의점택배는 자릿수가 고정되어 있지 않고 11~20자리 범위입니다. 12자리 송장(460362123664)이 흔하지만 다른 길이도 유효합니다. 11자리보다 짧거나 숫자가 아닌 문자가 섞이면 조회에 실패하니 전달 전에 정리해 주세요.

점포도착으로 나오는데 왜 배송완료가 아닌가요?

반값택배는 수령 점포까지만 운송하고 수령인이 방문해 찾아가는 방식입니다. 점포도착은 IN_TRANSIT으로 유지되고, 실제로 물건을 찾아간 뒤 수령완료가 되면 DELIVERED로 바뀝니다. 알림을 보내는 서비스라면 이 두 단계를 구분해 문구를 다르게 쓰는 편이 좋습니다.

CU편의점택배 송장을 API로 등록하거나 출력할 수 있나요?

아닙니다. CU편의점택배는 조회(tracking)만 지원합니다. 계정을 등록해 운송장을 발행하거나 출력하는 기능(supportsAccount)은 제공하지 않으며, 접수는 CU 점포에서 이루어집니다.

배송 관련 문의는 어디로 하나요?

국내택배·반값택배·내일보장택배 배송 문의는 1688-1211, 편의점 pick-up이나 제휴·회원 관련 문의는 1566-1025로 연결됩니다.

CU편의점택배 API 연동 시작하기

편의점 택배부터 대형 택배사까지, 송장 하나하나를 같은 형식으로 받아보세요

지금 시작하기 →