로그인이 필요합니다.
클라우드 서비스 보급·확산 사업 공급기업 선정! 이용료 최대 80% 지원

개발가이드(ver2.0)

판매상품 개요

사방넷 풀필먼트는 상품 시스템을 출고상품과 판매상품으로 구분하여 관리합니다.
판매상품은 판매, 세일즈, 마케팅 관점에서의 상품으로 판매자가 구성한 판매 단위입니다.

판매상품 등록
출고상품과 판매상품을 따로 관리하는 경우엔, 판매상품 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
  }
}
Top