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

개발가이드(ver2.0)

상품연결 개요

사방넷 풀필먼트는 상품 시스템을 출고상품과 판매상품으로 구분하여 관리합니다.
판매상품을 별도로 등록한 경우엔, 출고상품과 자동으로 연결되지 않아 별도의 연결정보가 필요합니다.
판매상품에 연결되는 출고상품을 등록/수정하거나 조회할 수 있습니다.

사방넷 풀필먼트 매뉴얼 : 판매-출고상품 연결 바로가기 ▶

지원 method

상품연결 기본 Object 구조

데이터필드 자료형 설명
sales_product_id integer 판매상품 ID

필수

mapping_list childDataObject mapping_product_object 구성 ▶

필수, 출고상품 연결정보

mapping_product_object 구조

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

필수

quantity integer 연결 수량

필수

상품연결 등록(단일)

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

Request Param

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

물류사 권한인 경우 필수

sales_product_id integer 판매상품 ID

필수

mapping_list childDataObject mapping_product_object 구성 ▶

필수, 출고상품 연결정보

Response Param

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

Request Sample

{
    "member_id": "70",
    "sales_product_id": 54095,
    "mapping_list": [
        {
            "shipping_product_id": 43774
        },
        {
            "shipping_product_id": 41667,
            "quantity": 2
        }
    ]
}

Response Sample

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

상품연결 등록(벌크)

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

Request Param

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

물류사 권한인 경우 필수

request_data_list dataList 상품연결 기본 Object 구성 ▶

Response Param

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

Request Sample

{
  "member_id": "70",
  "request_data_list": [
    {
      "sales_product_id": 53805,
      "mapping_list": [
        {
          "shipping_product_id": 43774,
          "quantity": 1
        },
        {
          "shipping_product_id": 41667,
          "quantity": 1
        }
      ]
    },
    {
      "sales_product_id": 53804,
      "mapping_list": [
        {
          "shipping_product_id": 43774,
          "quantity": 3
        },
        {
          "shipping_product_id": 41667,
          "quantity": 2
        }
      ]
    }
  ]
}

Response Sample

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

상품연결 수정

Request URI /v2/product/product_mapping/{판매상품ID}
Method PUT
권한 고객사, 물류사

Request Param

데이터필드 자료형 설명
mapping_list childDataObject mapping_product_object 구성 ▶

필수, 출고상품 연결정보

Response Param

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

Request Sample

{
   "mapping_list":[
      {
         "shipping_product_id":43774,
         "quantity":1
      },
      {
         "shipping_product_id":41667,
         "quantity":2
      }
   ]
}

Response Sample

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

상품연결 조회(벌크)

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

Request Param

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

물류사 권한인 경우 필수

sales_product_ids list 판매상품ID list
page integer 페이지 번호

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response total_count integer 전체 갯수
total_page integer 전체 페이지 수
current_page integer 현재 페이지 번호
data_list

(처리 데이터 리스트)

sales_product_id integer 판매상품 ID
mapping_list

(세부 연결정보 리스트)

shipping_product_id integer 출고상품 ID
quantity integer 연결수량

Request Sample

/v2/product/product_mappings?member_id=70&page=1&sales_product_ids%5B0%5D=53738&sales_product_ids%5B1%5D=51666&sales_product_ids%5B2%5D=51668&sales_product_ids%5B3%5D=51670

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "data_list": [
      {
        "sales_product_id": 51663,
        "mapping_list": [
          {
            "quantity": "1",
            "shipping_product_id": "41668"
          }
        ]
      },
      {
        "sales_product_id": 51670,
        "mapping_list": [
          {
            "quantity": "1",
            "shipping_product_id": "41675"
          },
          {
            "quantity": "1",
            "shipping_product_id": "41676"
          }
        ]
      }
    ],
    "total_count": 2,
    "total_page": 1,
    "current_page": 1
  }
}
Top