스마트스토어 단위가격 입력 체크리스트: 대상 상품 검색부터 API 필수값까지

적용 대상 빠른 판별

• 스마트스토어에서 식품, 생활용품, 반려동물용품 등 용량·수량 기준 가격 표시가 필요한 카테고리를 판매합니다.
• 상품 등록·수정을 스마트스토어 화면뿐 아니라 네이버 커머스 API로도 처리합니다.
• 그룹상품, 옵션상품, 엑셀 일괄수정 상품이 섞여 있어 담당자별 입력 누락 가능성이 있습니다.
• 표시단위가 상품 포장지의 중량·부피 단위와 다르거나, 단위가격 표시 예외 판단이 필요한 상품이 있습니다.

체크리스트

1. 대상 상품을 먼저 뽑습니다. 스마트스토어 상품 조회/수정 상세검색에서 단위가격 표시의무 카테고리 조건으로 대상 상품을 검색합니다.
2. 엑셀 일괄작업 가능 여부를 확인합니다. 대상 상품이 많으면 수정양식을 다운로드해 단위가격 정보를 입력한 뒤 업로드하는 방식으로 누락을 줄입니다.
3. API 등록·수정 경로를 점검합니다. 커머스 API를 쓰는 경우 2026년 4월 29일 이후 대상 카테고리 상품 등록·수정 요청에 unitPriceYn이 빠지지 않도록 검증합니다.
4. 필수값 조건을 나눕니다. unitPriceYn: true인 경우 총 용량, 표시 용량, 표시 단위 값이 함께 필요한지 개발 요청서에 명시합니다.
5. 카테고리 판별 로직을 저장합니다. 카테고리 조회 결과의 예외 카테고리 값이나 그룹상품 옵션 가이드의 단위가격 사용 여부를 기준으로 대상 여부를 판별했다면 그 응답 예시를 보관합니다.
6. 표시단위 예외를 검토합니다. 표시단위로 표기하기 어려운 경우 상품 포장지의 중량·부피 단위를 쓸 수 있는지 공개 도움말과 가격표시제 기준을 함께 확인합니다.
7. 등록 실패 케이스를 테스트합니다. 대상 카테고리인데 단위가격 필드가 누락된 상품, 값이 null인 상품, 허용 단위가 아닌 상품을 테스트해 실제 오류 메시지를 저장합니다.

API 필드 확인표

저장해야 할 증적

• 단위가격 표시의무 카테고리로 검색한 대상 상품 목록
• 엑셀 수정양식 다운로드 파일과 업로드 완료 화면
• API 요청/응답 샘플, 실패 응답, 수정 배포일
• 카테고리 조회 또는 표준 구매옵션 조회로 대상 여부를 판별한 근거
• 표시단위 예외 판단을 한 상품의 포장 단위, 상세페이지 문구, 내부 승인 기록

운영자와 개발자가 나눠 맡을 일

운영자: 대상 카테고리 상품을 추출하고, 상품별 총 용량·표시 용량·표시 단위를 정리합니다.

개발자: 상품 등록·수정 API 요청에 단위가격 필드를 누락 없이 포함하고, 대상 카테고리 판별 로직과 오류 처리를 배포합니다.

검수자: 수정 후 스마트스토어 화면, 상품 상세페이지, API 응답, 엑셀 업로드 결과가 같은 값을 가리키는지 확인합니다.

공식 공개 출처

• 네이버 커머스 API 공지: 상품 단위가격 입력 4/29 필수 전환
• 스마트스토어 도움말: 단위가격 표시의무 대상 상품 검색 방법
• 스마트스토어 도움말: 표시단위로 표기하기 어려운 경우