공지사항
공지사항
ℹ️

상품 고시정보 V2 API

변경사항

ProductProposalDataDtoannouncement 필드는 deprecated 되고 announcementV2가 추가되었습니다.
새로 추가된 카테고리인 식품, 가구/인테리어, 주방용품, 생활용품 노출은 announcementV2 를 통해서만 고시 정보를 등록할 수 있습니다.
(기존의 announcement 필드에 넣지 않고 announcementV2 에만 추가해주시면 됩니다.
고시정보 버전
필드 정보
상품고시정보 지원 대상
향후 업데이트
V1
announcement
의류, 뷰티, 건기
X
V2
announcementV2
퀸잇 상품 전체 ( 의류, 뷰티, 건기, 식품, 가구/인테리어, 주방용품, 생활용품
지속 지원
필드 길이 제한 10000자

v2 상품 고시정보 타입 정보

APPAREL : 의류
BEAUTY : 뷰티
HEALTH_FUNCTIONAL_FOOD : 건강기능식품
FOOD : 식품
FURNITURE : 가구
KITCHEN : 주방용품
HOUSEHOLD_GOODS : 생활용품

API 설명

2024년 8월 이후 셀러 API 문서 참고
/seller/product-announcements (GET)
고시정보 타입 별 고시정보 항목을 반환합니다.
/seller/product-announcements/rules (GET)
모든 카테고리ID 에 대해 카테고리 별 고시정보 타입을 반환합니다.
응답 예시 (8월 기준의 샘플 이며 API 연동하시는 것을 추천합니다.)
[ { "announcementType": "APPAREL", "attributes": [ "제조회사", "제조국", "품질보증기준", "A/S 책임자 및 전화번호", "색상", "소재", "치수", "제조일자", "세탁방법 및 취급시 주의사항" ] }, { "announcementType": "BEAUTY", "attributes": [ "제조국", "품질보증기준", "A/S 책임자 및 전화번호", "화장품 용량", "화장품 책임판매업자", "사용방법", "제품 주요 사양", "사용시 주의사항", "유통기한 또는 개봉 후 사용기한", "성분 (화장품법에 따라 기재, 표시하여야 하는 모든 성분)", "식품의약품안전처 심사 필요 유무" ] }, { "announcementType": "HEALTH_FUNCTIONAL_FOOD", "attributes": [ "상품명", "제조업소의 명칭과 소재지", "소비기한 및 보관방법", "포장단위별 내용물의 용량(중량), 수량, 크기", "원료명 및 함량 (농수산물의 원산지 표시 등에 관한 법률에 따른 원산지 표시 포함)", "영양정보", "기능정보", "섭취량, 섭취방법 및 섭취 시 주의사항 및 부작용 가능성", "질병의 예방 및 치료를 위한 의약품이 아니라는 내용의 표현", "건강기능식품에 관한 법률에 따른 유전자변형건강기능식품 표시 (해당 경우에 한함)", "소비자 안전을 위한 주의사항", "표시/광고 사전심의필", "수입 건강기능식품의 경우 “수입식품안전관리특별법에 따른 수입신고를 필함”의 문구", "소비자 상담 관련 전화번호" ] }, { "announcementType": "FOOD", "attributes": [ "품목 또는 제품명", "식품의 유형 (가공식품의 경우 해당)", "포장단위 별 내용물의 용량(중량), 수량, 크기", "생산자 및 소재지", "원산지 및 원재료명", "영양성분 (영양성분 표시대상 식품에 한함)", "제조연월일, 소비기한 또는 품질유지 기한", "세부 품목군별 표시사항 (농축수산물의 경우 해당)", "상품 구성", "보관 방법 및 취급방법", "관련법상 표시 사항", "소비자 안전을 위한 주의사항" ] }, { "announcementType": "FURNITURE", "attributes": [ "품명", "KC 인증번호", "색상", "구성품", "주요 소재", "제조자, 수입품의 경우 수입자를 함께 표기", "제조국", "크기", "재공급(리퍼브) 가구의 경우 재공급 사유 및 하자 부위에 관한 정보", "배송, 설치비용", "품질보증기준", "A/S 책임자와 전화번호" ] }, { "announcementType": "KITCHEN", "attributes": [ "품명 및 모델명", "재질", "구성품", "크기", "동일모델의 출시년월", "제조자, 수입품의 경우 수입자를 함께 표기", "제조국", "[수입식품안전관리 특별법]에 따른 수입가구 또는 용기, 포장의 경우 “수입식품안전관리 특별법에 따른 수입신고를 필함”의 문구", "품질보증기준", "A/S 책임자와 전화번호" ] }, { "announcementType": "HOUSEHOLD_GOODS", "attributes": [ "품명 및 모델명", "법에 의한 인증, 허가 등을 받았음을 확인할 수 있는 경우 그에 대한 사항", "제조국 또는 원산지", "제조자, 수입품의 경우 수입자를 함께 표기", "A/S 책임자와 전화번호 또는 소비자 상담 관련 전화번호" ] } ]
JSON
복사
/seller/product-announcements/rules/{categoryId} (GET)
특정 카테고리 ID 에 대해 고시정보 타입을 반환합니다.

announcementV2 데이터 요청 예시

/seller/product-announcements/rules 또는 /seller/product-announcements/rules/{categoryId} 를 사용하여 등록하려는 상품에 맞는 고시정보 타입을 조회합니다.
/seller/product-announcements 를 사용하여 고시정보 타입에 맞는 고시정보 항목을 조회합니다.
이때 고시정보 항목은 모두 필수값입니다.
고시정보 항목을 json key로 사용하여 고시정보 json을 생성합니다.
데이터 예시
announcementV2 필드에 json을 문자열로 담아 요청합니다.
데이터 예시

QnA

Q. 기존 연동 중인 고시정보 방식은 어떻게 되나요?
→ 이미 announcement 에 대한 하위 호환을 계속 지원하지만 추가 업데이트는 지원하지 않으며 가급적 announcementV2 방식으로 대응 부탁드립니다.
Q. V1 필드와 V2 필드를 함께 넣어도 되나요?
→ 기본 동작은 V2 필드 정보를 우선적으로 하며, V1을 함께 넣을 경우에 V1 필드에 검증을 진행하므로 이로 인한 실패가 발생할 수 있습니다. 개발환경을 통해, V2 필드로만 넣어 테스트 부탁드립니다.

문의 사항

tech-support@rapportlabs.kr 로 문의 부탁드립니다.