판매상품 개요
사방넷 풀필먼트는 상품 시스템을 출고상품과 판매상품으로 구분하여 관리합니다.
판매상품은 판매, 세일즈, 마케팅 관점에서의 상품으로 판매자가 구성한 판매 단위입니다.
판매상품 등록
출고상품과 판매상품을 따로 관리하는 경우엔, 판매상품 API를 이용합니다.
출고상품과 연결이 필요한 경우엔 상품연결 API를 이용합니다.
판매상품수 카운트
API로 판매상품을 등록/삭제하는 경우, 외부 연동에 의해 일시적 오류를 방지하기 위해 판매상품수가 즉시 카운트되지 않습니다.
해당 상품수는 다음 달 유료 사용기간 첫째 날에 카운트되어 정상적으로 반영되오니 참고 바랍니다.
사방넷 풀필먼트 매뉴얼 : 판매상품 등록 바로가기 ▶
판매상품은 판매, 세일즈, 마케팅 관점에서의 상품으로 판매자가 구성한 판매 단위입니다.
판매상품 등록
출고상품과 판매상품을 따로 관리하는 경우엔, 판매상품 API를 이용합니다.
출고상품과 연결이 필요한 경우엔 상품연결 API를 이용합니다.
판매상품수 카운트
API로 판매상품을 등록/삭제하는 경우, 외부 연동에 의해 일시적 오류를 방지하기 위해 판매상품수가 즉시 카운트되지 않습니다.
해당 상품수는 다음 달 유료 사용기간 첫째 날에 카운트되어 정상적으로 반영되오니 참고 바랍니다.
사방넷 풀필먼트 매뉴얼 : 판매상품 등록 바로가기 ▶
지원 method
판매상품 기본 Object 구조
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
sales_product_id | integer | 판매상품 ID 판매상품 등록에는 사용하지 않음 |
sales_product_code | string(100) | 고유코드 필수, unique 체크 |
category_id | integer | 판매상품 구분 ID |
product_name | string(100) | 판매상품명 필수 |
manage_code1 | string(30) | 관리키워드1 |
manage_code2 | string(30) | 관리키워드2 |
manage_code3 | string(30) | 관리키워드3 |
product_desc | string(255) | 상품설명 |
status | integer(1) | 활성화 여부 필수, 1.활성화, 0.비활성화 |
use_display_period | integer(1) | 유효기간 사용 여부 1.사용, 0.사용 안함 |
start_dt | string(8) | 유효기간 시작일 YYYYMMDD 형식 |
end_dt | string(8) | 유효기간 종료일 YYYYMMDD 형식 |
판매상품 등록(단일)
Request URI | /v2/product/sales_product |
---|---|
Method | POST |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID
물류사 권한인 경우 필수 |
sales_product_id | integer | 판매상품 ID |
sales_product_code | string(100) | 고유코드 필수, unique 체크 |
category_id | integer | 판매상품 구분 ID |
product_name | string(100) | 판매상품명 필수 |
manage_code1 | string(30) | 관리키워드1 |
manage_code2 | string(30) | 관리키워드2 |
manage_code3 | string(30) | 관리키워드3 |
product_desc | string(255) | 상품설명 |
status | integer(1) | 활성화 여부 필수, 1.활성화, 0.비활성화 |
use_display_period | integer(1) | 유효기간 사용 여부 1.사용, 0.사용 안함 |
start_dt | string(8) | 유효기간 시작일 YYYYMMDD 형식 |
end_dt | string(8) | 유효기간 종료일 YYYYMMDD 형식 |
Response Param
데이터필드 | 자료형 | 설명 | |
---|---|---|---|
code | string(4) | 응답코드 | |
message | string(100) | 응답메시지 | |
response | sales_product_id | integer | 판매상품 ID |
sales_product_code | string(100) | 고유코드 |
Request Sample
{
"sales_product_code":"Sales_05",
"category_id":54,
"product_name":"판매상품_05",
"manage_code1":"관리코드1",
"manage_code2":"",
"manage_code3":"",
"product_desc":"판매상품 설명은 11.",
"status":"0",
"use_display_period":1,
"start_dt":"20201201",
"end_dt":"20201231"
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"sales_product_id": 53764,
"sales_product_code": "SPC1005"
}
}
판매상품 등록(벌크)
Request URI | /v2/product/sales_products |
---|---|
Method | POST |
권한 | 고객사, 물류사 |
비고 | 1회 request 당 최대 100개 등록 가능 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
request_data_list | dataList | 판매상품 기본 Object 구성 ▶ |
Response Param
데이터필드 | 자료형 | 설명 | ||
---|---|---|---|---|
code | string(4) | 응답코드 | ||
message | string(100) | 응답메시지 | ||
response | processed_data_list (처리 완료 데이터 리스트) |
sales_product_id | integer | 판매상품 ID |
sales_product_code | string(100) | 고유코드 | ||
processed_count | integer | 처리 갯수 |
Request Sample
{
"member_id":70,
"request_data_list":[
{
"sales_product_code":"Sales_06",
"category_id":54,
"product_name":"판매상품_06",
"manage_code1":"관리코드1",
"manage_code2":"",
"manage_code3":"",
"product_desc":"판매상품 설명은 11.",
"status":"0",
"use_display_period":1,
"start_dt":"20201201",
"end_dt":"20251231"
},
{
"sales_product_code":"Sales_07",
"category_id":61,
"product_name":"판매상품_07",
"manage_code1":"",
"manage_code2":"",
"manage_code3":"",
"product_desc":"판매상품 설명은 01",
"status":"0",
"use_display_period":"1",
"start_dt":"20210930",
"end_dt":"21001120"
}
]
}
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"processed_count": 2,
"processed_data_list": [
{
"sales_product_code": "SPC2001",
"sales_product_id": 53765
},
{
"sales_product_code": "SPO3021",
"sales_product_id": 53766
}
]
}
}
판매상품 수정
Request URI | /v2/product/sales_product/{판매상품ID} |
---|---|
Method | PUT |
권한 | 고객사, 물류사 |
비고 | 수정시는 모든 필드가 아닌 수정 대상 데이터필드만 입력 모든 필드가 아닌 수정 대상 데이터필드만 입력 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
sales_product_code | string(100) | 고유코드 필수, unique 체크 |
category_id | integer | 판매상품 구분 ID |
product_name | string(100) | 판매상품명 필수 |
manage_code1 | string(30) | 관리키워드1 |
manage_code2 | string(30) | 관리키워드2 |
manage_code3 | string(30) | 관리키워드3 |
product_desc | string(255) | 상품설명 |
status | integer(1) | 활성화 여부 필수, 1.활성화, 0.비활성화 |
use_display_period | integer(1) | 유효기간 사용 여부 1.사용, 0.사용 안함 |
start_dt | string(8) | 유효기간 시작일 YYYYMMDD 형식 |
end_dt | string(8) | 유효기간 종료일 YYYYMMDD 형식 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
Request Sample
{
"sales_product_code":"Sales_05",
"category_id":54,
"product_name":"판매상품_05",
"manage_code1":"관리코드1",
"manage_code2":"",
"manage_code3":"",
"product_desc":"판매설명은 Sales_05",
"status":1,
"use_display_period":1,
"start_dt":"20201201",
"end_dt":"20291231"
}
Response Sample
{
"code": "9999",
"message": "ok"
}
판매상품 조회(단일)
Request URI | /v2/product/sales_product/{판매상품ID} |
---|---|
Method | GET |
권한 | 고객사, 물류사 |
Response Param
데이터필드 | 자료형 | 설명 |
---|---|---|
code | string(4) | 응답코드 |
message | string(100) | 응답메시지 |
response | dataObject | 판매상품 기본 Object 구성 ▶ |
Request Sample
/v2/product/shipping_products/53764
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"member_id": 70,
"sales_product_code": "001",
"end_dt": "",
"sales_product_id": 53764,
"product_name": "곰표아이스크림",
"use_display_period": 0,
"product_desc": "",
"start_dt": "",
"manage_code2": "",
"manage_code1": "",
"category_id": 0,
"manage_code3": "",
"status": 1
}
}
판매상품 조회(벌크)
Request URI | /v2/product/sales_products |
---|---|
Method | GET |
권한 | 고객사, 물류사 |
Request Param
데이터필드 | 자료형 | 설명 |
---|---|---|
member_id | integer | 고객사 ID 물류사 권한인 경우 필수 |
sales_product_code | string(100) | 고유코드 |
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/sales_products?member_id=&status=1&category_id=54&sales_product_code=&page=1
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"data_list": [
{
"member_id": 70,
"sales_product_code": "SHIRT00002",
"end_dt": "",
"sales_product_id": 51883,
"product_name": "옥셔츠2",
"use_display_period": 0,
"product_desc": "",
"start_dt": "",
"manage_code2": "2",
"manage_code1": "1",
"category_id": 54,
"manage_code3": "3",
"status": 1
},
{
"member_id": 70,
"sales_product_code": "SHIRT00003",
"end_dt": "",
"sales_product_id": 51884,
"product_name": "옥스포드셔츠3",
"use_display_period": 0,
"product_desc": "",
"start_dt": "",
"manage_code2": "2",
"manage_code1": "1",
"category_id": 54,
"manage_code3": "3",
"status": 1
}
],
"total_count": 2,
"total_page": 1,
"current_page": 1
}
}