로그인이 필요합니다.

개발가이드(ver2.0)

출고상품 개요

노스노스는 상품 시스템을 출고상품과 판매상품으로 구분하여 관리합니다.
출고상품은 입출고, 재고, 유통기한 등 관리 관점에서의 상품이며, 물류센터에서 출고의 기본이되는 최소 단위입니다.

판매-출고상품 연결
WMS에서 출고상품을 등록하면, 자동으로 판매상품이 등록되고 출고상품과 판매상품이 1:1로 연결됩니다.
출고상품 등록 API에서는 데이터필드 add_sales_product 값을 입력해, 판매상품 및 연결정보 동시등록 여부를 선택할 수 있습니다.
만약, 출고상품과 판매상품을 따로 관리하는 경우라면 0으로 입력하고, 일반적으로 같이 관리하는 경우라면 1로 입력해 판매상품을 동시등록합니다.

출고상품코드, 대표로케이션 옵션
출고상품코드 자체생성, 대표로케이션을 사용하는 경우라면 상품코드, 대표로케이션, 적정수량을 직접 입력할 수 있습니다.

출고상품수 카운트
API로 출고상품을 등록/삭제하는 경우, 외부 연동에 의해 일시적 오류를 방지하기 위해 출고상품수가 즉시 카운트되지 않습니다.
해당 상품수는 다음 달 유료 사용기간 첫째 날에 카운트되어 정상적으로 반영되오니 참고 바랍니다.

노스노스 매뉴얼 : 상품의 구조 바로가기 ▶

지원 method

출고상품 기본 Object 구조

데이터필드 자료형 설명
shipping_product_id integer 출고상품ID

출고상품 등록에는 사용하지 않음

product_code string(20) 상품코드

기본값: 자동생성
출고상품코드 자체생성 옵셥을 사용하는 경우엔 필수

supply_company_id integer 공급사 ID
supplier_id integer 매입처 ID
category_id integer 출고상품 구분 ID
product_name string(100) 상품명

필수

upc string(50) 대표바코드
add_barcode_list childDataObject add_barcode_object 구성 ▶

추가바코드 리스트

manage_code1 string(30) 관리키워드1
manage_code2 string(30) 관리키워드2
manage_code3 string(30) 관리키워드3
product_desc string(250) 상품설명
single_width integer 낱개-가로(mm)
single_length integer 낱개-세로(mm)
single_height integer 낱개-높이(mm)
single_weight integer 낱개-무게(g)
box_width integer 카톤박스-가로(mm)
box_length integer 카톤박스-세로(mm)
box_height integer 카톤박스-높이(mm)
box_weight integer 카톤박스-무게(g)
single_eta integer 카톤박스-낱개입수
palet_count integer 팔레트 입수
use_expire_date integer 유통기한 사용여부

1.사용, 0.사용안함 (기본값 : 사용안함)

use_make_date integer 제조일자 사용여부

1.사용, 0.사용안함 (기본값 : 사용안함)

expire_date_by_make_date integer 제조일로부터 일수
warning_expire_date integer 임박재고 전환 기준일
restricted_expire_date integer 출고불가 기준일
edit_code string(20) 출고편집코드
max_quantity_per_box integer 최대합포장 수량
location_id integer 대표로케이션

- 출고상품코드 자체생성 옵션을 사용하는 경우에만 입력 가능
- 로케이션 타입이 2.출고가능인 경우에만 가능
- 로케이션 조회 참고

location_quantity integer 적정수량

출고상품코드 자체생성 옵션을 사용하는 경우에만 입력 가능

status integer 활성화 여부

1.활성화, 0.비활성화 (기본값 : 활성화)

add_sales_product integer 판매상품 및 연결정보 동시 등록 여부

1.동시 등록, 0.출고상품만 등록 처리 --> 출고상품 등록에서만 사용

add_barcode_object 구조

데이터필드 자료형 설명
barcode string(100) 바코드

필수

quantity integer 매칭 수량

필수

출고상품 등록(단일)

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

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

product_code string(20) 상품코드

기본값: 자동생성
출고상품코드 자체생성 옵션을 사용하는 경우엔 필수

supply_company_id integer 공급사 ID

공급사 참고

supplier_id integer 매입처 ID

매입처 참고

