로그인이 필요합니다.
클라우드 서비스 보급·확산 사업 공급기업 선정! 이용료 최대 80% 지원
홈 개발가이드(ver2.0) 출고

개발가이드(ver2.0)

출고 개요

출고요청 이후의 발주 건을 출고 조회할 수 있습니다.
해당 페이지는 물류사만 접근가능하므로, 고객사는 이용할 수 없습니다.
출고 조회는 출고 기본정보를 조회하는 출고 조회와 출고 건에 포함된 상품을 조회하는 출고대상상품 조회로 나뉩니다.

출고 조회
출고 기본 정보를 조회할 수 있습니다.
DAS 출고처리 시 이용하는 DAS 번호를 조회하거나 발주 정보 및 출고회차번호를 조회할 경우 이용합니다.

출고대상상품 조회
출고 건에 포함된 상품정보를 조회할 수 있습니다.
재고할당방식을 사용하는 경우라면 출고대상상품재고할당 조회를 이용합니다.
재고할당방식은 회차별로 상품의 재고이동정보를 저장하는 방식으로, 정확한 재고이동흐름을 파악할 때 해당 옵션을 사용합니다.

기타정보 수정
운송장번호에 저장하는 기타정보로 1~6까지 입력가능합니다.

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

지원 method

출고 기본 Object 구조

데이터필드 자료형 설명
release_id integer 출고 ID
member_id integer 고객사 ID
release_code string(100) 릴리즈코드
order_id integer 발주 ID
order_code string(20) 오더코드
company_order_code string(100) 주문번호
shipping_method_id integer 배송방식

1.택배, 2.직송, 3.새벽배송, 4.당일배송
코드정보 shipping_type_code 참고
request_shipping_dt string(8) 출고희망일

YYYYMMDD 형식
release_date string(8) 출고요청일

YYYYMMDD 형식
release_status integer 출고 진행상태

1.출고요청, 3.출고지시, 5.출고작업중, 7.출고완료, 9.출고취소
코드정보 release_status_code 참고
complete_date string(8) 출고완료일

YYYYMMDD 형식
shipping_order_info_id integer 출고회차 ID

출고회차 참고
delivery_agency_id integer 택배사 ID

택배사 참고
shipping_code string(50) 송장번호
etc1 string(50) 추가정보1
etc2 string(50) 추가정보2
etc3 string(50) 추가정보3
etc4 string(50) 추가정보4
etc5 string(50) 추가정보5
etc6 string(50) 추가정보6
buyer_name string(100) 주문자명
receiver_name string(100) 받는분 이름
tel1 string(20) 받는분 전화번호 1
tel2 string(20) 받는분 전화번호 2
zipcode string(20) 받는분 우편번호
shipping_address1 string(150) 받는분 주소1
shipping_address2 string(150) 받는분 주소2
shipping_message string(150) 배송 메시지
channel_id integer 발주타입

발주타입 참고
das_num string(4) DAS 번호

add_barcode_object 구조

데이터필드 자료형 설명
barcode string(100) 바코드
quantity integer 매칭 수량

출고 조회(단일)

Request URI /v2/release/{릴리즈ID}
Method GET
권한 물류사

Response Param

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

Request Sample

/v2/release/54391

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "release_id": "54391",
    "member_id": "70",
    "release_code": "R20220107-00358",
    "order_id": "187444",
    "order_code": "O20220107-02318",
    "company_order_code": "20220104-00001",
    "shipping_method_id": "1",
    "request_shipping_dt": "20220107",
    "release_date": "20220107",
    "release_status": "9",
    "complete_date": "20220916",
    "shipping_order_info_id": "",
    "delivery_agency_id": "",
    "shipping_code": "",
    "etc1": "",
    "etc2": "",
    "etc3": "",
    "etc4": "",
    "etc5": "",
    "etc6": "",
    "buyer_name": "홍길동",
    "receiver_name": "홍길동",
    "tel1": "01023545555",
    "tel2": "01066668888",
    "zipcode": "13494",
    "shipping_address1": "경기 성남시 분당구 삼평동 681",
    "shipping_address2": "1층",
    "shipping_message": "문앞",
    "channel_id": "37",
    "das_num" : "1"
  }
}

출고 조회(벌크)

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

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

필수
release_ids array 릴리즈 ID 배열

최대 100개
release_codes array 릴리즈코드 배열

최대 100개
order_ids array 발주 ID 배열

최대 100개
shipping_order_info_id integer 출고지시 ID
release_date string(8) 출고요청일

YYYYMMDD 형식
request_shipping_dt string(8) 출고희망일

YYYYMMDD 형식
start_complete_dt string(8) 출고완료일 시작일

