단품정보 관리

단품정보관리 API는 세부 조회 조건에 따라 옵션값, 재고수량, 안전재고수량, 단품번호 등의 정보를 포함한 단품 목록을 조회하는 기능을 제공합니다.

조회 결과 중 선택한 단품들의 판매상태, 안전재고 기준 수량, 재고수량을 일괄적으로 변경하는 기능을 제공하고 있습니다.

옵션정보관리 API는 옵션분류유형과 사용여부에 따라 옵션분류코드목록과 옵션코드목록을 조회하는 기능을 제공합니다.

옵션코드목록의 경우 이미지 등록 및 RGB값의 입력이 가능하며, FO 상품상세 페이지의 옵션 목록에 노출됩니다.

주요 기능

단품 정보 관리에서는 조회 조건과 일치하는 단품을 조회하는 기능을 제공합니다.
조회 결과 중 선택한 단품들의 판매상태, 안전재고 기준 수량, 재고수량을 일괄적으로 변경하는 기능을 제공하고 있습니다.
상품 등록일자, 협력사 번호/협력사명, 표준카테고리번호/표준카테고리명, 담당MD, 상품 판매상태, 단품 판매상태, 안전재고 알림 여부, 상품명, 상품 번호 등 다양한 조건으로 단품정보의 조회가 가능하도록 개발되었습니다.
옵션 정보 관리에서는 옵션분류유형과 사용여부를 조건으로 하여 조회가 가능하며, 조회된 옵션코드목록을 선택하면 옵션코드목록이 자동으로 노출됩니다.
옵션코드목록에서 옵션명과 함께 노출될 이미지와 RGB값의 추가가 가능합니다.
추가된 값은 FO 상품상세 페이지에서 첨부한 이미지와 함께 확인할 수 있으며, RGB값의 경우 코드 입력시 해당 컬러로 자동 입력되어 노출됩니다.
이미지와 RGB값이 모두 등록되어 있을 시 이미지값을 우선하여 FO에 노출됩니다.

프로세스 정의

	구분	설명
1	단품목록 조회	검색조건에 따라 단품 목록을 조회 전체기간 검색 여부와 재고부족 여부를 지정하여 단품 조회가 가능
2	단품관리 목록 저장	변경된 단품관리 목록을 저장 재고수량, 안전재고 기준수량, 안전재고 알림 여부 등을 변경 가능 상품번호, 단품번호 필수값 미입력시 오류 반환
3	안전재고 알림기준수량 일괄 변경	선택한 단품들의 안전재고 알림 기준수량을 일괄 변경 안전재고 알림 여부가 ’Y’일 경우에만 변경 상품번호, 단품번호, 안전재고알림 기준수량 미입력시 오류 반환
4	재고수량 일괄 변경	선택한 단품들의 재고수량을 일괄 변경 재고관리 여부가 ’Y’일 경우에만 변경 상품번호, 단품번호, 재고수량 미입력시 오류 반환
5	단품 품절 처리	선택한 단품 목록을 품절 처리 배송 모듈의 결품 관리에서 결품 처리를 위해 호출

	구분	설명
1	옵션 분류 코드 목록 조회	옵션 분류 코드 정보 목록 조회 기능 제공 정렬 순서는 오름차순, 수정일시는 내림차순으로 정렬됨
2	옵션코드 목록 조회	옵션 분류 번호 기준으로 옵션 코드 정보 목록을 조회 정렬 순서는 오름차순, 수정일시는 내림차순으로 정렬됨
3	옵션 분류 코드 목록 저장	옵션 분류 코드 정보 목록 저장 기능 제공 옵션 분류명 수정시 단품 옵션 정보의 옵션 분류명도 수정됨 옵션 분류명은 중복 불가 목록 저장시 옵션 분류 코드 정보 유효성 검증 진행
4	옵션코드 목록 저장	옵션 코드 정보 목록 저장 옵션명 수정시 단품 옵션 정보의 옵션명도 수정