category_id integer 출고상품 구분 ID

출고상품 구분 참고

product_name string(100) 상품명

필수

upc string(50) 대표바코드
add_barcode_list childDataObject add_barcode_object 구성 ▶

추가바코드 리스트

manage_code1 string(30) 관리키워드1
manage_code2 string(30) 관리키워드2
manage_code3 string(30) 관리키워드3
product_desc string(250) 상품설명
single_width integer 낱개-가로(mm)
single_length integer 낱개-세로(mm)
single_height integer 낱개-높이(mm)
single_weight integer 낱개-무게(g)
box_width integer 카톤박스-가로(mm)
box_length integer 카톤박스-세로(mm)
box_height integer 카톤박스-높이(mm)
box_weight integer 카톤박스-무게(g)
single_eta integer 카톤박스-낱개입수
palet_count integer 팔레트 입수
use_expire_date integer 유통기한 사용여부

1.사용, 0.사용안함 (기본값 : 사용안함)

use_make_date integer 제조일자 사용여부

1.사용, 0.사용안함 (기본값 : 사용안함)

expire_date_by_make_date integer 제조일로부터 일수
warning_expire_date integer 임박재고 전환 기준일
restricted_expire_date integer 출고불가 기준일
edit_code string(20) 출고편집코드
max_quantity_per_box integer 최대합포장 수량
location_id integer 대표로케이션

- 출고상품코드 자체생성 옵션을 사용하는 경우에만 입력 가능
- 로케이션 타입이 2.출고가능인 경우에만 가능
- 로케이션 조회 참고

location_quantity integer 적정수량

출고상품코드 자체생성 옵션을 사용하는 경우에만 입력 가능

status integer 활성화 여부

1.활성화, 0.비활성화 (기본값 : 활성화)

add_sales_product integer 판매상품 및 연결정보 동시 등록 여부

1.동시 등록, 0.출고상품만 등록 처리 --> 출고상품 등록에만 사용

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response shipping_product_id integer 출고상품ID
product_code string(4) 상품코드
sales_product_id integer 판매상품 ID
sales_product_code string(100) 판매상품코드

Request Sample

{
   "member_id": 70,
   "product_code":"009",
   "supply_company_id":23,
   "supplier_id":63,
   "category_id":71,
   "product_name":"새우볶음밥",
   "upc":"687848455111",
   "add_barcode_list":[
      {
         "barcode":"878444444",
         "quantity":1
      }
   ],
   "manage_code1":"냉장",
   "manage_code2":"볶음밥",
   "manage_code3":"베스트상품",
   "product_desc":"새우로 만든 볶음밥 200g",
   "single_height":20,
   "single_length":20,
   "single_weight":20,
   "single_width":20,
   "box_height":20,
   "box_length":20,
   "box_weight":20,
   "box_width":20,
   "single_eta":20,
   "palet_count":20,
   "use_expire_date":1,
   "expire_date_by_make_date":1,
   "restricted_expire_date":300,
   "use_make_date":1,
   "warning_expire_date":10,
   "edit_code":"상온",
   "max_quantity_per_box":10,
   "location_id":28,
   "location_quantity":100,
   "status":1,
   "add_sales_product":1
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "shipping_product_id": 43826,
    "product_code": "T137",
    "sales_product_id": 54046,
    "sales_product_code": "T137_new"
  }
}

출고상품 등록(벌크)

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

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

request_data_list dataList 출고상품 기본 Object 구성 ▶

Response Param

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

(처리 완료 데이터 리스트)

shipping_product_id integer 출고상품 ID
product_code string(100) 출고상품코드
sales_product_id integer 판매상품 ID
sales_product_code string(100) 판매상품코드
processed_count integer 처리 갯수

Request Sample

