배송관리

Owned by X2BEE 관리자, created
Last updated: 2023-12-26
4 min read

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

주요 기능

  • 회수처리

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

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

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

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

  • 배송관리

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

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

  • 출고완료

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

  • 배송조회

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

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

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

프로세스 정의_ 회수처리

 

구분

설명

구분

설명

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

설명

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

설명

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

설명

Server

메소드

비고

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

엑셀을 이용해 출고완료 일괄등록 진행시 유효성 체크를 위한 배송상세정보를 조회합니다.

API-BO

GET

🔗API 확인하기 >

프로세스 정의_ 배송 조회

구분

설명

구분

설명

1

 

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

2

 

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

3

 

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

 

API 기능 목록_ 배송 조회

API

설명

Server

메소드

비고

API

설명

Server

메소드

비고

주문상품내역조회

특정 배송번호의 주문상품내역을 조회합니다.

API-BO

GET

🔗API 확인하기 >

배송목록조회

배송 목록을 조회합니다. 주문수량이 유효한 주문만 조회하고, 주문취소, 반품취소, 반품완료인 건은 조회하지 않습니다.

API-BO

GET

🔗API 확인하기 >

배송상세정보조회

특정 배송번호의 주문자정보 및 배송상세정보를 조회합니다.

API-BO

GET

🔗API 확인하기 >

기타 참고사항

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