변경사항
•
ProductProposalDataDto 내 announcement 필드는 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 로 문의 부탁드립니다.