YYYYMMDD 형식
end_complete_dt string(8) 출고완료일 종료일

YYYYMMDD 형식
page integer 페이지 번호

Response Param

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

처리 데이터 리스트

 dataList 출고 기본 Object 구성 ▶

Request Sample

/v2/releases?member_id=&release_ids=60316&release_codes=R20220602-00006&order_ids=187377&order_ids=187378&order_ids=187379&shipping_order_info_id=2594&release_date=20220110&request_shipping_dt=20220110&&start_complete_dt=20220602&end_complete_dt=20220603&page=1

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 2,
    "total_page": 1,
    "current_page": 1,
    "data_list": [
      {
        "release_id": "60316",
        "member_id": "70",
        "release_code": "R20220602-00007",
        "order_id": "194496",
        "order_code": "O20220602-00006",
        "company_order_code": "20220602-0002",
        "shipping_method_id": "1",
        "request_shipping_dt": "20220602",
        "release_date": "20220602",
        "release_status": "7",
        "complete_date": "20220603",
        "shipping_order_info_id": "3156",
        "delivery_agency_id": "4",
        "shipping_code": "551473316902",
        "etc1": "",
        "etc2": "",
        "etc3": "",
        "etc4": "",
        "etc5": "",
        "etc6": "",
        "buyer_name": "홍길동",
        "receiver_name": "홍길동",
        "tel1": "010+12345=678",
        "tel2": "01033335555",
        "zipcode": "",
        "shipping_address1": "서울시 강서구 공항대로 168",
        "shipping_address2": "1207호",
        "shipping_message": "ㅇㅇㅇ",
        "channel_id": "36",
        "das_num": "C22"
      },
      {
        "release_id": "60315",
        "member_id": "70",
        "release_code": "R20220602-00006",
        "order_id": "194495",
        "order_code": "O20220602-00005",
        "company_order_code": "20220602-0001",
        "shipping_method_id": "1",
        "request_shipping_dt": "20220602",
        "release_date": "20220602",
        "release_status": "7",
        "complete_date": "20220603",
        "shipping_order_info_id": "3156",
        "delivery_agency_id": "4",
        "shipping_code": "551473316891",
        "etc1": "",
        "etc2": "",
        "etc3": "",
        "etc4": "",
        "etc5": "",
        "etc6": "",
        "buyer_name": "홍길동",
        "receiver_name": "홍길동",
        "tel1": "01011112222",
        "tel2": "01033334444",
        "zipcode": "07807",
        "shipping_address1": "서울 강서구 공항대로 168 (마곡동, 747)",
        "shipping_address2": "1207호",
        "shipping_message": "문 앞",
        "channel_id": "36",
        "das_num": "B11"
      }
    ]
  }
}

출고대상상품 조회(벌크)

Request URI /v2/release/items
Method GET
권한 물류사

Request Param

데이터필드 자료형 설명
release_ids array 릴리즈 ID 배열

최대100개
release_ids, shipping_order_info_id, release_codes 중 하나 필수
shipping_order_info_id integer 출고지시 ID

release_ids, shipping_order_info_id, release_codes 중 하나 필수
release_codes array 릴리즈코드 배열

최대100개
release_ids, shipping_order_info_id, release_codes 중 하나 필수
page integer 페이지번호

Response Param

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

처리 데이터 리스트

 release_item_id integer 출고대상상품 ID
release_id integer 출고 ID
shipping_product_id integer 출고상품 ID
quantity integer 수량
release_code string(20) 릴리즈코드
release_status integer(1) 출고 진행상태

1.출고요청, 3.출고지시, 5.출고작업중, 7.출고완료, 9.출고취소
코드정보 release_status_code 참고
product_name string(100) 출고상품명
product_code string(20) 출고상품코드
upc string(50) 대표바코드
shipping_code string(50) 운송장 번호
receiver_name string(100) 받는분 이름
add_barcode_list childDataObject add_barcode_object 구성 ▶

추가 바코드 리스트

Request Sample

/v2/release/items?shipping_order_info_id=1550

