롯데택배 조회 API

롯데택배 소개

롯데글로벌로지스(구 롯데택배)는 롯데그룹 계열의 종합 물류 기업입니다. 전국 단위 배송망과 함께 신선식품 특화 콜드체인 인프라를 보유하여 식품, 신선, 의약품 분야 물류를 다수 담당합니다. 일반 택배뿐만 아니라 새벽배송, 당일배송 서비스도 운영합니다.

송장번호 형식

롯데택배 송장번호는 정확히 12자리 숫자로 구성됩니다. 마지막 자리(12번째)는 앞 11자리의 합을 7로 나눈 나머지로 계산되는 체크섬(mod 7) 검증 자리입니다.

체크섬 검증 로직

// 롯데택배 송장번호 검증 (앞 11자리 % 7 = 12번째 자리)
function validateLotteTrackingNumber(trackingNumber) {
  if (!/^\d{12}$/.test(trackingNumber)) return false;

  const digits = trackingNumber.split('').map(Number);
  const checkDigit = digits[11];
  const sum = digits.slice(0, 11).reduce((acc, d) => acc + d, 0);

  return sum % 7 === checkDigit;
}

// 예시
validateLotteTrackingNumber('123456789012'); // 1+2+3+4+5+6+7+8+9+0+1 = 46, 46 % 7 = 4

API 연동 예시

DeliveryAPI를 통해 롯데택배 배송 상태를 조회하려면 POST /v1/tracking/trace 엔드포인트에 courierCode: "lotte"와 12자리 송장번호를 전달합니다. items 배열에 여러 건을 담아 한 번에 조회할 수 있습니다.

요청 예시 (curl)

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

응답 예시

{
  "isSuccess": true,
  "data": {
    "results": [
      {
        "success": true,
        "data": {
          "courierCode": "lotte",
          "courierName": "롯데택배",
          "trackingNumber": "123456789012",
          "deliveryStatus": "DELIVERED",
          "deliveryStatusText": "배송완료",
          "isDelivered": true,
          "progresses": [
            {
              "dateTime": "2026-03-11T14:30:00+09:00",
              "status": "배달완료",
              "statusCode": "DELIVERED",
              "location": "서울 강남",
              "description": "배송이 완료되었습니다. 인수자: 본인"
            },
            {
              "dateTime": "2026-03-11T08:15:00+09:00",
              "status": "배송출발",
              "statusCode": "OUT_FOR_DELIVERY",
              "location": "서울 강남 배송터미널",
              "description": "배송을 시작하였습니다"
            },
            {
              "dateTime": "2026-03-11T03:40:00+09:00",
              "status": "간선상차",
              "statusCode": "IN_TRANSIT",
              "location": "서울 허브터미널",
              "description": "간선 상차 처리되었습니다"
            },
            {
              "dateTime": "2026-03-10T18:20:00+09:00",
              "status": "집하처리",
              "statusCode": "PICKED_UP",
              "location": "경기 성남 집하터미널",
              "description": "집하 처리되었습니다"
            },
            {
              "dateTime": "2026-03-10T09:00:00+09:00",
              "status": "접수",
              "statusCode": "PENDING",
              "location": "경기 성남",
              "description": "택배가 접수되었습니다"
            }
          ],
          "dateLastProgress": "2026-03-11T14:30:00+09:00",
          "queriedAt": "2026-03-11T15:00:00+09:00"
        }
      }
    ],
    "summary": { "total": 1, "successful": 1, "failed": 0, "billable": 1 }
  }
}

배송 상태 코드 매핑

롯데택배의 원시 상태 문자열은 DeliveryAPI 표준 상태 코드로 자동 변환되어 반환됩니다.

자주 묻는 질문 (FAQ)

롯데택배 송장번호가 12자리가 아닌 경우도 있나요?

현재 롯데택배의 일반 송장번호 형식은 12자리입니다. 과거에는 10자리, 11자리 형식이 사용된 이력이 있으나, 현재 신규 발행되는 송장은 12자리가 표준입니다. 오래된 송장번호의 경우 조회가 되지 않을 수 있습니다.

집하 완료인데 배송 상태가 조회되지 않아요

롯데택배는 집하 처리 후 시스템 반영까지 최대 2~3시간이 소요될 수 있습니다. 접수 단계에서는 API 조회 시 PENDING 상태로 반환되거나, 아직 데이터가 없는 경우 빈 배열로 반환됩니다.

신선식품(냉장/냉동) 배송도 같은 API로 조회할 수 있나요?

네, 롯데택배 콜드체인(신선식품) 배송도 동일한 courierCode: "lotte"와 12자리 송장번호로 조회합니다. 배송 유형에 따른 별도 코드 구분은 없습니다.

배송출발 상태 이후 배송완료까지 시간이 얼마나 걸리나요?

일반 택배 기준 배송출발(OUT_FOR_DELIVERY) 상태 전환 후 당일 내 배송 완료되는 경우가 대부분입니다. 단, 주소 오류, 부재중, 공동현관 출입 불가 등의 사유로 다음 날 재배송되는 경우도 있습니다. 웹훅을 활용하면 DELIVERED 상태 전환 시 즉시 알림을 받을 수 있습니다.

여러 롯데택배 송장번호를 한 번에 조회할 수 있나요?

네, items 배열에 최대 50건까지 담아 한 번의 API 요청으로 일괄 조회할 수 있습니다. 각 아이템의 courierCode를 "lotte"로 설정하면 됩니다.