Skip to main content
홈블로그가이드배송 라벨 없이 Tracking API가 작동하나요? 3PL 및 마켓플레이스 주문을 추적할 수 있나요?

배송 라벨 없이 Tracking API가 작동하나요? 3PL 및 마켓플레이스 주문을 추적할 수 있나요?

17TRACK

예. 배송 라벨을 귀사가 직접 생성하지 않더라도, 운송업체 또는 배송 파트너가 추적 가능한 배송을 생성했고 API가 지원하는 유효한 운송장 번호나 다른 식별자를 확보할 수 있다면 추적 API를 사용할 수 있습니다. 이는 제3자 물류 제공업체(3PL)나 마켓플레이스가 주문 처리를 담당할 때 일반적입니다. 중요한 차이는 직접 라벨을 구매하지 않는 것과 배송 식별자가 전혀 없는 것입니다. 전자는 대개 문제가 되지 않지만, 후자는 API가 추적할 대상 자체를 잃게 만들 수 있습니다.

배송 라벨 없이 추적 API를 사용할 수 있나요? 3PL 추적

판매자, 마켓플레이스 운영자 또는 통합 팀이 실제로 해야 할 일은 각 주문을 실제로 배송을 처리한 주체가 생성한 배송 건과 연결하는 것입니다. 이를 위해서는 라벨 생성에 대한 통제권이 반드시 필요한 것이 아니라, 올바른 데이터에 접근할 수 있어야 합니다.

라벨을 직접 생성하지 않을 때 추적 API에 필요한 것

배송 라벨은 배송 식별자를 생성하는 한 가지 방법이지만, 일반적으로 추적 API가 읽는 입력값은 아닙니다. 추적 통합은 대체로 다른 곳에서 라벨이 생성된 후 제공되는 배송 데이터를 기반으로 작동합니다. 연결을 설계하기 전에 서로 대체 가능한 것으로 취급되는 다음 세 가지 기록을 구분해야 합니다:

  • 주문 ID: 스토어, 마켓플레이스 계정 또는 주문 관리 시스템에서 구매를 식별합니다. 여러 상품과 여러 배송 건을 포함할 수 있습니다.
  • 주문 처리 또는 패키지 ID: 3PL 또는 마켓플레이스 시스템에서 주문 처리 작업이나 소포를 식별합니다. 형식과 의미는 해당 시스템에 따라 다릅니다.
  • 운송업체 운송장 번호: 운송업체와 추적 서비스가 해당 번호를 허용하는 경우 추적 목적으로 배송 건을 식별합니다.

내부 주문 ID는 올바른 고객 주문을 찾는 데 도움이 됩니다. 그러나 자동으로 운송업체 운송장 번호로 기능하지는 않습니다. 일반적인 통합 방식은 3PL 또는 마켓플레이스에서 운송장 번호를 받아 추적 API를 통해 해당 번호를 등록하거나 조회하고, 반환된 배송 정보를 관련 주문 또는 패키지에 연결해 저장하는 것입니다.

운송업체 이름이나 코드가 필요할 수도 있습니다. 일부 서비스는 운송업체 자동 식별을 시도할 수 있지만, 특히 여러 운송업체에서 식별자 형식이 겹치거나 주문이 여러 배송 네트워크를 거치는 경우에는 이를 당연하게 여기지 말고 테스트해야 합니다. 구현을 확정하기 전에 API 문서에서 허용되는 식별자, 운송업체 선택 규칙, 등록 요건 및 상태 필드를 확인하세요.

3PL이 배송한 주문 추적

3PL이 주문을 포장하고 라벨을 구매한 뒤 소포를 운송업체에 인계하면, 귀사는 라벨 자체를 보지 못할 수 있습니다. 그래도 그 과정에서 생성된 배송 세부 정보는 필요합니다. 3PL에 주문 처리 요청 시 제공한 주문 참조 정보와 함께 운송장 번호, 운송업체 정보 및 패키지 식별자를 어떤 시스템이나 피드에서 확인할 수 있는지 문의하세요.

실제로 사용할 수 있는 일반적인 3PL 흐름은 다음과 같습니다:

  1. 기존 주문 처리 프로세스를 통해 주문과 안정적인 참조 정보를 3PL에 보냅니다.
  2. 패키지 수준의 운송장 번호와 가능한 경우 운송업체 정보가 포함된 주문 처리 확인을 받습니다.
  3. 해당 패키지를 올바른 고객 주문 및 상품과 연결합니다.
  4. 지원되는 배송 식별자를 추적 API에 제출하거나 API가 지정한 조회 절차를 사용합니다.
  5. 패키지에 대한 추적 업데이트를 기록한 다음 운영 팀이나 고객에게 주문 수준의 정보를 제공합니다.

