[중요] 상품등록 API 단위가격 항목 추가 및 적용 일정 안내

[안내] 상품등록 API(setItemBatch) 단위가격정보 항목 추가 및 적용 일정 안내

안녕하세요. 도매꾹/도매매 입니다.

산업통상자원부의「가격표시제 실시요령」및 마켓 정책에 따라,

상품등록API(setItemBatch)에 단위가격 표시여부 및 단위가격정보 항목이 추가됩니다.

가격표시제 대상 카테고리 상품을 등록/수정하는 경우,

2026년 6월 4일 이후 단위가격 항목 입력이 필요하오니 이용에 참고해주시기 바랍니다.

1. 적용 대상 및 버전

• 상품등록/수정 API (setItemBatch) - 4.1 버전

2. 반영 일정

① 적용 시작

• 2026-05-06(수)

• 단위가격 관련 항목 추가

② 유예기간

• 2026-05-06(수) ~ 2026-06-03(수)

• 해당 유예기간 내 단위가격 항목 입력은 선택이며, 미입력해도 등록/수정 가능

③ 필수 적용 

• 2026-06-04(목) 이후

• 조건부 필수 적용(가격표시제 대상 카테고리 상품은 단위가격 표시여부 입력 필요)

• 미입력 시 상품 등록/수정 및 외부마켓 전송 제한

3. 변경사항

• setItemBatch API 4.1 버전 내 아래 항목 추가

  • useLabeledPrice(단위가격 사용여부)

  • labeledPrice(단위가격 정보)

    • 자세한 등록방법은 대량등록가이드엑셀 참고

3. 참고사항

• API 버전은 기존 4.1 버전을 그대로 사용하며, API 스펙에 단위가격 관련 항목이 추가되는 방식으로 반영됩니다.

• 유예기간 내에는 대상 카테고리 상품이어도 단위가격 미입력이 허용되며, 유예기간 종료 후에는 단위가격 표시여부를 반드시 입력해야 합니다.

• 대상 카테고리 및 입력 기준은 하단의 단위가격 표시 카테고리 파일 및 API 문서를 참고해주시기 바랍니다.

4. 유의사항

• 가격표시제 대상 카테고리 상품의 단위가격정보가 누락되거나 정확하지 않을 경우, 쿠팡 또는 스마트스토어 전송 시 제한이 발생할 수 있습니다.

• 대상 카테고리 상품을 API로 등록/수정 중인 연동사는 유예기간 내 반영 작업을 진행해주시기 바랍니다.

감사합니다.

도매꾹 드림