본문으로 건너뛰기

배송 추적

개념​

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

왜 필요한가​

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

실무 흐름​

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

개발자가 주의할 점​

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

예시​

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

관련 문서​