발주 개요
등록한 발주를 수정할 경우엔 발주 진행상태가 order_status=1인 경우에만 가능합니다.
사방넷 풀필먼트 매뉴얼 : 발주등록 바로가기 ▶
지원 method
발주 기본 Object 구조
데이터필드 | 자료형 | 설명 |
---|---|---|
order_id | integer | 발주 ID |
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
order_code | string(20) | 오더코드 |
company_order_code | string(100) | 주문번호
필수 |
shipping_method_id | integer | 배송방식 1.택배, 2.직송, 3.새벽배송, 4.당일배송 |
order_status | integer | 발주 진행상태 1.출고요청전, 3.출고요청, 5.송장등록완료, 7.출고완료, 9.출고취소 |
order_date | DATETIME | 발주등록일시 YYYY-MM-DD HH24:MI:SS 형식 |
request_shipping_dt | string(8) | 출고희망일 필수(과거 날짜 입력 불가), YYYYMMDD 형식 |
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 | 발주타입 ID |
memo1 | string(500) | 관리메모1 |
memo2 | string(500) | 관리메모2 |
memo3 | string(500) | 관리메모3 |
memo4 | string(500) | 관리메모4 |
memo5 | string(500) | 관리메모5 |
order_item_list | childDataObject | order_item_object 구성 ▶ 필수 판매상품 리스트 |
order_item_object 구조
데이터필드 | 자료형 | 설명 |
---|---|---|
sales_product_id | integer | 판매상품 ID 필수 |
quantity | integer | 주문수량 필수 |
item_cd1 | string(50) | 상품별메모1 |
item_cd2 | string(50) | 상품별메모2 |
item_cd3 | string(50) | 상품별메모3 |
발주 등록(단일)
Request URI | /v2/request/order |
---|---|
Method | POST |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
company_order_code | string(100) | 주문번호
필수 |
shipping_method_id | integer | 배송방식 1.택배, 2.직송, 3.새벽배송, 4.당일배송 |
request_shipping_dt | string(8) | 출고희망일 필수(과거 날짜 입력 불가), YYYYMMDD 형식 |
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 | 발주타입 ID |
memo1 | string(500) | 관리메모1 |
memo2 | string(500) | 관리메모2 |
memo3 | string(500) | 관리메모3 |
memo4 | string(500) | 관리메모4 |
memo5 | string(500) | 관리메모5 |
order_item_list | childDataObject | order_item_object 구성 ▶ 필수 |
Response Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
code | string(4) | 응답코드 | |
message | string(100) | 응답메시지 | |
response | order_id | integer | 발주 ID |
company_order_code | string(100) | 주문번호 | |
order_code | string(20) | 오더코드 |
Request Sample
{
"member_id": 70,
"company_order_code": "20211122-02",
"shipping_method_id": 1,
"request_shipping_dt": "20211127",
"receiver_name": "홍길동",
"buyer_name": "구매자명",
"tel1": " 02-123-41234",
"tel2": " 02-456-789",
"zipcode": "087-789",
"shipping_address1": "서울시 강서구 마곡동",
"shipping_address2": "마곡747타워 1209호",
"shipping_message": "배송메시지",
"channel_id": "37",
"memo1": "memo1",
"memo2": "memo2",
"memo3": "",
"memo4": "",
"memo5": "",
"order_item_list": [
{
"sales_product_id": "51715",
"quantity": "1",
"item_cd1": "111",
"item_cd2": "222",
"item_cd3": "3333"
},
{
"sales_product_id": "51722",
"quantity": "2",
"item_cd1": "111",
"item_cd2": "222",
"item_cd3": "3333"
}
]
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"order_code": "O20211125-00001",
"company_order_code" : "IFS-0124",
"order_id": 182357
}
}
발주 등록(벌크)
Request URI | /v2/request/orders |
---|---|
Method | POST |
권한 | 고객사, 물류사 |
비고 | 최대 100개 까지 |
Request Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
|
request_data_list | company_order_code | string(100) | 주문번호
필수 |
shipping_method_id | integer | 배송방식 1.택배, 2.직송, 3.새벽배송, 4.당일배송 |
|
request_shipping_dt | string(8) | 출고희망일 필수 (과거 날짜 입력 불가), YYYYMMDD 형식 |
|
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 | 발주타입 ID | |
memo1 | string(500) | 관리메모1 | |
memo2 | string(500) | 관리메모2 | |
memo3 | string(500) | 관리메모3 | |
memo4 | string(500) | 관리메모4 | |
memo5 | string(500) | 관리메모5 | |
order_item_list | childDataObject | order_item_object 구성 ▶ 필수 |
Response Param
데이터필드 | 자료형 | 설명 | ||
---|---|---|---|---|
code | string(4) | 응답코드 | ||
message | string(100) | 응답메시지 | ||
response | processed_data_list 처리 완료 데이터 리스트 |
order_id | integer | 발주 ID |
company_order_code | string(100) | 주문번호 | ||
order_code | string(20) | 오더코드 | ||
processed_count | integer | 처리 갯수 |
Request Sample
{
"member_id": "70",
"request_data_list": [
{
"company_order_code": "20211124-01",
"shipping_method_id": 1,
"request_shipping_dt": "20211130",
"receiver_name": "정보배",
"buyer_name": "구매자명",
"tel1": " 02-123-41234",
"tel2": " 02-456-789",
"zipcode": "087-789",
"shipping_address1": "서울시 강서구 마곡동",
"shipping_address2": "마곡747타워 1209호",
"shipping_message": "배송메시지",
"channel_id": "36",
"memo1": "memo1",
"memo2": "memo2",
"memo3": "",
"memo4": "",
"memo5": "",
"order_item_list": [
{
"sales_product_id": "51663",
"quantity": "1",
"item_cd1": "111",
"item_cd2": "222",
"item_cd3": "3333"
},
{
"sales_product_id": "53740",
"quantity": "2",
"item_cd1": "111",
"item_cd2": "222",
"item_cd3": "3333"
}
]
},
{
"company_order_code": "20211124-03",
"shipping_method_id": 1,
"request_shipping_dt": "20211130",
"receiver_name": "정보배",
"buyer_name": "구매자명",
"tel1": " 02-123-41234",
"tel2": " 02-456-789",
"zipcode": "087-789",
"shipping_address1": "서울시 강서구 마곡동",
"shipping_address2": "마곡747타워 1209호",
"shipping_message": "배송메시지",
"channel_id": 57,
"memo1": "memo1",
"memo2": "memo2",
"memo3": "",
"memo4": "",
"memo5": "",
"order_item_list": [
{
"sales_product_id": "53783",
"quantity": "1",
"item_cd1": "111",
"item_cd2": "222",
"item_cd3": "3333"
},
{
"sales_product_id": "51665",
"quantity": "2",
"item_cd1": "111",
"item_cd2": "222",
"item_cd3": "3333"
}
]
}
]
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"processed_data_list": [
{
"order_code": "O20211124-00001",
"company_order_code" : "IFS-0124",
"order_id": 182381
},
{
"order_code": "O20211124-00002",
"company_order_code" : "IFS-0125",
"order_id": 182382
},
{
"order_code": "O20211124-00003",
"company_order_code" : "IFS-0126",
"order_id": 182383
}
],
"processed_count": 3
}
}
발주 수정
Request URI | /v2/request/order/{발주ID} |
---|---|
Method | PUT |
권한 | 고객사, 물류사 |
비고 | 발주 진행상태(order_status)가 1인 경우에만 수정 가능 코드정보 order_status_code 참고 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
company_order_code | string(100) | 주문번호
필수 |
shipping_method_id | integer | 배송방식 1.택배, 2.직송, 3.새벽배송, 4.당일배송 |
request_shipping_dt | string(8) | 출고희망일 필수 (과거 날짜 입력 불가), YYYYMMDD 형식 |
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 | 발주타입 ID |
memo1 | string(500) | 관리메모1 |
memo2 | string(500) | 관리메모2 |
memo3 | string(500) | 관리메모3 |
memo4 | string(500) | 관리메모4 |
memo5 | string(500) | 관리메모5 |
order_item_list | childDataObject | order_item_object 구성 ▶ 필수 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
Request Sample
{
"company_order_code": "20211124-v3",
"shipping_method_id": 2,
"request_shipping_dt": "20211124",
"channel_id": 37,
"receiver_name": "정보배2",
"buyer_name": "구매자명2",
"tel1": " 02-123-4120",
"tel2": " 02-456-7890",
"zipcode": "087-780",
"shipping_address1": "서울시 강서구 마곡동2",
"shipping_address2": "마곡747타워 1209호2",
"shipping_message": "배송메시지@@2",
"memo1": "memo1@2",
"memo2": "memo2@2",
"memo3": "@@2",
"memo4": "2",
"memo5": "2",
"order_item_list": [
{
"sales_product_id": "51715",
"quantity": "5",
"item_cd1": "11@222",
"item_cd2": "2@222",
"item_cd3": "33@222"
},
{
"sales_product_id": "51722",
"quantity": "5",
"item_cd1": "11@222",
"item_cd2": "22@222",
"item_cd3": "33@222"
}
]
}
Response Sample
{
"code": "9999",
"message": "ok"
}
발주 조회(단일)
Request URI | /v2/request/order/{발주ID} |
---|---|
Method | GET |
권한 | 고객사, 물류사 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
response | dataObject | 발주 기본 Object 구성 ▶ |
Request Sample
/v2/request/order/181764
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"member_id": 2,
"tel1": "01011112222",
"tel2": "01033334444",
"shipping_method_id": 1,
"company_order_code": "20220516-00001",
"buyer_name": "홍길동",
"request_shipping_dt": "20220614",
"order_code": "O20220614-00003",
"zipcode": "07807",
"order_status": 5,
"order_date": "2022-06-14 07:58:59",
"memo5": "",
"memo4": "",
"shipping_address2": "1207호",
"memo3": "",
"shipping_address1": "서울 강서구 공항대로 168 (마곡동, 747)",
"memo2": "",
"memo1": "",
"order_item_list": [
{
"sales_product_id": 2,
"quantity": 1,
"item_cd1": "",
"item_cd2": "",
"item_cd3": ""
},
{
"sales_product_id": 3,
"quantity": 1,
"item_cd1": "",
"item_cd2": "",
"item_cd3": ""
}
],
"receiver_name": "홍길동",
"order_id": 771,
"channel_id": 1,
"shipping_message": ""
}
}
발주 조회(벌크)
Request URI | /v2/request/orders |
---|---|
Method | GET |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
order_code | string(20) | 오더코드 |
company_order_codes | string(100) | 주문번호 최대 100개까지 |
shipping_method_id | integer | 배송방식 1.택배, 2.직송, 3.새벽배송, 4. 당일배송 |
order_status | integer | 발주 진행상태 코드정보 order_status_code 참고 |
order_dt | string(8) | 발주 등록일 YYYYMMDD 형식 |
request_shipping_dt | string(8) | 출고 희망일 YYYYMMDD 형식 |
channel_id | integer | 발주타입 발주타입 참고 |
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/request/orders?member_id=2&request_shipping_dt=20220614&order_code=O20220613-00001&shipping_method_id=1&order_status=5&channel_id=0&order_dt=20220613
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"data_list": [
{
"order_id": 768,
"member_id": 2,
"order_code": "O20220613-00001",
"company_order_code": "",
"shipping_method_id": 1,
"order_status": 5,
"order_date": "2022-06-13 13:46:02",
"request_shipping_dt": "20220614",
"channel_id": 0,
"buyer_name": "홍길동",
"receiver_name": "홍길동",
"tel1": "01011112222",
"tel2": "",
"zipcode": "",
"shipping_address1": "서울시 강서구 공항대로 168",
"shipping_address2": "1207호",
"shipping_message": "",
"memo1": "",
"memo2": "",
"memo3": "",
"memo4": "",
"memo5": "",
"order_item_list": [
{
"sales_product_id": 1,
"quantity": 1,
"item_cd1": "",
"item_cd2": "",
"item_cd3": ""
}
]
}
],
"total_count": 1,
"total_page": 1,
"current_page": 1
}
}