배송관리

주문 처리에 필요한 다양한 기능을 제공하여 효율적인 상품 배송 및 관리를 지원합니다. 이를 통해 회수처리, 배송관리, 출고완료, 배송조회 등 다양한 배송 관련 작업을 간편하게 수행할 수 있습니다.

---

주요 기능

• 회수처리

  • 회수 상태 업데이트: 회수 대상에 대해 상태를 업데이트합니다.

  • 회수 지시 처리: 반품 및 교환 접수에 대한 회수지시를 처리합니다.

  • 반품/교환 처리: 회수 확인 대상에 대해 반품전환 또는 반품불가를 처리합니다.

  • 회수 데이터 조회: 회수대상 목록 및 상세 정보를 조회합니다.

• 배송관리

  • 상태 처리: 결품 및 배송 처리에 대한 상태를 변경합니다.

  • 처리 목록 조회: 결품 및 배송처리대상 목록을 조회합니다.

• 출고완료

  • 일괄 등록 조회: 일괄 출고완료 처리에 필요한 정보를 조회합니다.

• 배송조회

  • 상품내역 조회: 배송상세팝업에서 주문상품내역 목록을 조회합니다.

  • 배송목록 조회: 배송 처리를 위한 목록을 조회합니다.

  • 상세정보 조회: 배송상세팝업에서 주문자 및 배송 정보를 조회합니다.

---

프로세스 정의 — 회수처리

1

회수대상 목록 조회

관리자는 회수대상(회수지시처리, 회수확인처리, 회수완료처리) 목록을 조회합니다. BO API의 “회수 조회”를 이용해서 목록을 조회합니다.

2

회수 상태 업데이트

관리자는 회수대상(회수확인처리, 회수완료처리) 목록을 조회 후 회수상태 값을 업데이트 합니다.

• 회수지시건은 회수확인으로 변경

• 회수확인건은 회수완료로 변경

BO API의 “회수 상태 업데이트”, ORDER API의 “회수 진행상태 수정”을 이용해서 회수 진행상태를 업데이트 합니다.

3

회수지시 처리

관리자는 접수 대상(반품접수, 교환접수) 목록을 조회 후 회수상태 값을 업데이트 합니다.

• 접수 대상건에 대해 회수지시로 상태를 변경

BO API의 “회수지시처리”, ORDER API의 “회수지시”를 이용해서 회수지시 처리를 진행합니다.

4

교환 중 반품 처리

관리자는 회수확인 상태의 목록을 조회 후 교환 중 반품처리를 합니다. BO API의 “교환중반품처리”, ORDER API의 “교환중반품”을 이용해서 처리를 진행합니다.

5

반품불가 처리

관리자는 회수확인 상태의 목록을 조회 후 반품불가 처리를 합니다. BO API의 “반품불가처리”, ORDER API의 “교환중반품”을 이용해서 처리를 진행합니다.

6

회수상세팝업 정보 조회

관리자는 회수배송번호를 이용해 회수상세팝업에 필요한 정보를 조회합니다. BO API의 “회수상세팝업조회” 를 이용해서 조회합니다.

---

API 기능 목록 — 회수 관리

API	설명	Server	메소드	비고
회수 상태 업데이트	요청 받은 현재 주문내역 상태, 업데이트 예정 주문내역상태를 이용해 대상목록 회수상태를 업데이트 합니다.	API-BO	POST	🔗API 확인하기 > 주문 api 호출
회수 지시 처리	주문내역상태가 반품접수 상태인 주문 목록을 회수지시 상태로 업데이트 합니다.	API-BO	POST	🔗API 확인하기 > 주문 api 호출
교환 중 반품 처리	회수 처리 진행중인 건에 대해 반품전환 처리를 진행합니다.	API-BO	POST	🔗API 확인하기 > 주문 api 호출
반품불가 처리	회수 처리 진행중인 건에 대해 반품접수 불가 처리를 진행합니다.	API-BO	POST	🔗API 확인하기 > 주문 api 호출
회수 조회	회수지시처리, 회수확인처리, 회수완료처리 화면의 데이터를 조회합니다.	API-BO	GET	🔗API 확인하기 >
회수 상세 팝업 조회	회수상세 팝업에 필요한 주문자정보 및 반품상세정보를 조회합니다.	API-BO	GET	🔗API 확인하기 >

---

프로세스 정의 — 배송관리

1

배송처리 대상 목록 조회

관리자는 배송처리대상(배송지시처리, 출고지시처리, 출고완료처리, 배송완료처리, 결품처리)목록을 조회합니다. BO API의 “배송처리목록조회”를 이용해서 목록을 조회합니다.

2

배송 상태 업데이트

관리자는 배송처리대상(배송지시처리, 출고지시처리, 출고완료처리, 배송완료처리) 목록을 조회 후 배송상태 값을 아래와 같이 업데이트 합니다.

• 주문완료 -> 배송지시

• 배송지시 -> 출고지시

• 출고지시 -> 출고완료

• 출고완료 -> 배송완료

BO API의 “배송처리”, ORDER API의 “배송처리”를 이용해서 배송 처리상태를 업데이트 합니다.

3

결품 처리

관리자는 결품처리대상(결품등록처리, 결품해제처리) 목록을 조회 후 결품상태 값을 아래와 같이 업데이트 합니다.

• 출고지시 -> 출고대기(결품등록)

• 출고대기 -> 출고지시(결품해제)