{
   "member_id":70,
   "request_data_list":[
      {
         "product_code":"013",
         "supply_company_id":23,
         "supplier_id":63,
         "category_id":71,
         "product_name":"소고기볶음밥",
         "upc":"687848455111",
         "add_barcode_list":[
            {
               "barcode":"878444444",
               "quantity":1
            }
         ],
         "manage_code1":"냉장",
         "manage_code2":"",
         "manage_code3":"",
         "product_desc":"소고기로만든 볶음밥 200g",
         "single_height":20,
         "single_length":20,
         "single_weight":20,
         "single_width":20,
         "box_height":20,
         "box_length":20,
         "box_weight":20,
         "box_width":20,
         "single_eta":20,
         "palet_count":20,
         "use_expire_date":1,
         "expire_date_by_make_date":1,
         "restricted_expire_date":300,
         "use_make_date":1,
         "warning_expire_date":10,
         "edit_code":"상온",
         "max_quantity_per_box":10,
         "location_id":28,
         "location_quantity":100,
         "status":1,
         "add_sales_product":0
      },
      {
         "product_code":"014",
         "supply_company_id":23,
         "supplier_id":63,
         "category_id":71,
         "product_name":"kf94 마스크 대형",
         "upc":"687848455111",
         "add_barcode_list":[
            {
               "barcode":"878444444",
               "quantity":1
            }
         ],
         "manage_code1":"대형",
         "manage_code2":"생활용품",
         "manage_code3":"마스크",
         "product_desc":"방역/미세먼지 마스크 대형",
         "single_height":20,
         "single_length":20,
         "single_weight":20,
         "single_width":20,
         "box_height":20,
         "box_length":20,
         "box_weight":20,
         "box_width":20,
         "single_eta":20,
         "palet_count":20,
         "use_expire_date":1,
         "expire_date_by_make_date":1,
         "restricted_expire_date":300,
         "use_make_date":1,
         "warning_expire_date":10,
         "edit_code":"상온",
         "max_quantity_per_box":10,
         "location_id":28,
         "location_quantity":100,
         "status":1,
         "add_sales_product":1
      }
   ]
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "processed_count": 2,
    "processed_data_list": [
      {
        "sales_product_code": "test-5",
        "sales_product_id": 54043,
        "product_code": "test-5",
        "shipping_product_id": 43823
      },
      {
        "sales_product_code": "test-6",
        "sales_product_id": 54044,
        "product_code": "test-6",
        "shipping_product_id": 43824
      }
    ]
  }
}

출고상품 수정

Request uri /v2/product/shipping_product/{출고상품ID}
Method PUT
권한 고객사, 물류사
비고 수정시는 모든 필드가 아닌 수정 대상 데이터필드만 입력 모든 필드가 아닌 수정 대상 데이터 필드만 입력

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

product_code string(20) 상품코드

기본값: 자동생성
출고상품코드 자체생성 옵션을 사용하는 경우엔 필수

supply_company_id integer 공급사 ID

공급사 참고

supplier_id integer 매입처 ID

매입처 참고

category_id integer 출고상품 구분 ID

출고상품 구분 참고

product_name string(100) 상품명

필수

upc string(50) 대표바코드
add_barcode_list childDataObject add_barcode_object 구성 ▶

추가바코드 리스트

manage_code1 string(30) 관리키워드1
manage_code2 string(30) 관리키워드2
manage_code3 string(30) 관리키워드3
product_desc string(250) 상품설명
single_width integer 낱개-가로(mm)
single_length integer 낱개-세로(mm)
single_height integer 낱개-높이(mm)
single_weight integer 낱개-무게(g)
box_width integer 카톤박스-가로(mm)
box_length integer 카톤박스-세로(mm)
box_height integer 카톤박스-높이(mm)
box_weight integer 카톤박스-무게(g)
single_eta integer 카톤박스-낱개입수
palet_count integer 팔레트 입수
use_expire_date integer 유통기한 사용여부

1.사용, 0.사용안함 (기본값 : 사용안함)

use_make_date integer 제조일자 사용여부

1.사용, 0.사용안함 (기본값 : 사용안함)

expire_date_by_make_date integer 제조일로부터 일수
warning_expire_date integer 임박재고 전환 기준일
restricted_expire_date integer 출고불가 기준일
edit_code string(20) 출고편집코드
max_quantity_per_box integer 최대합포장 수량
location_id integer 대표로케이션

- 출고상품코드 자체생성 옵션을 사용하는 경우에만 입력 가능
- 로케이션 타입이 2.출고가능인 경우에만 가능
- 로케이션 조회 참고

location_quantity integer 적정수량

출고상품코드 자체생성 옵션을 사용하는 경우에만 입력 가능

status integer 활성화 여부

1.활성화, 0.비활성화 (기본값 : 활성화)

Response Param

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

