가공품 관리 개요

가공품은 가공재료가 되는 출고상품을 이용하여, 완성된 가공품을 만드는 기능입니다.
완성된 가공품에 해당하는 출고상품은 중복으로 등록할 수 없습니다.
가공품을 만들기 위해서는 먼저 가공품을 등록해야합니다.
등록된 가공품은 상품가공 계획 API에서 가공 계획을 등록해 가공품을 완성합니다.

사방넷 풀필먼트 매뉴얼 : 가공품 관리 바로가기 ▶

지원 method

가공품 관리 등록(단일)
가공품 관리 등록(벌크)
가공품 관리 수정(단일)
가공품 관리 조회(단일)
가공품 관리 조회(벌크)

가공품 관리 기본 Object 구조

데이터필드	자료형	설명
assembly_product_uid	integer	가공품 ID
member_id	integer	고객사 ID
shipping_product_id	integer	가공품 (출고상품 ID)
product_name	string(100)	가공품명 (출고상품명)
comment	string(2000)	특이사항
item_list	childDataObject	item_list_object 구성 ▶ 가공재료 리스트

item_list_object 구조

데이터필드	자료형	설명
shipping_product_id	integer	가공재료 (출고상품 ID)
product_name	string(100)	가공재료명 (출고상품명)
quantity	integer	매칭 수량

add_product_object 구조

데이터필드	자료형	설명
shipping_product_id	integer	가공재료 (출고상품 ID) 필수
quantity	integer	매칭 수량 필수

가공품 관리 등록(단일)

Request URI	/v2/assembly/product
Method	POST
권한	고객사, 물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
product_id	integer	가공상품코드(출고상품 ID) 필수
comment	string(2000)	특이사항
item_list	childDataObject	add_product_object 구성 ▶ 가공재료 리스트, 필수

Response Param

데이터필드		자료형	설명
code		string(4)	응답코드
message		string(100)	응답메시지
response	product_id	integer	가공상품코드(출고상품 ID)
response	assembly_product_uid	integer	가공품 ID

Request Sample

{
  "member_id": "70",
  "product_id": "43897",
  "comment": " 코멘트0^^0 ",
  "item_list": [
    {
      "shipping_product_id": "43838",
      "quantity": 2
    },
    {
      "shipping_product_id": "43839",
      "quantity": 1
    }
  ]
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "product_id": "43897",
    "assembly_product_uid": "90"
  }
}

가공품 관리 등록(벌크)

Request URI	/v2/assembly/products
Method	POST
권한	고객사, 물류사
비고	1회 request당 최대 100개 등록 가능

Request Param

데이터필드		자료형	설명
member_id		integer	고객사 ID 물류사 권한인 경우 필수
request_data_list 요청 데이터 리스트, 최대 100개	product_id	integer	가공상품코드(출고상품 ID) 필수
	comment	string(2000)	특이사항
	item_list	childDataObject	add_product_object 구성 ▶ 가공재료 리스트, 필수

Response Param

데이터필드			자료형	설명
code			string(4)	응답코드
message			string(100)	응답메시지
response	processed_count		integer	처리 개수
	processed_data_list (처리 완료 데이터 리스트)	product_id	integer	등록한 출고상품 ID
	processed_data_list (처리 완료 데이터 리스트)	assembly_product_uid	integer	가공품 ID

Request Sample

{
  "member_id": "70",
  "request_data_list": [
    {
      "product_id": "43898",
      "comment": " 코멘트 - 1 ",
      "item_list": [
        {
          "shipping_product_id": "43838",
          "quantity": 1
        },
        {
          "shipping_product_id": "43839",
          "quantity": 1
        }
      ]
    },
    {
      "product_id": "43899",
      "comment": " 코멘트 - 2 ",
      "item_list": [
        {
          "shipping_product_id": "43838",
          "quantity": 1
        },
        {
          "shipping_product_id": "43839",
          "quantity": 1
        }
      ]
    }
  ]
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "processed_count": 2,
    "processed_data_list": [
      {
        "product_id": "43898",
        "assembly_product_uid": "91"
      },
      {
        "product_id": "43899",
        "assembly_product_uid": "92"
      }
    ]
  }
}

가공품 관리 수정(단일)

