본문으로 건너뛰기

택배사 연동

개념

택배사 연동은 송장 생성, 송장 취소, 집화, 배송 추적 상태를 택배사 시스템과 주고받는 기능입니다.

왜 필요한가

배송 상태는 내부 시스템만으로 알 수 없습니다. 택배사 상태를 받아 고객 안내와 운영 추적에 사용해야 합니다.

실무 흐름

송장 생성 요청을 보내고 응답을 저장합니다. 이후 추적 배치나 웹훅으로 배송 상태를 수신합니다.

개발자가 주의할 점

택배사별 상태 코드가 다릅니다. 내부 표준 상태로 매핑하고 원본 코드는 별도 저장합니다.

예시

택배사 상태 11, 20, 91을 내부 상태 PICKED_UP, IN_TRANSIT, DELIVERED로 변환합니다.

관련 문서