단품정보관리 API는 세부 조회 조건에 따라 옵션값, 재고수량, 안전재고수량, 단품번호 등의 정보를 포함한 단품 목록을 조회하는 기능을 제공합니다.
조회 결과 중 선택한 단품들의 판매상태, 안전재고 기준 수량, 재고수량을 일괄적으로 변경하는 기능을 제공하고 있습니다.
옵션정보관리 API는 옵션분류유형과 사용여부에 따라 옵션분류코드목록과 옵션코드목록을 조회하는 기능을 제공합니다.
옵션코드목록의 경우 이미지 등록 및 RGB값의 입력이 가능하며, FO 상품상세 페이지의 옵션 목록에 노출됩니다.
상품의 단품에 대한 상세 정보를 조회하고 관리하는 기능을 제공합니다. 또한, 옵션 정보관리 API는 옵션에 대한 정보를 조회하고 관리하는 기능을 제공합니다.
...
주요 기능
단품 정보
...
조회 및 일괄 수정
상품 등록일자, 협력사 번호
...
, 표준카테고리 등 다양한 조건으로 단품 정보를 조회하고, 조회된 결과를 기반으로 판매상태, 안전재고
...
기준 수량, 재고수량 등을 일괄적으로 수정할 수 있습니다.
옵션 정보
...
옵션코드목록에서 옵션명과 함께 노출될 이미지와 RGB값의 추가가 가능합니다.
...
추가된 값은 FO 상품상세 페이지에서 첨부한 이미지와 함께 확인할 수 있으며, RGB값의 경우 코드 입력시 해당 컬러로 자동 입력되어 노출됩니다.
...
조회 및 관리
옵션분류유형과 사용여부에 따라 옵션분류코드목록과 옵션코드목록을 조회하고, 조회된 옵션코드목록에는 이미지 및 RGB값을 등록할 수 있습니다.
등록된 값들은 FO 상품상세 페이지에서 확인할 수 있습니다.
프로세스 정의
...
구분 | 설명 | |
|---|---|---|
| 1 | 단품목록 조회 |
|
| 2 | 단품관리 목록 저장 |
|
| 3 | 안전재고 알림기준수량 일괄 변경 |
|
| 4 | 재고수량 일괄 변경 |
|
| 5 | 단품 품절 처리 |
|
...
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
안전재고 알림 기준 수량 일괄 변경 | •선택한 단품들의 안전재고 알림 기준수량을 일괄 변경합니다. •안전재고 알림 여부가 Y인 경우에만 반영되며, N인 경우 반영되지 않습니다. •안전재고알림여부가 N인 경우, 안전재고알림기준수량이 초기화됩니다. | Goods | POST | |
재고수량 일괄 변경 | •선택한 단품들의 재고수량을 일괄 변경합니다. •재고관리 여부가 Y인 경우에만 반영되며, N인 경우 반영되지 않습니다. | Goods | POST | |
단품 품절 처리 | •단품 목록을 품절 처리합니다. •배송 모듈의 결품관리에서 결품 처리를 위해 호출됩니다. | Goods | POST | |
옵션 분류 코드 목록 조회 | •옵션 분류 코드 정보 목록을 조회합니다. •정렬순서는 오름차순, 수정일시는 내림차순으로 정렬됩니다. | Goods | GET | |
옵션코드 목록 조회 | •옵션분류번호를 기준으로 옵션 코드 정보 목록을 조회합니다. •정렬순서는 오름차순, 수정일시는 내림차순으로 정렬됩니다. | Goods | GET | |
옵션 분류 코드 목록 저장 | •옵션 분류 코드 정보 목록을 저장합니다. •옵션 분류명 수정시, 단품 옵션 정보의 옵션분류명도 수정됩니다. •옵션 분류 코드 목록 저장시 입력한 옵션 분류 코드 정보의 유효성을 검증합니다. •옵션분류명은 중복이 불가능합니다. | Goods | POST | |
옵션코드 목록 저장 | •옵션코드 정보 목록을 저장합니다. •옵션 분류명 수정시, 단품 옵션 정보의 옵션분류명도 수정됩니다. •옵션코드 목록 저장시 입력한 옵션 분류 코드 정보의 유효성을 검증합니다. | Goods | POST |
용어 정의
명칭 | 설명 | 비고 |
|---|---|---|
상품 | •상거래 채널을 통해 판매의 대상이 되는 모든 재화를 의미합니다. •상품을 전시하는 기본 단위이며 상품 상세 화면을 구성하는 기본 단위가 됩니다. •상품은 가격을 관리하는 단위입니다. | |
단품 | •상품 하위의 최소 관리 단위로 상품 재고 및 판매의 최소 단위, 즉 고객이 구입하게 되는 단위입니다. •고객의 선택 옵션에 따른, 주문 상품 정보를 관리하는 단위입니다. •재고를 관리하는 단위입니다. (솔루션에서 재고는 ‘웹재고’를 의미합니다.) •옵션의 조합으로 단품 정보가 생성됩니다.
| |
옵션 | •상품을 베리에이션하는 기본 단위입니다. •‘컬러’, ‘사이즈’ 등의 항목을 옵션명이라 하며 ‘블랙’, ‘XL’등을 옵션값이라 합니다. •옵션 유형은 성별, 색상, 크기, 중량, 용량, 지역 등 대부분의 커머스에 사용하는 유형이 존재하며 사이트별 필요시 추가하여 사용할 수 있습니다. | |
일반상품 (구분) | •일반적인 배송이 이루어지는 모든 재화 상품을 의미합니다. | |
사은품 (구분) | 프로모션이나 이벤트 등을 통해 특정 상품 구매 혹은 특정한 액수 이상 구매 등과 같이 일정한 조건을 충족하는 고객에 한하여, 추가 비용 없이 지급하는 상품을 의미합니다. | |
일반상품 | •단품에 상품의 옵션을 코드화에서 관리하는 상품을 의미합니다. •재고 차감은 단품 단위로 이루어 집니다. | |
묶음상품 | •할인 여부와 상관없이 전시 활용을 위한 묶음 상품을 의미합니다. •옵션 구성 상품을 일부 선택하여 구매합니다. |