로그인이 필요합니다.
클라우드 서비스 보급·확산 사업 공급기업 선정! 이용료 최대 80% 지원

개발가이드(ver2.0)

로케이션 개요

등록된 로케이션 정보를 조회할 수 있습니다.
해당 페이지는 물류사만 접근가능하므로, 고객사는 이용할 수 없습니다.
데이터필드 status가 1.사용인 경우만 로케이션관리페이지에서 노출됩니다.

사방넷 풀필먼트 매뉴얼: 로케이션관리 바로가기 ▶

지원 method

로케이션 기본 Object 구조

데이터필드 자료형 설명
location_id integer 로케이션 ID
location_name string(20) 로케이션명
loc_type integer 로케이션 타입

1.입고, 2.출고가능, 3.출고지시, 4.출고작업, 5.반품, 6.불량, 7.보관
코드정보 loc_type_code 참고

temperature integer 온도 ID
temperature_name string(50) 온도 구분명
system integer 설비 ID
system_name string(50) 설비 구분명
cbm double CBM
mix_state integer 혼적 사용여부

1.사용, 0.사용안함

receiving_limit integer 입고제한

1.제한, 0.제한없음

shipping_limit integer 출고제한

1.제한, 0.제한없음

distance1 integer 거리 1
distance2 integer 거리 2
distance3 integer 거리 3
keyword1 string(50) 관리 키워드1
keyword2 string(50) 관리 키워드2
keyword3 string(50) 관리 키워드3
status integer 사용여부

1.사용, 0.사용안함

로케이션 조회(단일)

Request URI /v2/location/{로케이션ID}
Method GET
권한 물류사

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response dataObject 로케이션 기본 Object 구성 ▶

Request Sample

/v2/location/100

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "location_id": "100",
    "location_name": "20211001 정상입고",
    "loc_type": "2",
    "temperature": "0",
    "temperature_name": "",
    "system": "0",
    "system_name": "",
    "cbm": "0.0",
    "mix_state": "1",
    "receiving_limit": "0",
    "shipping_limit": "0",
    "distance1": "0",
    "distance2": "0",
    "distance3": "0",
    "keyword1": "",
    "keyword2": "",
    "keyword3": "",
    "status": "1"
  }
}

로케이션 조회(벌크)

Request URI /v2/locations
Method GET
권한 물류사

Response Param

데이터필드 자료형 설명
location_ids array 로케이션 ID
loc_type integer 로케이션 타입

1.입고, 2.출고가능, 3.출고지시, 4.출고작업, 5.반품, 6.불량, 7.보관
코드정보 loc_type_code 참고

page integer 페이지 번호

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response total_count integer 전체 갯수
total_page integer 전체 페이지수
current_page integer 현재 페이지 번호
data_list

array

dataList 로케이션 기본 Object 구성 ▶

Response Sample

/v2/locations?loc_type=2&location_ids%5B0%5D=100&location_ids%5B1%5D=101&location_ids%5B2%5D=102&page=1

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 6,
    "total_page": 1,
    "current_page": 1,
    "data_list": [
      {
        "location_id": "100",
        "location_name": "20211001 정상입고",
        "loc_type": "2",
        "temperature": "0",
        "temperature_name": "",
        "system": "0",
        "system_name": "",
        "cbm": "0.0",
        "mix_state": "1",
        "receiving_limit": "0",
        "shipping_limit": "0",
        "distance1": "0",
        "distance2": "0",
        "distance3": "0",
        "keyword1": "",
        "keyword2": "",
        "keyword3": "",
        "status": "1"
      },
      {
        "location_id": "101",
        "location_name": "20211130 FSG 정상입고",
        "loc_type": "2",
        "temperature": "0",
        "temperature_name": "",
        "system": "0",
        "system_name": "",
        "cbm": "0.0",
        "mix_state": "1",
        "receiving_limit": "0",
        "shipping_limit": "0",
        "distance1": "0",
        "distance2": "0",
        "distance3": "0",
        "keyword1": "",
        "keyword2": "",
        "keyword3": "",
        "status": "1"
      },
      {
        "location_id": "106",
        "location_name": "F0655",
        "loc_type": "2",
        "temperature": "0",
        "temperature_name": "",
        "system": "0",
        "system_name": "",
        "cbm": "0.0",
        "mix_state": "1",
        "receiving_limit": "0",
        "shipping_limit": "0",
        "distance1": "0",
        "distance2": "0",
        "distance3": "0",
        "keyword1": "",
        "keyword2": "",
        "keyword3": "",
        "status": "1"
      }
    ]
  }
}
Top