로그인이 필요합니다.

개발가이드(ver2.0)

운송장 개요

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

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

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

노스노스 매뉴얼: 출고회차별조회 바로가기 ▶

지원 method

운송장 기본 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"
      }
    ]
  }
}
Top