택배사 가이드

롯데백화점택배 조회 API

롯데백화점택배는 롯데백화점 매장에서 구매한 상품을 백화점 자체 배송망으로 수취인에게 직접 배달하는 서비스입니다. 배송조회 API에서는 courier code lottedept를 쓰며, lottedpt와 lotteshopping으로 보내도 같은 택배사로 처리됩니다. 택배회사인 롯데택배(lotte)와는 다른 시스템입니다.

롯데백화점택배 소개

운영 주체는 롯데쇼핑㈜ 롯데백화점입니다. 명절 선물세트처럼 매장에서 사서 다른 사람에게 보내는 상품이 여기에 실리며, 매장 직원이 배송신청서를 접수하면 상품마다 배송전표가 붙고 백화점 물류센터에서 배송기사가 수취인에게 직접 가져다줍니다.

공식 조회 진입점은 롯데쇼핑 배송조회이고, 실제 조회는 롯데백화점 배송 서비스의 배송정보 조회 화면에서 이루어집니다. 이 화면이 쓰는 조회 결과를 API에서 그대로 통합 응답 형식으로 돌려드립니다.

롯데택배와 헷갈리지 마세요

롯데택배(lotte)는 롯데글로벌로지스가 운영하는 일반 택배사이고, 롯데백화점택배(lottedept)는 백화점이 직접 운영하는 매장 상품 배송입니다. 송장 체계·조회 화면·상태 문구가 전부 달라서, 롯데백화점 배송전표 번호를 lotte로 조회하면 결과가 나오지 않습니다.

기본 정보

택배사명	롯데백화점택배 (롯데백화점 배송 서비스)
운영사	롯데쇼핑㈜ 롯데백화점
API courier code	`lottedept` (별칭: `lottedpt`, `lotteshopping`)
고객센터	1577-0001 (롯데백화점 대표전화)
조회 화면	bs.dpt.co.kr 배송정보 조회 (배송전표 조회)
지원 범위	조회(tracking) 전용 — 계정 기반 등록·출력은 지원하지 않습니다

송장번호 형식

조회에 쓰는 번호는 상품에 붙은 배송전표의 전표번호 10자리입니다. 숫자만 정확히 10자리이며, 하이픈이나 공백은 요청 전에 제거해 주세요. 공식 조회 화면 안내문("전표번호 10자리를 입력")과 입력칸 길이 제한이 이 규칙의 근거입니다.

같은 화면에서 받는 신청서 번호 9자리는 API에서 받지 않습니다. 신청서 번호는 매장에서 한 번에 접수한 주문 묶음 단위라 번호 하나에 수취인 여러 명이 딸려 나오기 때문에, 배송 건 하나를 가리키는 송장으로 쓸 수 없습니다. 매장에서 받은 신청서만 있다면 상품에 부착된 배송전표 번호를 확인해 주세요.

송장번호 예시

실측 샘플: 1638882971 — 배송전표 10자리입니다. 9자리 신청서 번호(222606608 형태)는 형식 오류로 거절됩니다.

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": "lottedept",
        "trackingNumber": "1638882971"
      }
    ]
  }'

items는 배열이므로 롯데백화점택배 전표 여러 건을 한 번에, 또는 다른 택배사 송장과 함께 묶어 보낼 수 있습니다. 응답 필드 정의와 오류 코드는 API 문서를 참고하세요.

응답 구조: 이력 대신 배송결과 한 칸

일반 택배사는 집하·간선·배송출발처럼 단계별 이력을 쌓지만, 롯데백화점 배송 시스템은 현재 배송결과 한 칸과 그 처리 시각만 공개합니다. 그래서 API 응답의 progresses는 최대 1건(현재 결과)이고, 배송기사가 결과를 등록하기 전에는 비어 있습니다.

deliveryStatus — 배송결과 문구를 통합 상태로 정규화한 값 (아래 표)
dateDelivered — 배송결과가 완료 계열일 때의 처리 시각
dateEstimated — 매장에서 접수한 배송요구일자 (백화점이 약속한 배송일)
senderName / receiverName / receiverAddress — 롯데백화점이 일부 마스킹해 내려주는 값 그대로
productName — 상품명

