구독형 이커머스 브랜드가 배송 추적 API로 정기 배송을 추적하는 방법
반복 배송을 추적 API로 추적하려면 각 실제 소포마다 배송 기록을 생성하고, 해당 구독 주기의 주문 처리 주문에 연결한 다음, 창고 또는 주문 처리 파트너가 운송장 번호를 제공하면 이를 등록하세요. API의 추적 업데이트를 사용하여 고객에게 해당 소포의 위치를 보여 주고, 팀을 위해 배송 예외를 표시하세요. 구독 ID는 주기 간 연결 고리로 유지하되, 소포의 식별자로 사용하지 마세요.

구독이 아니라 소포를 추적하세요
구독은 고객이 일정 기간 동안 무엇을 받게 되는지를 알려 줍니다. 주문 처리 주문은 한 주기에 무엇을 발송해야 하는지를 알려 줍니다. 운송장 번호는 특정 소포에 대한 정보를 제공합니다. 이러한 기록을 분리해 두면 한 주기의 지연 배송이 다음 주기의 추적 페이지에 표시되는 것을 방지할 수 있습니다.
예를 들어 5월 구독 상자가 두 개의 소포로 나뉘었고, 5월 소포 하나가 아직 운송 중인 상태에서 6월 상자가 발송되었다고 가정해 보세요. 고객에게는 5월 주문 아래에 두 개의 소포가 표시되고, 6월 주문 아래에는 별도의 소포가 표시되어야 합니다. 늦게 도착한 5월 업데이트는 5월 소포에만 변경을 적용해야 합니다. 교체품을 발송하는 경우 새 배송 기록을 생성하고 원래 배송 기록에 연결하여 지원팀이 두 기록이 모두 존재하는 이유를 확인할 수 있도록 하세요.
- 구독: 지원팀이 고객의 배송 이력을 찾을 수 있도록 구독 ID를 저장하세요.
- 주기 및 주문: 주기 식별자 또는 예정된 주문 처리 날짜, 주문 ID, 그리고 패키지를 올바른 주문에 연결하는 데 필요한 주문 처리 ID를 기록하세요. 추적 이벤트가 도착한 날짜를 기준으로 주기를 추정하지 마세요.
- 배송: 각 소포에 내부 배송 ID를 부여하세요. 운송업체와 운송장 번호, 관련 주문 처리 참조 정보, 제공업체가 반환하는 추적 등록 ID를 저장하세요. 취소된 라벨과 대체된 운송장 번호는 활성 고객 화면에서 제외하되, 지원팀을 위해 이력은 보관하세요.
주문 페이지에는 주문 요약과 함께 소포 단위의 진행 상황을 표시하세요. 한 소포는 배송 완료이고 다른 소포는 운송 중이라면 그렇게 표시하세요. 취소된 배송과 교체품을 고려하여 주문을 완료하는 데 필요한 모든 소포가 도착한 경우에만 전체 주문을 배송 완료로 표시하세요.
주문 처리를 추적 API에 연결하세요
- 주문 처리 이벤트에서 등록하세요. 주문 처리 시스템, 창고 또는 제3자 물류 파트너가 운송업체와 운송장 번호를 보내면 등록을 실행하세요. 갱신 결제 시점은 너무 이릅니다. 주문이 아직 발송 대기 중일 수 있고 운송장 번호가 존재하지 않을 수도 있습니다.
- API를 호출하기 전에 배송 기록을 저장하세요. 내부 배송 기록을 저장하고 등록 요청을 대기열에 넣으세요. 동일한 주문 처리 메시지가 두 번 도착하면 다른 소포를 생성하지 말고 해당 기록을 재사용하세요. API 호출 시간이 초과되면 제공업체가 확인 방법을 제공하는 경우 재시도하기 전에 원래 요청이 성공했는지 확인하세요.
- 업데이트를 등록된 소포에 연결하세요. 업데이트에 제공업체의 등록 식별자가 반환되면 이를 사용하세요. 그렇지 않으면 제공업체 문서에 지정된 식별자를 기준으로 연결하고, 결과를 배송 기록과 대조하여 검증하세요. 업데이트가 둘 이상의 기록에 해당할 수 있다면 최신 주문에 적용하지 말고 검토 대상으로 보내세요.
- 라벨 생성과 운송업체 이동을 분리하세요. 운송업체가 소유권을 기록하기 전에 운송장 번호가 존재할 수 있습니다. 라벨만 있는 경우에는 “운송업체 픽업 준비 중”과 같은 메시지를 사용하세요. 이를 뒷받침하는 운송업체 정보가 있을 때만 “운송 중”으로 표시하세요.
17TRACK Tracking API는 이러한 설정을 위한 하나의 선택지입니다. 운송장 번호 등록 및 추적 업데이트 수신에 대한 기준은 개발자 문서를 참고하세요. 해당 업데이트를 사용하여 시스템의 소포 기록을 유지하고, 주기 할당, 주문 완료 및 고객 알림 규칙은 이커머스 애플리케이션에서 관리하세요. 출시 전에 운송업체 목록에만 의존하지 말고 실제 운송 경로와 주문 처리 파트너의 소포로 테스트하세요.
업데이트를 두 번 처리해도 안전하게 만드세요
제공업체가 웹훅을 지원한다면 모든 소포를 계속 폴링하지 말고 웹훅을 사용하여 업데이트를 수신하세요. 웹훅은 제공업체가 애플리케이션으로 보내는 HTTP 요청입니다. 제공업체의 검증 요구 사항을 따르고, 승인된 페이로드를 안정적으로 저장하며, 문서화된 응답 규칙에 따라 요청에 응답하세요. 주문 화면 업데이트나 이메일 전송과 같은 느린 작업은 요청 핸들러 외부에서 실행하세요.
반복된 업데이트가 추가 효과를 발생시키지 않도록 처리 경로를 구축하세요. 제공업체가 안정적인 이벤트 ID를 제공한다면 이를 사용하여 반복 이벤트를 식별하세요. 개별 이벤트가 아닌 추적 스냅샷을 전송한다면 조치를 취하기 전에 수신 상태와 스캔 이력을 기존 데이터와 비교하세요. 고객 메시지의 중복 제거는 별도로 처리하세요. 이미 발송된 배송 완료 알림이 동일한 배송 데이터가 두 번 처리되었다는 이유만으로 다시 발송되어서는 안 됩니다.
스캔이 발생한 시간과 애플리케이션이 이를 수신한 시간을 분리하여 저장하세요. 늦게 도착한 운송 중 스캔은 더 최신의 배송 완료 상태를 대체하지 않고 소포 이력에 포함될 수 있습니다. 그러나 모든 정상적인 변경이 소포를 앞으로만 이동시킨다고 가정하지 마세요. 운송업체의 정정이나 발신자 반송 업데이트로 인해 표시 내용을 변경해야 할 수 있습니다. 새 데이터가 저장된 상태와 충돌하고 어느 쪽이 올바른지 판단할 수 없다면 배송을 검토 대기열에 넣으세요.
주의가 필요한 미결 배송을 정기적으로 확인하세요. 아직 대기 중인 등록, 예상 인계 후 첫 스캔이 없는 소포, 추적 업데이트가 중단된 배송 등이 이에 해당합니다. API가 조회 또는 새로 고침을 지원한다면 제공업체의 한도 내에서 선택적으로 사용하세요. 에스컬레이션하기 전에 운송업체와 창고 전반의 패턴을 확인하세요. 서로 관련 없는 여러 배송에서 동시에 업데이트가 중단된다면 개별 배송 문제를 열기 전에 통합을 조사하세요.
추적 데이터를 유용한 고객 메시지로 전환하세요
고객에게 모든 스캔마다 이메일이 필요한 경우는 드뭅니다. 소포가 운송업체 네트워크에 들어갔거나, 배송 시도에 조치가 필요하거나, 운송업체가 배송 완료를 보고하는 등 고객이 알아야 하거나 행동해야 하는 사항과 연결된 메시지부터 시작하세요. 구독자가 어떤 배송에 대한 메시지인지 알 수 있도록 주문 참조 정보와 관련 상자 또는 주기를 표시하세요. 주문이 분할된 경우 소포를 식별하고 주문의 나머지 부분이 아직 운송 중인지 명확히 하세요.
- 라벨 생성, 스캔 없음: 창고 기록과 예상 인계 시점을 대조하세요. 인계 시간이 지났다면 고객에게 운송 중 지연이라고 알리기 전에 주문 처리팀에 소포가 시설을 떠났는지 확인하도록 요청하세요.
- 추적이 더 이상 진행되지 않음: 모든 소포에 하나의 타이머를 적용하지 말고 운송 경로와 서비스에 맞는 기준을 사용하세요. 국경 간 배송의 경우 고객에게 연락하거나 에스컬레이션할지 결정하기 전에 마지막 운송업체 이벤트를 검토하세요.
- 배송 시도 실패 또는 픽업 필요: 운송업체가 명확한 지침을 제공한다면 고객에게 필요한 조치를 알려 주세요. 이벤트가 모호하다면 재배송 날짜나 픽업 장소를 추측하지 말고 지원팀으로 전달하세요.
- 배송 완료로 표시되었지만 수령하지 못함: 운송업체가 보고한 상태를 유지하고 별도의 지원 사례를 개설하세요. 지원 워크플로는 고객의 신고와 운송업체의 정정을 구분해야 합니다.
지원 직원에게 주기, 주문, 소포 이력 및 이미 발송된 메시지를 한 화면에서 볼 수 있도록 제공하세요. 각 예외에 담당자와 다음 단계를 지정하세요. 주문 처리팀은 누락된 인계를 조사하고, 물류팀은 운송업체 예외를 후속 조치하며, 지원팀은 고객 커뮤니케이션을 담당할 수 있습니다. 추적 상태는 소포를 설명할 뿐이며, 교체품이나 환불 제공 여부를 결정하지는 않습니다.
출시 전에 주기 간 중첩을 테스트하세요
한 주문 처리 파트너와 실제 주문 발송 방식이 반영된 배송 세트로 시작하세요. 여러 소포가 있는 주기, 무효화된 라벨, 교체품, 그리고 다음 주기가 발송될 때까지 아직 미결 상태인 이전 배송을 포함하세요. 그런 다음 중복 웹훅을 의도적으로 다시 재생하고 최신 이벤트보다 오래된 이벤트를 나중에 전달하세요. 소포 기록, 고객 주문 페이지, 지원 화면 및 알림 로그를 확인하세요. 성공적인 API 응답만 검증하는 테스트는 가장 큰 비용을 초래할 수 있는 실수, 즉 잘못된 주문을 업데이트하거나 잘못된 고객에게 메시지를 보내는 문제를 놓칠 수 있습니다.
등록 실패, 등록 가능한 소포 중 성공적으로 등록된 비율, 예상보다 늦은 첫 스캔 및 매칭되지 않은 업데이트를 모니터링하세요. 업데이트 지연 시간을 추적한다면 운송업체 이벤트 발생부터 수신까지의 시간과 자체 시스템이 이를 처리하는 데 걸린 시간을 구분하세요. 이를 통해 운송업체 피드, 웹훅 엔드포인트 또는 애플리케이션 내부 대기열 중 어디를 조사할지 결정할 수 있습니다.
어떤 소포에 대해서든 다음 세 가지 질문에 답할 수 있게 되면 더 많은 경로로 확장하세요. 어느 주기에 속하는가? 운송업체가 마지막으로 보고한 내용은 무엇인가? 업데이트가 누락되거나 잘못된 경우 누가 조치하는가? 답이 하나라도 명확하지 않다면 알림 규칙을 추가하기 전에 기록 매핑이나 예외 워크플로를 수정하세요.
FAQ
추적 API가 고객에게 다음 구독 상자가 언제 발송될지 알려 줄 수 있나요?
다음 예정 발송일은 구독 일정과 주문 처리 시스템을 사용하세요. 추적 API는 추적 정보가 존재하는 특정 소포를 위한 것입니다. 예정 발송일, 운송업체 배송 예상일 및 배송 완료 확인은 서로 다른 사실이므로 별도로 표시해야 합니다.
이메일이 발송된 후 창고에서 운송장 번호를 교체하면 어떻게 하나요?
이전 라벨을 대체됨으로 표시하고 새 운송장 번호를 동일한 주문에 연결하세요. 이메일이 주문 단위 추적 페이지를 가리키는 경우 고객이 원래 운송업체 링크 없이도 활성 소포를 찾을 수 있도록 해당 페이지를 업데이트하세요. 변경 사항이 고객에게 필요한 행동 관련 정보에 영향을 주는 경우 정정 메시지를 보내세요.
주문 처리 파트너가 운송업체 코드 없이 운송장 번호를 보내면 어떻게 하나요?
파트너에게 일관된 운송업체 필드 또는 배송 서비스 코드 매핑을 요청하세요. API가 운송업체 감지를 제공한다면 파트너의 라벨에서 어떻게 작동하는지 확인한 후 사용하세요. 운송장 번호만으로 운송업체를 선택하지 말고 모호한 매칭은 검토 대상으로 보내세요.
일시 중지되거나 건너뛴 구독에도 추적 기록이 필요한가요?
발송되지 않는 주기에는 소포 기록이 필요하지 않습니다. 이전 배송이 아직 미결 상태라면 구독이 일시 중지되거나 건너뛰거나 취소되더라도 계속 추적하세요. 구독 상태는 향후 주문 처리를 제어할 뿐, 이미 창고를 떠난 소포에 무슨 일이 있었는지를 알려 주지는 않습니다.
출처
- 17TRACK Tracking API — 비즈니스 시스템에 소포 추적을 통합하기 위한 제품 개요.
- 17TRACK Tracking API documentation — 운송장 번호 등록 및 추적 데이터 수신을 위한 구현 참고 자료.
- Stripe webhook documentation — 중복 이벤트 처리 및 배송 순서에 대한 가정을 피하는 방법 등 일반적인 웹훅 관행에 대한 참고 자료입니다. 검증 및 승인 절차에는 추적 제공업체의 자체 규칙을 따르세요.