API 기능 목록

API	설명	Server	메소드	비고
안전재고 알림 기준 수량 일괄 변경	•선택한 단품들의 안전재고 알림 기준수량을 일괄 변경합니다. •안전재고 알림 여부가 Y인 경우에만 반영되며, N인 경우 반영되지 않습니다. •안전재고알림여부가 N인 경우, 안전재고알림기준수량이 초기화됩니다.	Goods	POST	🔗API 확인하기 >
재고수량 일괄 변경	•선택한 단품들의 재고수량을 일괄 변경합니다. •재고관리 여부가 Y인 경우에만 반영되며, N인 경우 반영되지 않습니다.	Goods	POST
단품 품절 처리	•단품 목록을 품절 처리합니다. •배송 모듈의 결품관리에서 결품 처리를 위해 호출됩니다.	Goods	POST
옵션 분류 코드 목록 조회	•옵션 분류 코드 정보 목록을 조회합니다. •정렬순서는 오름차순, 수정일시는 내림차순으로 정렬됩니다.	Goods	GET
옵션코드 목록 조회	•옵션분류번호를 기준으로 옵션 코드 정보 목록을 조회합니다. •정렬순서는 오름차순, 수정일시는 내림차순으로 정렬됩니다.	Goods	GET
옵션 분류 코드 목록 저장	•옵션 분류 코드 정보 목록을 저장합니다. •옵션 분류명 수정시, 단품 옵션 정보의 옵션분류명도 수정됩니다. •옵션 분류 코드 목록 저장시 입력한 옵션 분류 코드 정보의 유효성을 검증합니다. •옵션분류명은 중복이 불가능합니다.	Goods	POST
옵션코드 목록 저장	•옵션코드 정보 목록을 저장합니다. •옵션 분류명 수정시, 단품 옵션 정보의 옵션분류명도 수정됩니다. •옵션코드 목록 저장시 입력한 옵션 분류 코드 정보의 유효성을 검증합니다.	Goods	POST

용어 정의

명칭	설명	비고
상품	•상거래 채널을 통해 판매의 대상이 되는 모든 재화를 의미합니다. •상품을 전시하는 기본 단위이며 상품 상세 화면을 구성하는 기본 단위가 됩니다. •상품은 가격을 관리하는 단위입니다.
단품	•상품 하위의 최소 관리 단위로 상품 재고 및 판매의 최소 단위, 즉 고객이 구입하게 되는 단위입니다. •고객의 선택 옵션에 따른, 주문 상품 정보를 관리하는 단위입니다. •재고를 관리하는 단위입니다. (솔루션에서 재고는 ‘웹재고’를 의미합니다.) •옵션의 조합으로 단품 정보가 생성됩니다. (예) 단품A : 컬러-블랙/사이즈-260 / 단품B : 컬러-블랙/사이즈-250
옵션	•상품을 베리에이션하는 기본 단위입니다. •‘컬러’, ‘사이즈’ 등의 항목을 옵션명이라 하며 ‘블랙’, ‘XL’등을 옵션값이라 합니다. •옵션 유형은 성별, 색상, 크기, 중량, 용량, 지역 등 대부분의 커머스에 사용하는 유형이 존재하며 사이트별 필요시 추가하여 사용할 수 있습니다.
일반상품 (구분)	•일반적인 배송이 이루어지는 모든 재화 상품을 의미합니다.
사은품 (구분)	프로모션이나 이벤트 등을 통해 특정 상품 구매 혹은 특정한 액수 이상 구매 등과 같이 일정한 조건을 충족하는 고객에 한하여, 추가 비용 없이 지급하는 상품을 의미합니다.
일반상품	•단품에 상품의 옵션을 코드화에서 관리하는 상품을 의미합니다. •재고 차감은 단품 단위로 이루어 집니다.
묶음상품	•할인 여부와 상관없이 전시 활용을 위한 묶음 상품을 의미합니다. •옵션 구성 상품을 일부 선택하여 구매합니다.