상품가공 계획 개요

완성된 가공품을 만들기 위해서는 먼저 상품가공 계획을 등록해야 합니다.
등록된 상품가공 계획은 사방넷 풀필먼트 > 상품 > 상품가공에서 확인할 수 있습니다.
물류사는 등록된 가공계획을 확인한 뒤, 가공지시하여 완성된 가공품을 만듭니다.
가공지시 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
response	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 요청 데이터 리스트, 최대 100개	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
	processed_data_list (처리 완료 데이터 리스트)	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
      }
    ]
  }
}

개발가이드(ver2.0)

상품가공 계획 개요

지원 method

상품가공 계획 기본 Object 구조

상품가공 계획 등록(단일)

Request Param

Response Param

Request Sample

Response Sample

상품가공 계획 등록(벌크)

Request Param

Response Param

Request Sample

Response Sample

상품가공 계획 삭제(단일)

Response Param

Request Sample

Response Sample

상품가공 계획 조회(단일)

Response Param

Request Sample

Response Sample

상품가공 계획 조회(벌크)

Request Param

Response Param

Request Sample

Response Sample