상품연결 개요
사방넷 풀필먼트는 상품 시스템을 출고상품과 판매상품으로 구분하여 관리합니다.
판매상품을 별도로 등록한 경우엔, 출고상품과 자동으로 연결되지 않아 별도의 연결정보가 필요합니다.
판매상품에 연결되는 출고상품을 등록/수정하거나 조회할 수 있습니다.
사방넷 풀필먼트 매뉴얼 : 판매-출고상품 연결 바로가기 ▶
판매상품을 별도로 등록한 경우엔, 출고상품과 자동으로 연결되지 않아 별도의 연결정보가 필요합니다.
판매상품에 연결되는 출고상품을 등록/수정하거나 조회할 수 있습니다.
사방넷 풀필먼트 매뉴얼 : 판매-출고상품 연결 바로가기 ▶
지원 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_mapping/{판매상품ID} |
|---|---|
| Method | GET |
| 권한 | 고객사, 물류사 |
Response Param
| 데이터필드 | 자료형 | 설명 | ||
|---|---|---|---|---|
| code | string(4) | 응답코드 | ||
| message | string(100) | 응답메시지 | ||
| response | sales_product_id | integer | 판매상품 ID | |
| mapping_list (세부 연결정보 리스트) |
shipping_product_id | integer | 출고상품 ID | |
| quantity | integer | 연결수량 | ||
Response Sample
{
"code": "9999",
"message": "ok",
"response": {
"sales_product_id": 51670,
"mapping_list": [
{
"quantity": "1",
"shipping_product_id": "41675"
},
{
"quantity": "1",
"shipping_product_id": "41676"
}
]
}
}상품연결 조회(벌크)
| 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=51670Response 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
}
}