본문으로 건너뛰기

배송 추적

개념

배송 추적은 택배사나 배송 시스템에서 받은 상태 이력을 저장하고 조회하는 기능입니다.

왜 필요한가

운영자는 배송 지연과 실패를 확인해야 하고, 고객은 현재 배송 상태를 알고 싶어 합니다.

실무 흐름

택배사 상태를 주기적으로 수신하고 내부 배송 상태로 변환합니다. 상태 이력을 남기고 최신 상태를 배송 건에 반영합니다.

개발자가 주의할 점

상태 이벤트가 순서대로 오지 않을 수 있습니다. 이미 배송 완료된 건에 이전 상태가 들어오면 무시하거나 이력만 저장합니다.

예시

IN_TRANSIT 이후 PICKED_UP 이벤트가 늦게 들어오면 최신 상태는 유지하고 이력에는 원본 이벤트를 남깁니다.

관련 문서