배송 상태 코드 매핑

롯데백화점 배송 시스템의 배송결과 문구는 아래처럼 통합 상태값으로 정규화됩니다. 택배사 원문 대신 이 상태값을 기준으로 분기하면 다른 택배사와 같은 코드로 처리할 수 있습니다.

롯데백화점 표기	통합 상태	설명
(결과 등록 전) / 배송준비중	`PENDING`	배송신청서는 접수됐지만 아직 배송 결과가 없습니다. 실존 전표이므로 조회 오류가 아닙니다.
배차 / 전표출력완료	`REGISTERED`	배송기사가 배정되고 전표가 출력된 단계입니다.
집하	`PICKED_UP`	물류센터가 상품을 인수했습니다.
상차/검수/출발 · 배송출발	`OUT_FOR_DELIVERY`	배송 차량에 실려 수취인에게 향하고 있습니다.
완료 · 배송완료	`DELIVERED`	수취인에게 전달되었습니다.
보관완료	`DELIVERED`	수취인 부재 등으로 경비실·문앞 같은 위탁 장소에 두고 온 최종 결과입니다.
미배송	`FAILED`	배송을 시도했으나 전달하지 못했습니다.
반송	`RETURNED`	상품이 되돌아갔습니다.
배송제외	`CANCELLED`	배송 대상에서 빠졌습니다.
롯데택배	`IN_TRANSIT`	백화점 자체 배송이 아니라 롯데택배로 넘어간 건입니다. 상세 이력은 롯데택배 송장으로 조회해야 합니다.

보관완료를 배송 완료로 두는 이유는 롯데백화점이 이 값을 배송완료와 나란히 최종 결과로 다루기 때문입니다. 문앞 배송 알림을 보내는 서비스라면 progresses[0].status의 원문이 보관완료인지 확인해 "위탁 장소에 보관됨" 문구를 따로 띄울 수 있습니다.

자주 묻는 질문 (FAQ)

롯데백화점택배의 courier code는 무엇인가요?

표준값은 lottedept이며, 요청 본문에 "courierCode": "lottedept"로 넣으면 됩니다. 조회 시스템 도메인을 딴 lottedpt, 공식 진입 페이지를 딴 lotteshopping도 별칭으로 등록되어 있어 동일한 결과를 받습니다.

롯데택배 송장을 lottedept로 조회해도 되나요?

안 됩니다. 두 서비스는 송장 체계가 완전히 달라서 서로의 번호로는 조회 결과가 없습니다. 롯데글로벌로지스 송장(보통 12자리)은 lotte로, 백화점 배송전표(10자리)는 lottedept로 보내주세요.

신청서 번호 9자리로는 조회가 안 되나요?

API에서는 받지 않습니다. 신청서 번호는 주문 묶음 단위라 수취인이 여러 명 나오기 때문에 한 건의 배송 상태로 답할 수 없습니다. 상품에 부착된 배송전표의 10자리 번호를 사용해 주세요.

배송 이력이 한 줄뿐인데 정상인가요?

정상입니다. 롯데백화점 배송 시스템은 단계별 이력 없이 현재 배송결과와 그 처리 시각만 공개합니다. 배송 전에는 PENDING에 progresses가 비어 있다가, 기사가 결과를 등록하면 그 한 건이 채워집니다. 예상 배송일은 dateEstimated(배송요구일자)로 함께 내려갑니다.

운송장 발행이나 출력도 API로 되나요?

되지 않습니다. 롯데백화점택배는 조회(tracking)만 지원합니다. 접수는 롯데백화점 매장에서 이루어지고, 발행된 배송전표 번호를 받아 조회하는 용도로 API를 쓰게 됩니다.

롯데백화점택배 API 연동 시작하기

백화점 자체 배송과 일반 택배사 송장을 하나의 응답 형식으로 받아보세요

지금 시작하기 →