본문으로 건너뛰기

TMS 개요

개념​

TMS는 Transportation Management System의 약자로 배송 지시, 송장 생성, 택배사 연동, 배송 추적을 관리하는 시스템입니다.

왜 필요한가​

WMS가 창고 안의 출고 작업을 담당한다면 TMS는 창고 밖 배송 흐름을 관리합니다. 출고 완료와 배송 완료는 서로 다른 이벤트입니다.

실무 흐름​

WMS 출고 대상이 준비되면 TMS가 배송 지시를 생성하고 송장을 발급합니다. 이후 택배사 상태를 수신해 배송 중, 배송 완료, 반송 같은 상태를 갱신합니다.

개발자가 주의할 점​

택배사 API는 지연, 중복, 부분 실패가 자주 발생합니다. 송장 번호를 멱등 키처럼 다루고 재시도 로그를 남겨야 합니다.

예시​

출고확정은 WMS에서 끝났지만 택배사 집화 전이면 배송 상태는 아직 READY_FOR_PICKUP일 수 있습니다.

관련 문서​