Request URI	/v2/assembly/product/{가공품ID}
Method	PUT
권한	고객사, 물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
comment	string(2000)	특이사항
item_list	childDataObject	add_product_object 구성 ▶ 가공재료 리스트 필수

Response Param

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

Request Sample

{
  "member_id": "70",
  "comment": " 코멘트0^^0 ",
  "item_list": [
    {
      "shipping_product_id": "43838",
      "quantity": 2
    },
    {
      "shipping_product_id": "43839",
      "quantity": 1
    }
  ]
}

Response Sample

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

가공품 관리 조회(단일)

Request URI	/v2/assembly/product/{가공품ID}
Method	GET
권한	고객사, 물류사

Response Param

데이터필드		자료형	설명
code		string(4)	응답코드
message		string(100)	응답메시지
response	assembly_product_uid	integer	가공품 ID
	member_id	integer	고객사 ID
	shipping_product_id	integer	가공품 (출고상품 ID)
	product_name	string(100)	가공품명 (출고상품명)
	comment	string(2000)	특이사항
	item_list	childDataObject	item_list_object 구성 ▶ 가공재료 리스트 필수

Request Sample

/v2/assembly/product/70

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "assembly_product_uid": "91",
    "member_id": "70",
    "shipping_product_id": "43898",
    "product_name": "완성 가공품 - 03",
    "comment": "코멘트 - 1",
    "item_list": [
      {
        "shipping_product_id": "43838",
        "product_name": "가공품재료1",
        "quantity": "1"
      },
      {
        "shipping_product_id": "43839",
        "product_name": "가공품재료2",
        "quantity": "1"
      }
    ]
  }
}

가공품 관리 조회(벌크)

Request URI	/v2/assembly/products
Method	GET
권한	고객사, 물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
assembly_product_uids	array	가공품 ID (배열)
page	integer	페이지 번호

Response Param

데이터필드			자료형	설명
code			string(4)	응답코드
message			string(100)	응답메시지
response	total_count		integer	전체 갯수
	total_page		integer	전체 페이지 수
	current_page		integer	현재 페이지 번호
	data_list (처리 데이터 리스트)	assembly_product_uid	integer	가공품 ID
		member_id	integer	고객사 ID
		shipping_product_id	integer	가공품 (출고상품 ID)
		product_name	string(100)	가공품명 (출고상품명)
		comment	string(2000)	특이사항
		item_list	childDataObject	item_list_object 구성 ▶ 가공재료 리스트

Request Sample

/v2/assembly/products?member_id=70&assembly_product_uids=91&assembly_product_uids=92&page=1

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 2,
    "total_page": 1,
    "current_page": 1,
    "data_list": [
      {
        "assembly_product_uid": "91",
        "member_id": "70",
        "shipping_product_id": "43898",
        "product_name": "완성 가공품 - 03",
        "comment": "코멘트 - 1",
        "item_list": [
          {
            "quantity": "1",
            "product_name": "가공품재료1",
            "shipping_product_id": "43838"
          },
          {
            "quantity": "1",
            "product_name": "가공품재료2",
            "shipping_product_id": "43839"
          }
        ]
      },
      {
        "assembly_product_uid": "92",
        "member_id": "70",
        "shipping_product_id": "43899",
        "product_name": "그릇 세트",
        "comment": "코멘트 - 2",
        "item_list": [
          {
            "quantity": "1",
            "product_name": "재료1",
            "shipping_product_id": "43838"
          },
          {
            "quantity": "1",
            "product_name": "재료2",
            "shipping_product_id": "43839"
          }
        ]
      }
    ]
  }
}

개발가이드(ver2.0)

가공품 관리 개요

지원 method

가공품 관리 기본 Object 구조

item_list_object 구조

add_product_object 구조

가공품 관리 등록(단일)

Request Param

Response Param

Request Sample

Response Sample

가공품 관리 등록(벌크)

Request Param

Response Param

Request Sample

Response Sample

가공품 관리 수정(단일)

Request Param

Response Param

Request Sample

Response Sample

가공품 관리 조회(단일)

Response Param

Request Sample

Response Sample

가공품 관리 조회(벌크)

Request Param

Response Param

Request Sample

Response Sample