운송장 개요

운송장은 기존에 입력된 운송장을 수정하는 운송장 수정과 운송장을 조회하는 운송장 조회로 나뉩니다.

운송장 수정
출고작업중인 출고 건의 경우에만 운송장 수정가능합니다.
운송장 수정은 물류사만 접근가능하므로, 고객사는 이용할 수 없습니다.
*추후 업데이트를 통해 운송장 등록도 지원 예정

운송장 조회
출고희망일 또는 릴리즈 ID로 조회할 경우 운송장 일반 조회(벌크)를 이용합니다.
최근에 입력된 운송장만 조회하고자 할 경우, 운송장 최근 조회(벌크)를 이용합니다.
최종키값은 릴리즈 히스토리에서 최종적으로 조회한 키값이므로, 갱신된 데이터를 다시 조회할 경우 최종키값을 참고해서 사용합니다.

사방넷 풀필먼트 매뉴얼: 출고회차별조회 바로가기 ▶

운송장 기본 Object 구조

데이터필드	자료형	설명
order_id	integer	발주 ID
order_code	string(20)	오더코드
company_order_code	string(100)	주문번호
request_shipping_dt	string(8)	출고희망일 YYYYMMDD 형식
release_id	integer	릴리즈 ID
release_status	integer	출고 진행상태 1.출고요청, 3.출고지시, 5.출고작업중, 7.출고완료, 9.출고취소 코드정보 release_status_code 참고
delivery_agency_id	integer	택배사 ID 택배사 참고
shipping_code	string(50)	운송장번호

운송장 수정(단일)

Request URI	/v2/release/shipping_code/{릴리즈ID}
Method	PUT
권한	물류사
비고	기존에 입력된 운송장 번호만 업데이트 함

Response Param

데이터필드	자료형	설명
delivery_agency_id	integer	택배사 ID 필수, 택배사 참고
shipping_code	string(50)	송장번호 필수

Response Param

데이터필드	자료형	설명
code	string(4)	응답코드
message	string(100)	응답메시지

Request Sample

{
    "delivery_agency_id":4,
    "shipping_code":"SONG102371ABA54"
}

Response Sample

{
  "code": "9999",
  "message": "ok"
}

운송장 수정(벌크)

Request URI	/v2/release/shipping_codes
Method	PUT
권한	물류사
비고	기존에 입력된 운송장 번호만 업데이트 함

Request Param

데이터필드		자료형	설명
request_data_list 요청 데이터 리스트, 최대 100개	release_id	integer	릴리즈 ID 필수
	delivery_agency_id	integer	택배사 ID 필수, 택배사 참고
	shipping_code	string(50)	릴리즈 ID 필수

Response Param

데이터필드	자료형	설명
code	string(4)	응답코드
message	string(100)	응답메시지

Request Sample

{
  "request_data_list": [
    {
      "release_id": "40239",
      "delivery_agency_id": 10,
      "shipping_code": "AA11"
    },
    {
      "release_id": "40341",
      "delivery_agency_id": 3,
      "shipping_code": "BB22"
    },
    {
      "release_id": "40051",
      "delivery_agency_id": 4,
      "shipping_code": "CC33"
    }
  ]
}

Response Sample

{
  "code": "9999",
  "message": "ok"
}

운송장 일반 조회(벌크)

Request URI	/v2/release/shipping_codes
Method	GET
권한	물류사, 고객사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
request_shipping_dt	string(8)	출고희망일 필수, YYYYMMDD 형식
order_id	integer	발주 ID 발주조회 참고
company_order_code	string(100)	주문번호
release_id	integer	릴리즈 ID
release_status	integer	출고 진행상태 1.출고요청, 3.출고지시, 5.출고작업중, 7.출고완료, 9.출고취소 코드정보 release_status_code 참고
delivery_agency_id	integer	택배사 ID 택배사 참고
page	integer	페이지번호

Response Param

데이터필드			자료형	설명
code			string(4)	응답코드
message			string(100)	응답메시지
response	total_count		integer	전체 갯수
	total_page		integer	전체 페이지수
	current_page		integer	현재 페이지 번호
	data_list 처리 데이터 리스트	order_id	integer	발주 ID
		order_code	string(20)	오더코드
		company_order_code	string(100)	주문번호
		request_shipping_dt	string(8)	출고희망일 YYYYMMDD 형식
		release_id	integer	릴리즈 ID
		release_status	integer	출고 진행상태 1.출고요청, 3.출고지시, 5.출고작업중, 7.출고완료, 9.출고취소 코드정보 release_status_code 참고
		delivery_agency_id	integer	택배사 ID
		shipping_code	string(50)	운송장번호

Request Sample

/v2/release/shipping_codes?member_id=70&request_shipping_dt=20220110&order_id=187445

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 2,
    "total_page": 1,
    "current_page": 1,
    "data_list": [
      {
        "order_id": "187445",
        "order_code": "O20220110-00001",
        "company_order_code": "",
        "request_shipping_dt": "20220110",
        "release_id": "54392",
        "release_status": "7",
        "delivery_agency_id": "4",
        "shipping_code": "551473296020"
      },
      {
        "order_id": "187445",
        "order_code": "O20220110-00001",
        "company_order_code": "",
        "request_shipping_dt": "20220110",
        "release_id": "54396",
        "release_status": "7",
        "delivery_agency_id": "4",
        "shipping_code": "551473296031"
      }
    ]
  }
}

운송장 최근 조회(벌크)

Request URI	/v2/release/recent_shipping_codes
Method	GET
권한	물류사, 고객사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
release_date	string(8)	출고희망일 필수, YYYYMMDD 형식
last_history_id	integer	최종키값 최종값이 있을 경우 페이지번호는 1로 고정됨
page	integer	페이지번호

Response Param

데이터필드			자료형	설명
code			string(4)	응답코드
message			string(100)	응답메시지
response	last_history_id		integer	전체 갯수
	total_count		integer	최종키값
	total_page		integer	전체 페이지수
	current_page		integer	현재 페이지 번호
	data_list 처리 데이터 리스트	order_id	integer	발주 ID
		company_order_code	string(100)	주문번호
		release_id	integer	릴리즈 ID
		delivery_agency_id	integer	택배사 ID 택배사 참고
		shipping_code	string(50)	운송장번호
		create_dt	string(8)	송장 등록일 YYYYMMDD 형식

Request Sample

/v2/release/recent_shipping_codes?member_id=70&release_date=20220111&last_history_id=6714484

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 2,
    "total_page": 1,
    "current_page": 1,
    "last_history_id": 6718574,
    "data_list": [
      {
        "order_id": "187491",
        "company_order_code": "",
        "release_id": "54943",
        "delivery_agency_id": "1",
        "shipping_code": "402353522196",
        "create_dt": "20220119"
      },
      {
        "order_id": "187497",
        "company_order_code": "",
        "release_id": "54448",
        "delivery_agency_id": "11",
        "shipping_code": "23423424234",
        "create_dt": "20220128"
      }
    ]
  }
}

개발가이드(ver2.0)

운송장 개요

지원 method

운송장 기본 Object 구조

운송장 수정(단일)

Response Param

Response Param

Request Sample

Response Sample

운송장 수정(벌크)

Request Param

Response Param

Request Sample

Response Sample

운송장 일반 조회(벌크)

Request Param

Response Param

Request Sample

Response Sample

운송장 최근 조회(벌크)

Request Param

Response Param

Request Sample

Response Sample