연결 단계에는 특히 주의를 기울여야 합니다. 하나의 주문이 두 개의 상자로 창고를 출고할 수 있고, 한 상품이 다른 상품보다 늦게 배송될 수도 있습니다. 어느 경우든 전체 주문을 정확히 설명하는 단일 패키지 상태는 없습니다. 패키지 수준의 기록을 유지하고 이를 바탕으로 주문 수준의 메시지를 생성하세요. 예를 들어 첫 번째 소포가 배송되었다는 이유만으로 주문 전체를 배송 완료로 표시하지 마세요.

수정 사항을 어떻게 전달할지 3PL과 합의하세요. 라벨이 무효화되거나 소포가 다시 포장될 수 있으며, 최초 운송장 번호가 교체될 수도 있습니다. 통합 시스템은 교체된 번호를 동일한 주문에 연결할 수 있어야 하며, 두 번호를 모두 계속 활성 배송 건으로 표시해서는 안 됩니다.

마켓플레이스가 배송을 관리하는 경우의 주문 추적

마켓플레이스 주문 처리는 기술적으로 비슷한 문제를 제시하지만 접근 권한 측면에서는 다릅니다. 마켓플레이스 또는 그 주문 처리 파트너가 라벨을 생성할 수 있지만, 판매자는 계정, 주문 절차 또는 승인된 통합을 통해 공개된 배송 정보만 받을 수 있습니다. 마켓플레이스가 운송장 번호를 제공하지 않았다면 추적 API가 이를 대신해 줄 수 없습니다.

먼저 각 주문의 주문 처리 모델을 확인하세요. 판매자 직접 처리 주문의 경우 자체 배송 절차나 3PL이 패키지 데이터의 출처일 수 있습니다. 마켓플레이스 처리 주문의 경우 마켓플레이스가 배송 정보의 출처일 수 있으며, 판매자가 이용할 수 있는 필드는 다를 수 있습니다. 주문 페이지에 배송 상태가 표시된다고 해서 별도 API 등록에 사용할 수 있는 운송업체 운송장 번호도 제공된다고 가정하지 마세요.

마켓플레이스가 추적 가능한 번호를 제공한다면, 해당 번호를 의도한 시스템에서 검색하고 사용할 권한이 있는지 확인하세요. 그런 다음 추적 API가 해당 식별자를 허용하는지, 그리고 반환되는 이벤트가 마켓플레이스 상태 이상의 유용한 정보를 제공하는지 테스트하세요. 마켓플레이스가 자체 주문 또는 배송 참조 정보만 공개한다면 명시적으로 지원되는 조회 방법이 있는지 확인하세요. 내부 마켓플레이스 주문 ID를 운송장 번호인 것처럼 제출하고 신뢰할 수 있는 결과를 기대하지 마세요.

마켓플레이스의 주문 상태와 추적 API의 배송 상태를 분리해 관리하세요. 마켓플레이스는 주문 처리가 확인되면 주문을 배송 완료로 설명할 수 있지만, 운송업체 추적에는 아직 접수 스캔이 표시되지 않을 수 있습니다. 두 기록은 서로 다른 질문에 답하며 업데이트 시점도 다를 수 있습니다.

라벨 없이 추적해도 문제가 해결되지 않는 경우

“당사가 생성한 라벨이 없음”은 장애 요인이 아닙니다. 다음 상황은 문제가 될 수 있습니다:

  • 배송이 생성되지 않음: 주문 처리를 통해 사용할 수 있는 식별자가 생성되기 전에는 조회할 운송업체 배송 건이 없을 수 있습니다. 주문 확인만으로 소포가 운송 중이라는 증거가 되지는 않습니다.
  • 식별자를 이용할 수 없음: 3PL 또는 마켓플레이스가 번호를 보유하고 있지만 승인된 절차를 통해 공개하지 않을 수 있습니다. 데이터 접근 문제를 데이터 원천에서 해결하세요.
  • 식별자가 지원되지 않음: 참조 번호, 마켓플레이스 전용 코드 또는 지원되지 않는 운송업체 형식은 선택한 API에서 작동하지 않을 수 있습니다. 문서와 테스트 배송을 통해 허용되는 입력을 확인하세요.
  • 소포에 아직 새로운 스캔이 없음: 운송업체가 접수 이벤트를 기록하기 전에 번호가 생성될 수 있습니다. 비어 있거나 변하지 않는 결과를 번호가 유효하지 않다는 자동 증거로 보지 말고 조사해야 할 상태로 취급하세요.
  • 추적이 제한되거나 불완전함: 운송업체, 서비스 또는 배송 절차가 고객 대상 사용 사례에 필요한 이벤트를 제공하지 않을 수 있습니다. 대표적인 배송 건으로 실제 이벤트 품질을 확인하세요.

이러한 제한이 중요한 이유는 API가 누락된 실제 배송 이벤트를 생성하거나 다른 당사자의 주문 데이터에 대한 접근 권한을 부여할 수 없기 때문입니다. 필요한 식별자와 권한이 존재할 때 지원되는 추적 정보를 가져와 정리하는 것이 API의 가치입니다.