/v2/release/items?release_ids=611&release_codes=R20220110-00003

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 22,
    "total_page": 3,
    "current_page": 1,
    "data_list": [
      {
        "release_item_id": "103630",
        "release_id": "54394",
        "shipping_product_id": "41674",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "새우볶음밥",
        "upc": "0445541111",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "00445541111"
          },
          {
            "quantity": "1",
            "barcode": "12354559978"
          },
          {
            "quantity": "1",
            "barcode": "01545451218"
          },
          {
            "quantity": "1",
            "barcode": "1234567778"
          }
        ]
      },
      {
        "release_item_id": "103629",
        "release_id": "54394",
        "shipping_product_id": "41673",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "소고기 볶음밥",
        "upc": "0455544551",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "05454845121"
          },
          {
            "quantity": "1",
            "barcode": "12354559977"
          },
          {
            "quantity": "1",
            "barcode": "8787878484"
          },
          {
            "quantity": "1",
            "barcode": "01545451217"
          },
          {
            "quantity": "1",
            "barcode": "1234567777"
          }
        ]
      },
      {
        "release_item_id": "103628",
        "release_id": "54394",
        "shipping_product_id": "41672",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "야채 볶음밥",
        "upc": "0545445588",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "1111221"
          },
          {
            "quantity": "1",
            "barcode": "01545451216"
          }
        ]
      },
      {
        "release_item_id": "103627",
        "release_id": "54394",
        "shipping_product_id": "41671",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "낙지 볶음밥",
        "upc": "055554443",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "2121211"
          },
          {
            "quantity": "1",
            "barcode": "01545451215"
          }
        ]
      },
      {
        "release_item_id": "103626",
        "release_id": "54394",
        "shipping_product_id": "41670",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "소고기죽",
        "upc": "000112202",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "21215111"
          },
          {
            "quantity": "3",
            "barcode": "888090644"
          },
          {
            "quantity": "1",
            "barcode": "01545451214"
          },
          {
            "quantity": "1",
            "barcode": "12120312507"
          },
          {
            "quantity": "1",
            "barcode": "12120312508"
          }
        ]
      },
      {
        "release_item_id": "103625",
        "release_id": "54394",
        "shipping_product_id": "41669",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "전복죽",
        "upc": "000112228",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "10",
            "barcode": "888090631"
          },
          {
            "quantity": "1",
            "barcode": "888090632"
          },
          {
            "quantity": "2",
            "barcode": "888090643"
          },
          {
            "quantity": "1",
            "barcode": "01545451213"
          },
          {
            "quantity": "1",
            "barcode": "12120312452"
          }
        ]
      },
      {
        "release_item_id": "103624",
        "release_id": "54394",
        "shipping_product_id": "43831",
        "quantity": "2",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "버섯야채죽",
        "upc": "98452122555",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": []
      },
      {
        "release_item_id": "103623",
        "release_id": "54394",
        "shipping_product_id": "43799",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "사천볶음밥",
        "upc": "687848455111",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "878444444"
          }
        ]
      },
      {
        "release_item_id": "103622",
        "release_id": "54394",
        "shipping_product_id": "43797",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "낙지전복죽",
        "upc": "687848455111",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "878444444"
          }
        ]
      },
      {
        "release_item_id": "103621",
        "release_id": "54394",
        "shipping_product_id": "43795",
        "quantity": "1",
        "release_code": "R20220110-00003",
        "release_status": "9",
        "product_name": "간편죽",
        "upc": "687848455111",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "878444444"
          }
        ]
      }
    ]
  }
}

출고대상상품재고할당 조회(벌크)

Request URI /v2/release/item_stocks
Method GET
권한 물류사
비고 재고할당방식 옵션을 사용하는 경우에만 사용 가능. 출고진행상태가 출고지시이후인 경우에만 조회 가능

Request Param

데이터필드 자료형 설명
release_ids array 릴리즈 ID 배열

최대100개
release_ids, shipping_order_info_id, release_codes 중 하나 필수

shipping_order_info_id integer 출고지시 ID

release_ids, shipping_order_info_id, release_codes 중 하나 필수
release_codes array 릴리즈코드 배열

최대100개
release_ids, shipping_order_info_id, release_codes 중 하나 필수
page integer 페이지번호

Response Param

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

처리 데이터 리스트

 release_item_id integer 출고대상상품 ID
release_id integer 출고 ID
shipping_product_id integer 출고상품 ID
quantity integer 수량
release_code string(20) 릴리즈코드
release_status integer(1) 출고 진행상태

1.출고요청, 3.출고지시, 5.출고작업중, 7.출고완료, 9.출고취소
코드정보 release_status_code 참고
product_name string(100) 출고상품명
product_code string(20) 출고상품코드
upc string(50) 대표바코드
location_id integer 로케이션 ID
location_name string(20) 로케이션명
expire_date string(8) 유통기한

YYYYMMDD 형식
add_barcode_list childDataObject add_barcode_object 구성 ▶

추가 바코드 리스트
shipping_code string(50) 운송장 번호
receiver_name string(100) 받는분 이름

Request Sample

/v2/release/item_stocks?shipping_order_info_id=1550

