상품관리

상품관리는 상품에 대한 종합적인 관리를 지원하는데, 상품 검색, 홍보문구 관리, 상품 승인, 상품 수정 이력 등의 기능을 제공합니다. 검색조건을 통한 효율적인 검색과 함께 상품 수정 시 이력을 관리하여 변경 내용을 추적할 수 있습니다.

---

주요 기능

• 상품 정보 관리

  • 상품을 다양한 조건으로 검색할 수 있으며, 판매상태, 상품유형, 홍보문구, 표준카테고리 등의 필터링이 가능합니다.

• 홍보 문구 관리

  • 상품 상세 팝업에서 조회 및 등록/수정이 가능하며, 중복 기간 등록에 대한 체크를 수행합니다.

  • 상품별 홍보문구 그리드의 홍보문구 CUD정보를 처리합니다.

• 상품 수정 이력

  • 상품 정보가 수정될 때마다 수정 이력을 남기며, 수정 이력 조회 기능을 통해 변경 내용을 상세히 확인할 수 있습니다.

  • 수정 이력에는 수정 항목, 수정 전, 수정 후, 수정자, 수정일시 등의 정보가 포함됩니다.

• 상품 승인 관리

  • 승인 상태, 상품 구성, 협력사, 담당MD, 상품명 등의 다양한 조건으로 상품 승인목록을 조회할 수 있습니다.

  • 승인 및 반려 기능을 제공하며, 반려된 상품은 재승인을 요청할 수 있습니다.

---

프로세스 정의 — 상품 정보 관리

1

상품 목록 조회

여러 조건으로 상품을 조회할 수 있게 기능 제공 상품 조회결과로 상품기본정보, 상품컨텐츠정보, 브랜드정보, 협력사기본정보를 목록에 노출

2

홍보문구 목록 조회

입력한 적용일시, 상품명, 상품번호, 사용여부, 홍보문구에 해당하는 홍보문구를 조회 조회 목록 결과정보로 상품번호, 상품명, 홍보문구, 적용시작일시, 적용종료일시, 사용여부 제공

3

홍보문구 수정

상품별 홍보문구 그리드 CUD정보를 처리하는 기능 제공 적용시작일시, 적용종료일시가 중복되지 않게 검증 기능 제공

4

상품정보 수정이력 목록 조회

수정항목들의 수정정보 조회 기능 제공 조회조건으로 수정일자, 수정항목, 상품명, 상품번호 제공 수정항목 예시: 안전인증대상여부, 구입자나이제한, 전시여부, 판매상태, 재고관리여부, 구매수량제한여부, 최소제한수량, 최대제한수량, 배송상품구분, 단품품절알림여부, 배송정책번호, 가격비교노출여부, 판매방식, 안전재고알림여부, 마일리지적립가능여부, 선물하기가능여부 등

5

수정상품 정보 조회

상품별 상세 수정항목 내용 조회 상품의 수정항목들의 현재 속성값을 제공

6

상품 승인 목록 조회

여러 조건으로 상품을 조회할 수 있게 기능 제공 승인요청상품 조회조건: 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사, 담당MD, 상품명, 상품번호 제공 조회결과로 승인상태, 반려사유, 상품구성, 상품유형, 판매방식, 담당MD, 상품번호, 상품명, 모델명, 과/면세구분, 매입형태, 정상가, 판매가, 마진율, 협력사, 브랜드, 배송처리유형, 상품등록일시, 상품승인일자 목록에 노출

7

상품승인

승인 시 판매중 상품으로 상태 변경 처리 승인요청 시 판매중 처리 전에 검증을 거쳐 실패할 경우 오류 내용 전달

8

상품반려사유저장

상품의 반려사유 항목들 중 한 개를 선택하여 반려 처리 반려된 상품은 재승인 가능

---

프로세스 정의 — 홍보 문구 관리

---

프로세스 정의 — 상품 수정 이력

---

프로세스 정의 — 상품 승인 관리

1

상품 승인 목록 조회

여러 조건으로 상품을 조회할 수 있게 기능 제공 승인요청상품 조회조건: 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사, 담당MD, 상품명, 상품번호 제공 조회결과로 승인상태, 반려사유, 상품구성, 상품유형, 판매방식, 담당MD, 상품번호, 상품명, 모델명, 과/면세구분, 매입형태, 정상가, 판매가, 마진율, 협력사, 브랜드, 배송처리유형, 상품등록일시, 상품승인일자 목록에 노출

2

상품승인

승인 시 판매중 상품으로 상태 변경 처리 승인요청 시 판매중 처리 전에 검증을 거쳐 실패할 경우 오류 내용 전달

3

상품반려사유저장

상품의 반려사유 항목들 중 한 개를 선택하여 반려 처리 반려된 상품은 재승인 가능

---

API 기능 목록

API	설명	Server	메소드	비고
상품 목록 조회	상품 검색 조건에 따라 상품 리스트를 조회합니다. 검색조건 중 상품 번호를 입력한 경우 상품 등록기간 조건을 무시하고 조회합니다. 검색조건으로 등록일/최종수정일 조회기간, 판매상태, 담당MD, 상품명, 브랜드, 협력사, 상품번호(시작, 포함, 같음, 멀티, 범위, 포함(멀티)) 조건으로 조회합니다.	Goods	GET	🔗API 확인하기 >
홍보문구 목록 조회	입력한 적용일시, 상품명, 상품번호, 사용여부, 홍보문구에 해당하는 홍보문구를 조회합니다. 최근 수정일시 순으로 조회합니다.	Goods	GET	🔗API 확인하기 >
홍보문구 수정	그리드의 홍보문구 CUD정보를 받아서 상품별 홍보문구 정보를 추가/수정/삭제를 합니다. 적용일시에 중복되는 홍보문구가 있는지 검증합니다.	Goods	POST	🔗API 확인하기 >
상품 승인 목록 조회	판매상태가 승인대기/반려인 상품만 조회합니다. 입력한 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사 번호/명, 담당 MD, 상품명, 상품번호에 맞는 상품을 조회합니다. 상품 등록일 역순으로 조회합니다	Goods	GET	🔗API 확인하기 >
상품승인	판매상태가 승인대기인 상품만 승인이 가능합니다. 상품과 상품에 해당하는 단품의 판매상태를 승인대기에서 판매중으로 변경합니다. 상품기본 수정로그, 상품기준 판매상태이력, 단품 추가 가격이력, 단품기본ML 테이블의 신규데이터를 생성합니다.	Goods	POST	🔗API 확인하기 >
상품반려사유저장	판매상태가 승인대기인 상품만 반려가 가능합니다. 반려사유, 반려사유상세 내용을 저장하고, 상품의 판매상태를 승인대기에서 반려로 변경합니다.	Goods	POST	🔗API 확인하기 >
상품정보 수정이력 목록 조회	입력한 수정일자, 수정항목, 상품명, 상품번호에 맞는 상품을 조회합니다. 최근 등록된 상품정보 수정이력 순으로 조회합니다	Goods	GET	🔗API 확인하기 >
수정상품 정보 조회	상품정보 수정이력에서 선택된 상품의 정보를 조회합니다	Goods	GET	🔗API 확인하기 >

---

용어 정의

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

---