이 업무 흐름에 적합한 API를 평가하는 방법

팀이 라벨 구매 도구가 아니라 자체 시스템에서 배송 추적 데이터를 필요로 한다면 17TRACK의 Tracking API를 검토할 수 있습니다. 개발자 문서에서 사용 사례에 필요한 등록 필드, 지원 운송업체, 응답 구조, 인증 및 이용 가능한 업데이트 전달 방식을 확인할 수 있습니다. 일반 추적 API가 존재한다는 사실만으로 특정 3PL, 마켓플레이스 또는 독점 식별자를 지원한다고 추론하지 마세요.

제공업체를 선택하거나 배포하기 전에 소규모 테스트 세트를 구성하세요. 운송업체 번호가 있는 3PL 주문, 계정에 번호가 공개된 마켓플레이스 주문, 여러 소포로 구성된 주문, 첫 스캔 전에 생성된 번호, 이후 배송 이벤트가 발생한 배송 건을 포함하세요. 교체나 국제 운송업체 인계가 자주 발생한다면 그것도 포함하세요. 테스트는 요청이 성공적인 HTTP 응답을 반환하는지만이 아니라 운영상의 질문에 답해야 합니다:

  • 수동으로 다시 입력하지 않고 실제로 받는 식별자를 전달할 수 있습니까?
  • 각 추적 기록을 올바른 주문 및 패키지에 안정적으로 연결할 수 있습니까?
  • 이벤트 설명, 타임스탬프 및 운송업체 정보가 고객 메시지와 지원 업무에 충분합니까?
  • 중복 업데이트, 누락된 이벤트, 번호 변경 및 실패한 요청을 시스템이 어떻게 처리합니까?
  • 마켓플레이스 및 고객 데이터의 예정된 사용이 해당 데이터에 적용되는 접근 약관을 준수합니까?

통합 자체에서는 원본 기록과 추적 API 기록을 모두 보존하세요. 주문 참조 정보, 패키지 참조 정보, 제출한 운송장 번호, 가능한 경우 운송업체 정보, 각 업데이트를 받은 시간을 저장하세요. 이렇게 하면 API 이벤트를 전체 주문 처리 이력인 것처럼 표시하지 않고 불일치를 조사하기가 쉬워집니다. API가 일정에 따른 확인과 지원되는 전달 방식을 통한 업데이트 수신 중 하나를 제공한다면 문서화된 동작과 적시 업데이트에 대한 필요에 따라 선택하세요. 어느 방식도 오류 처리가 필요 없게 하지는 않습니다.

실질적인 판단

다른 당사자가 소포를 배송하고 귀사가 사용 권한을 가진 지원되는 배송 식별자를 제공하는 경우 라벨을 직접 생성하지 않고 추적 API를 사용하세요. 먼저 3PL 또는 마켓플레이스에서 신뢰할 수 있는 패키지 데이터 피드를 확보하세요. 그런 다음 API 및 주문 연결 로직을 사용해 식별자와 추적 이벤트를 테스트하세요. 주문 ID나 마켓플레이스 상태만 보유하고 있다면 운송업체 추적 통합에 투자하기 전에 원본 데이터의 공백을 해결하세요.

FAQ

스토어 주문 번호만으로 주문을 추적할 수 있나요?

일반적으로 운송업체 추적 API를 통해서는 어렵습니다. 스토어 주문 번호는 시스템 내 구매를 식별합니다. 특정 서비스가 사용 중인 주문 참조 유형에 따른 조회를 명시적으로 지원하지 않는 한 일반적으로 해당 배송 식별자가 필요합니다.

3PL의 운송장 번호를 사용하려면 3PL의 허가가 필요한가요?

배송 데이터에 대한 계약상 및 기술적 접근 권한을 확인하세요. 3PL이 이미 주문 처리 피드의 일부로 운송장 번호를 반환할 수 있지만, 통합은 승인된 채널을 사용하고 고객 데이터를 적절히 처리해야 합니다.

3PL이 번호를 보낸 후에도 API에 이동 내역이 표시되지 않는 이유는 무엇인가요?

운송업체의 최초 기록 스캔 전에 번호가 생성되었을 수 있습니다. 식별자와 운송업체가 정확한지, 원래 라벨이 교체되었는지, 이후 조회에서 이벤트가 생성되는지 확인하세요. 주문 처리 기록을 확인하지 않고 “아직 스캔되지 않음”을 “배송되지 않음”과 동일하게 보지 마세요.

마켓플레이스 주문 하나가 여러 소포로 배송되면 어떻게 하나요?

이용 가능한 각 패키지 식별자를 별도로 추적하고 모든 패키지를 동일한 주문에 연결하세요. 하나의 소포가 배송되었다고 주문 전체가 완료된 것처럼 보이지 않도록 고객 대상 주문 상태와 개별 소포 상태를 구분하세요.

출처