Request Sample

{
   "product_code":"010",
   "supply_company_id":23,
   "supplier_id":63,
   "category_id":71,
   "product_name":"마우스패드",
   "upc":"687848455111",
   "add_barcode_list":[
      {
         "barcode":"878444444",
         "quantity":1
      }
   ],
   "manage_code1":"마우스",
   "manage_code2":"컴퓨터용품",
   "manage_code3":"패드",
   "product_desc":"게이밍용 마우스 패드",
   "single_height":20,
   "single_length":20,
   "single_weight":20,
   "single_width":20,
   "box_height":20,
   "box_length":20,
   "box_weight":20,
   "box_width":20,
   "single_eta":20,
   "palet_count":20,
   "use_expire_date":1,
   "expire_date_by_make_date":1,
   "restricted_expire_date":300,
   "use_make_date":1,
   "warning_expire_date":10,
   "edit_code":"상온",
   "max_quantity_per_box":10,
   "location_id":28,
   "location_quantity":100,
   "status":1
}

Response Sample

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

출고상품 조회(단일)

Request URI /v2/product/shipping_product/{출고상품ID}
Method GET
권한 고객사, 물류사

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response dataObject 출고상품 기본 Object 구성 ▶

Request Sample

/v2/product/shipping_products/43778

Response Sample

{
    "code": "9999",
    "message": "ok",
    "response": {
        "shipping_product_id": 43778,
        "member_id": 70,
        "product_code": "006",
        "supply_company_id": "24",
        "supplier_id": "63",
        "category_id": "71",
        "product_name": "소고기라면",
        "upc": "687848455111",
        "add_barcode_list": [
            {
                "quantity": "1",
                "barcode": "878444444"
            }
        ],
        "manage_code1": "소고기",
        "manage_code2": "맛있는",
        "manage_code3": "라면",
        "product_desc": "남녀노소 모두가 좋아하는 라면",
        "single_width": "20",
        "single_length": "20",
        "single_height": "20",
        "single_weight": "20",
        "box_width": "20",
        "box_length": "20",
        "box_height": "20",
        "box_weight": "20",
        "single_eta": "20",
        "palet_count": "20",
        "use_expire_date": "1",
        "use_make_date": "1",
        "expire_date_by_make_date": "1",
        "warning_expire_date": "10",
        "restricted_expire_date": "300",
        "edit_code": "상온",
        "max_quantity_per_box": "10",
        "location_id": "28",
        "location_quantity": "100",
        "status": "1",
        "add_sales_product": "1"
    }
}

출고상품 조회(벌크)

Request URI /v2/product/shipping_products
Method GET
권한 고객사, 물류사

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

product_code string(20) 출고상품코드
product_name string(100) 상품명

일부 검색어로 검색 가능(최소 2자 이상)

category_id integer 출고상품 구분 ID
status integer(1) 활성화 여부

1.활성화, 0.비활성화

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/product/shipping_products?product_code=006&product_name=소고기라면&category_id=71&status=1&page=1

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "data_list": [
      {
        "shipping_product_id": 43778,
        "member_id": 70,
        "product_code": "006",
        "supply_company_id": "24",
        "supplier_id": "63",
        "category_id": "71",
        "product_name": "소고기라면",
        "upc": "687848455111",
        "add_barcode_list": [
          {
            "quantity": "1",
            "barcode": "878444444"
          }
        ],
        "manage_code1": "소고기",
        "manage_code2": "맛있는",
        "manage_code3": "라면",
        "product_desc": "남녀노서 모두 좋아하는 라면",
        "single_width": "20",
        "single_length": "20",
        "single_height": "20",
        "single_weight": "20",
        "box_width": "20",
        "box_length": "20",
        "box_height": "20",
        "box_weight": "20",
        "single_eta": "20",
        "palet_count": "20",
        "use_expire_date": "1",
        "use_make_date": "1",
        "expire_date_by_make_date": "1",
        "warning_expire_date": "10",
        "restricted_expire_date": "300",
        "edit_code": "상온",
        "max_quantity_per_box": "10",
        "location_id": "28",
        "location_quantity": "100",
        "status": "1",
        "add_sales_product": "1"
      }
    ],
    "total_count": 1,
    "total_page": 1,
    "current_page": 1
  }
}
Top