로그인이 필요합니다.

개발가이드(ver2.0)

가공품 관리 개요

가공품은 가공재로가 되는 출고상품을 이용하여, 완성된 가공품을 만드는 기능입니다.
완성된 가공품에 해당하는 출고상품은 중복으로 등록할 수 없습니다.
가공품을 만들기 위해서는 먼저 가공품을 등록해야합니다.
등록된 가공품은 상품가공 계획 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)
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
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"
          }
        ]
      }
    ]
  }
}
Top