상품가공 계획 개요
완성된 가공품을 만들기 위해서는 먼저 상품가공 계획을 등록해야 합니다.
등록된 상품가공 계획은 사방넷 풀필먼트 > 상품 > 상품가공에서 확인할 수 있습니다.
물류사는 등록된 가공계획을 확인한 뒤, 가공지시하여 완성된 가공품을 만듭니다.
가공지시 API는 추후 업데이트를 통해 지원 할 예정입니다.
사방넷 풀필먼트 매뉴얼 : 상품가공 바로가기 ▶
등록된 상품가공 계획은 사방넷 풀필먼트 > 상품 > 상품가공에서 확인할 수 있습니다.
물류사는 등록된 가공계획을 확인한 뒤, 가공지시하여 완성된 가공품을 만듭니다.
가공지시 API는 추후 업데이트를 통해 지원 할 예정입니다.
사방넷 풀필먼트 매뉴얼 : 상품가공 바로가기 ▶
지원 method
상품가공 계획 기본 Object 구조
데이터필드 | 자료형 | 설명 |
---|---|---|
assembly_plan_uid | integer | 가공계획 ID |
shipping_product_id | integer | 가공품 (출고상품 ID) |
member_id | integer | 고객사 ID |
product_name | string(100) | 가공품명 |
plan_datetime | string(20) | 등록일 YYYYMMDD 형식 |
target_date | string(8) | 목표일 YYYYMMDD 형식 |
complete_datetime | string(20) | 완료일 YYYYMMDD 형식 |
plan_quantity | integer | 계획 수량 |
complete_quantity | integer | 완료 수량 |
working_quantity | integer | 작업중 수량 |
incomplete_quantity | integer | 미완료 수량 |
상품가공 계획 등록(단일)
Request URI | /v2/assembly/assembly_plan |
---|---|
Method | POST |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
assembly_product_uid | integer | 가공품 ID 필수 |
quantity | integer | 계획수량 필수 |
target_date | string(8) | 목표일 YYYYMMDD 형식, 기본값 : 오늘 날짜 |
Response Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
code | string(4) | 응답코드 | |
message | string(100) | 응답메시지 | |
response | assembly_product_uid | integer | 가공품 ID |
assembly_plan_uid | integer | 가공계획 ID |
Request Sample
{
"member_id": "70",
"assembly_product_uid": "100",
"quantity": 5,
"target_date": "20220525"
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"assembly_product_uid": "100",
"assembly_plan_uid": "282"
}
}
상품가공 계획 등록(벌크)
Request URI | /v2/assembly/assembly_plans |
---|---|
Method | POST |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
|
request_data_list 요청 데이터 리스트, |
assembly_product_uid | integer | 가공품 ID 필수 |
quantity | integer | 계획수량 필수 |
|
target_date | string(8) | 목표일 YYYYMMDD 형식, 기본값 : 오늘 날짜 |
Response Param
데이터필드 | 자료형 | 설명 | ||
---|---|---|---|---|
code | string(4) | 응답코드 | ||
message | string(100) | 응답메시지 | ||
response | processed_count | integer | 처리 개수 | |
processed_data_list (처리 완료 데이터 리스트) |
assembly_plan_uid | integer | 가공계획 ID | |
assembly_product_uid | integer | 가공품 ID |
Request Sample
{
"member_id" : "70",
"request_data_list" : [
{
"assembly_product_uid" : "70",
"quantity" : "5",
"target_date" : "20220527"
},
{
"assembly_product_uid" : "98",
"quantity" : "3",
"target_date" : "20220528"
}
]
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"processed_count": 2,
"processed_data_list": [
{
"assembly_product_uid": "70",
"assembly_plan_uid": "292"
},
{
"assembly_product_uid": "98",
"assembly_plan_uid": "293"
}
]
}
}
상품가공 계획 삭제(단일)
Request URI | /v2/assembly/assembly_plan/{가공계획 ID} |
---|---|
Method | DELETE |
권한 | 고객사, 물류사 |
설명 | 가공지시 내역이 있는 경우 삭제 불가 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
Request Sample
/v2/assembly/assembly_plan/90
Response Sample
{
"code": "9999", "message": "ok"
}
상품가공 계획 조회(단일)
Request URI | /v2/assembly/assembly_plan/{가공계획 ID} |
---|---|
Method | GET |
권한 | 고객사, 물류사 |
Response Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
code | string(4) | 응답코드 | |
message | string(100) | 응답메시지 | |
response | assembly_plan_uid | integer | 가공계획 ID |
shipping_product_id | integer | 가공품 (출고상품 ID) | |
member_id | integer | 고객사 ID | |
product_name | string(100) | 가공품명 | |
plan_datetime | string(20) | 등록일 YYYYMMDD 형식 |
|
target_date | string(8) | 목표일 YYYYMMDD 형식 |
|
complete_datetime | string(20) | 완료일 YYYYMMDD 형식 |
|
plan_quantity | integer | 계획 수량 | |
complete_quantity | integer | 완료 수량 | |
working_quantity | integer | 작업중 수량 | |
incomplete_quantity | integer | 미완료 수량 |
Request Sample
/v2/assembly/assembly_plan/297
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"assembly_plan_uid": "297",
"shipping_product_id": "43837",
"member_id": "70",
"product_name": "가공품완성품",
"plan_datetime": "2022-05-26 17:54:48",
"target_date": "20220527",
"complete_datetime": "",
"plan_quantity": "1",
"complete_quantity": "0",
"working_quantity": 0,
"incomplete_quantity": 1
}
}
상품가공 계획 조회(벌크)
Request URI | /v2/assembly/assembly_plans |
---|---|
Method | GET |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
shipping_product_ids | array 배열 | 가공품 (출고상품 ID) |
plan_date | string(8) | 가공 등록일 YYYYMMDD 형식 |
complete_date | 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 (처리 데이터 리스트) |
assembly_plan_uid | integer | 가공계획 ID | |
shipping_product_id | integer | 가공품 (출고상품 ID) | ||
member_id | integer | 고객사 ID | ||
product_name | string(100) | 가공품명 | ||
plan_datetime | string(20) | 등록일 YYYYMMDD 형식 |
||
target_date | string(8) | 목표일 YYYYMMDD 형식 |
||
complete_datetime | string(20) | 완료일 YYYYMMDD 형식 |
||
plan_quantity | integer | 계획 수량 | ||
complete_quantity | integer | 완료 수량 | ||
working_quantity | integer | 작업중 수량 | ||
incomplete_quantity | integer | 미완료 수량 |
Request Sample
/v2/assembly/assembly_plans?member_id=70&assembly_product_uids=91&assembly_product_uids=92&plan_date=20220518
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"total_count": 4,
"total_page": 2,
"current_page": 1,
"data_list": [
{
"shipping_product_id": "41837",
"member_id": "70",
"product_name": "혼술 셋트",
"plan_datetime": "2022-05-10 14:24:56",
"target_date": "20220511",
"complete_datetime": "",
"plan_quantity": "5",
"complete_quantity": "0",
"working_quantity": 0,
"incomplete_quantity": 5
},
{
"shipping_product_id": "43797",
"member_id": "70",
"product_name": "파우치",
"plan_datetime": "2022-05-04 10:24:05",
"target_date": "20220520",
"complete_datetime": "",
"plan_quantity": "1",
"complete_quantity": "0",
"working_quantity": 0,
"incomplete_quantity": 1
}
]
}
}