/v2/release/item_stocks?release_ids=52332&release_codes=R20220107-00357&page=1

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 5,
    "total_page": 1,
    "current_page": 1,
    "data_list": [
      {
        "release_item_id": "103609",
        "release_id": "54390",
        "shipping_product_id": "41667",
        "quantity": "5",
        "release_code": "R20220107-00357",
        "release_status": "7",
        "product_name": "새우볶음밥",
        "upc": "888090641",
        "location_id": "2",
        "location_name": "100-01",
        "expire_date": "20220131",
        "shipping_code": "test1234",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "10",
            "barcode": "888090643"
          },
          {
            "quantity": "1",
            "barcode": "00000001"
          }
        ]
      },
      {
        "release_item_id": "103608",
        "release_id": "54389",
        "shipping_product_id": "41667",
        "quantity": "5",
        "release_code": "R20220107-00356",
        "release_status": "3",
        "product_name": "야채볶음밥",
        "upc": "888090641",
        "location_id": "2",
        "location_name": "100-01",
        "expire_date": "20220131",
        "shipping_code": "880123456789",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "10",
            "barcode": "888090643"
          },
          {
            "quantity": "10",
            "barcode": "888090642"
          },
          {
            "quantity": "1",
            "barcode": "01545451211"
          },
          {
            "quantity": "1",
            "barcode": "12120312451"
          },
          {
            "quantity": "1",
            "barcode": "00000001"
          }
        ]
      },
      {
        "release_item_id": "103555",
        "release_id": "54336",
        "shipping_product_id": "41668",
        "quantity": "1",
        "release_code": "R20220107-00303",
        "release_status": "7",
        "product_name": "소고기볶음밥",
        "upc": "00000112202",
        "location_id": "57",
        "location_name": "002-02",
        "expire_date": "",
        "shipping_code": "880123456788",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "411115541"
          },
          {
            "quantity": "1",
            "barcode": "asdTs0123"
          }
        ]
      },
      {
        "release_item_id": "103554",
        "release_id": "54335",
        "shipping_product_id": "41668",
        "quantity": "1",
        "release_code": "R20220107-00302",
        "release_status": "7",
        "product_name": "소고기볶음밥",
        "upc": "00000112202",
        "location_id": "57",
        "location_name": "002-02",
        "expire_date": "",
        "shipping_code": "880123456787",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "asdTs0123"
          }
        ]
      },
      {
        "release_item_id": "103553",
        "release_id": "54334",
        "shipping_product_id": "41668",
        "quantity": "1",
        "release_code": "R20220107-00301",
        "release_status": "7",
        "product_name": "소고기볶음밥",
        "upc": "00000112202",
        "location_id": "57",
        "location_name": "002-02",
        "expire_date": "",
        "shipping_code": "880123456786",
        "receiver_name": "홍길동",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "411115541"
          },
          {
            "quantity": "1",
            "barcode": "asdTs0123"
          }
        ]
      }
    ]
  }
}

기타정보 수정(단일)

Request URI /v2/release_etc/{릴리즈ID}
Method PUT
권한 물류사

Request Param

데이터필드 자료형 설명
etc1 string(50) 출고정보 1

출고정보 1~6 중에 하나는 값이 있어야 함
etc2 string(50) 출고정보 2
etc3 string(50) 출고정보 3
etc4 string(50) 출고정보 4
etc5 string(50) 출고정보 5
etc6 string(50) 출고정보 6

Response Param

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

Request Sample

{
    "etc1":"재출고 ",
    "etc2":"출고정보2 참고",
    "etc3":"",
    "etc4":"",
    "etc5":"",
    "etc6":""
}

Response Sample

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

기타정보 수정(벌크)

Request URI /v2/release_etcs
Method PUT
권한 물류사

Request Param

데이터필드 자료형 설명
request_data_list

요청 데이터 리스트,
최대 100개

 release_id integer 출고 ID

필수
etc1 string(50) 출고정보 1

출고정보 1~6 중에 하나는 값이 있어야 함
etc2 string(50) 출고정보 2
etc3 string(50) 출고정보 3
etc4 string(50) 출고정보 4
etc5 string(50) 출고정보 5
etc6 string(50) 출고정보 6

Response Param

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

Request Sample

{
  "request_data_list": [
    {
      "release_id": "4904",
      "etc1": "aaa",
      "etc2": "bbb",
      "etc3": "ccc",
      "etc4": "",
      "etc5": "",
      "etc6": ""
    },
    {
      "release_id": "4905",
      "etc1": "bbb",
      "etc2": "메모2",
      "etc3": "메모3",
      "etc4": "",
      "etc5": "",
      "etc6": "메모6"
    },
    {
      "release_id": "4903",
      "etc1": "s-Oil",
      "etc2": "Gas",
      "etc3": "",
      "etc4": "",
      "etc5": "",
      "etc6": ""
    }
  ]
}

Response Sample

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