BO API의 “결품처리”, ORDER API의 “결품처리”를 이용해서 결품 처리상태를 업데이트 합니다.

4

배송 완료 처리

외부 배송 추적 시스템(스윗트래커)에서 수신받은 정보 중 배송 완료 건에 대해 배송 처리를 진행합니다. 외부 배송 추적 시스템에서 ORDER API의 “운송장 트래킹 정보 수신” URL 호출하여 배송완료처리를 진행합니다.

다음은 자동배송완료 및 자동운송장등록 관련 절차입니다.

1

출고완료 목록 조회

자동배송완료배치는 출고완료목록 조회 후 배송완료 처리를 진행합니다.

2

배송방법이 택배인 경우

출고완료목록 중 배송방법이 택배(배송방법코드 : 10, 택배사코드 참조1값 : Y)인 데이터에 대해 배송추적시스템에서 배송완료인 데이터 조회 후 배송완료 처리합니다.

3

배송방법이 택배가 아닌 경우

배송방법이 택배가 아닌 경우는 모든 데이터를 배송완료 처리합니다.

4

배송완료처리

배송완료처리는 ORDER API의 “배송완료지시배치”를 이용해 처리합니다.

5

운송장 등록 대상 목록 조회

자동운송장등록배치는 아래 조건에 해당하는 데이터 조회 후 등록을 진행합니다.

• 주문내역상태 : 출고완료

• 배송방법 : 택배

• 주문배송정보연동이력 테이블 미등록 배송번호

6

배송 추적 시스템 운송장 등록

운송장 등록시 외부배송추적시스템에 데이터를 전송하고, 주문배송정보연동이력 테이블에 이력 데이터를 저장합니다.

---

API 기능 목록 — 배송관리

API	설명	Server	메소드	비고
결품처리	주문내역상태코드 업데이트를 통해 결품등록, 결품해제를 진행합니다.	API-BO	POST	🔗API 확인하기 > 주문 api 호출
배송처리	주문내역상태코드 업데이트를 통해 배송처리(배송지시, 출고지시, 출고완료, 배송완료)를 진행합니다.	API-BO	POST	🔗API 확인하기 > 주문 api 호출
배송처리목록조회	배송처리 진행중인 목록을 조회합니다. 주문수량이 유효한 주문만 조회하고, 주문취소, 반품취소, 반품완료인 건은 조회하지 않습니다.	API-BO	GET	🔗API 확인하기 >

---

프로세스 정의 — 출고완료

1

출고 완료 일괄 등록 정보 조회

관리자는 엑셀 대량 데이터 일괄 출고완료 처리를 위해 데이터 조회 후 유효성 체크를 진행합니다. 정보 조회는 BO API의 “출고완료일괄등록정보조회”를 이용합니다.

2

출고완료 상태로 업데이트

유효성 체크가 완료된 데이터는 BO API의 “배송처리”, ORDER API의 “배송처리”를 이용해서 배송상태를 출고 완료 상태로 업데이트 합니다.

---

API 기능 목록 — 출고완료

API	설명	Server	메소드	비고
출고완료일괄등록정보조회	엑셀을 이용해 출고완료 일괄등록 진행시 유효성 체크를 위한 배송상세정보를 조회합니다.	API-BO	GET	🔗API 확인하기 >

---

프로세스 정의 — 배송 조회

1

배송관리 화면 목록 조회

관리자는 배송 처리를 위한 배송관리 화면의 목록을 조회합니다. 정보 조회는 BO API의 “배송목록조회”를 이용합니다.

2

배송상세 정보 조회

관리자는 배송상세팝업의 주문자 및 배송 정보를 조회합니다. 정보 조회는 BO API의 “배송상세정보조회”를 이용합니다. 정보 조회시 개인정보조회 권한에 따른 마스킹 정보가 조회됩니다.

3

주문상품내역 조회

관리자는 배송상세팝업의 주문상품내역 목록을 조회합니다. 정보 조회는 BO API의 “주문상품내역조회”를 이용합니다.

---

API 기능 목록 — 배송 조회

API	설명	Server	메소드
주문상품내역조회	특정 배송번호의 주문상품내역을 조회합니다.	API-BO	GET	🔗API 확인하기 >
배송목록조회	배송 목록을 조회합니다. 주문수량이 유효한 주문만 조회하고, 주문취소, 반품취소, 반품완료인 건은 조회하지 않습니다.	API-BO	GET	🔗API 확인하기 >
배송상세정보조회	특정 배송번호의 주문자정보 및 배송상세정보를 조회합니다.	API-BO	GET	🔗API 확인하기 >

---

기타 참고사항

• 스윗트래커 개발 가이드 - 가이드 문서 바로가기 >

• 배송추적시스템 설정 - BATCH-MBOD

application-local.properties application-dev.properties	delivery.api.externalUrl =외부에서 접근 가능한 order api url delivery.api.provider=db 등록/수정 사용자 id delivery.api.url=배송추적시스템(스윗트래커) url delivery.api.tier=배송추적시스템에서 발급받은 tier delivery.api.key=배송추적시스템에서 발급받은 key delivery.api.type=요청 데이터 type delivery.tracking.path=배송정보조회요청path delivery.register.path=운송장등록요청 path delivery.callback.path=배송추적정보수신path	배송추적정보수신 full url : delivery.api.externalUrl + delivery.callback.path 배송정보조회 full url : delivery.api.url + delivery.tracking.path 운송장등록 full url : delivery.api.url + delivery.register.path

---