본 안내 문서는 5월 21일 WING 포털에 공지된 《[OpenAPI] 상품 필수 속성 입력 의무화 및 모니터링 강화 안내》 사항에 대한 추가 FAQ를 제공합니다. 현재 관련 OpenAPI 변경 사항은 내부 검토(Review) 중이며, 가까운 시일 내에 정식 배포될 예정입니다. 판매자 및 개발사 여러분께서는 일상적인 비즈니스에 차질이 없도록 2026년 7월 31일 전까지 시스템 검토 및 연동 업그레이드를 완료해 주시기 바랍니다.
현재 아래와 같은 신규 API가 출시되었습니다:
신규 브랜드 검색 API (Brand Search API): 브랜드 명칭으로 브랜드 정보 조회
신규 등록 브랜드 목록 API (Brand Enrolled API): 판매자가 등록된 브랜드 정보 목록을 조회
신규 브랜드 ID 조회 API (Get Brand by ID API): 판매자가
brandId로 브랜드 정보를 조회상품 등록 API 업데이트 (Update Product Creation API): 신규 필드
brandId추가 및attribute배열 내 GTIN / MPN 추가 포맷 지원
Q1: 6월 1일까지 MPN 및 GTIN 정보를 입력하지 않으면 기존에 판매 중인 상품이 판매 중지(노출 종료)되나요? 기존 API 사용자(기존 유저)는 어떤 영향을 받게 되나요?
기존 등록된 상품(기존 상품): 6월 1일 이후 필수 식별 코드 정보가 입력되지 않더라도 상품이 즉시 판매 중지(노출 종료)되지는 않습니다.
-
신규 등록 상품 (신규 vs 기존 유저 기준):
신규 유저 (2026년 6월 1일 이후 API Key 신규 발급자): 필수 속성이 누락될 경우 상품 등록 심사 단계에서 즉시 반려(등록 거부) 처리됩니다.
기존 유저 (2026년 6월 1일 이전 API Key 발급자): 단기적으로는 신규 상품 등록 시 즉시 에러가 발생하거나 차단되지 않으나, 최종 마감일인 2026년 7월 31일 전까지 반드시 API 업그레이드를 완료하셔야 합니다. 그렇지 않을 경우 해당 날짜 이후부터는 신규 상품 등록이 심사 단계에서 반려 처리(차단)됩니다.
Q2: 이번 OpenAPI 개편으로 정확히 어떤 부분이 변경되나요? 관련된 신규 API 및 필드는 무엇인가요?
이번 업데이트를 통해 1개의 신규 필드와 3개의 신규 API(엔드포인트)가 추가됩니다. 기존 필드(barcode, modelNo, emptyBarcode 등)는 내부 로직상 완전히 격리되어 서로 영향을 주지 않습니다.
상품 등록 API 신규 필드:
brandId필드가 추가됩니다(기존 텍스트 형태의brand명칭과 매핑됨). 이와 동시에attributes배열 파라미터 내에 Global Trade Item Number 또는 Manufacturer Part Number을 전달할 수 있습니다.신규 Brand Search API (브랜드 검색 API): 브랜드 명칭(텍스트)을 입력하여 쿠팡 시스템 내 표준
brandId및 상세 정보를 조회할 수 있습니다.신규 Enrolled Brands API (등록 브랜드 목록 API): 현재 시스템에 등록된 모든 표준 브랜드 명칭 목록을 조회할 수 있습니다.
신규 Get Brand by ID API (브랜드 ID 조회 API):
brandId를 통해 브랜드의 상세 정보를 조회할 수 있습니다.
#JSON 요청 예시
"items": [
{
"itemName": "Black",
"attributes": [
{
"attributeTypeName": "Global Trade Item Number",
"attributeValueName": "0194253941234",
"exposed": "NONE"
},
{
"attributeTypeName": "Manufacturer Part Number",
"attributeValueName": "MT0Q3FE/A",
"exposed": "NONE"
}
]
}
]
Q3: 브랜드 정보가 있는 상품이라면 무조건 MPN 또는 GTIN을 입력해야 하나요? 만약 식별 코드가 없는 상품이라면 어떻게 해야 하나요?
-
조건부 의무 적용 (브랜드별 상이): 무조건적인 필수 입력은 아닙니다. 개발사는 우선 Brand Search API를 호출하여 반환되는 데이터 중
isUIDRequired필드 값을 확인해야 합니다:true인 경우: MPN 또는 GTIN을 반드시 입력해야 합니다.false인 경우: 필수 입력 대상이 아닙니다 (선택 사항).
식별 코드가 전혀 없는 상품의 경우: 객관적으로 브랜드나 식별 코드가 존재하지 않는 상품은 해당 필드를 비워둘 수 있습니다.
중요 유의사항: 만약 상품명(타이틀)에는 브랜드명이 포함되어 있으나
brand필드를 비워두는 경우, 상품 승인이 거절(반려)되거나 노출이 크게 제한될 수 있으므로 각별히 유의하시기 바랍니다.
Q4: 다른 상품 옵션(예: 사이즈, 색상이 다른 경우) 간에 MPN 또는 GTIN 정보가 중복되어도 되나요?
일반적으로 동일 브랜드의 동일 모델(스타일) 상품이면서 사이즈나 색상만 다른 경우, 동일한 식별 코드를 사용하는 것이 허용됩니다. 상세 유효성 검사 로직은 정식 배포 후 OpenAPI의 응답 에러 코드를 확인해 주시기 바랍니다.
Q5: 새로운 브랜드 정보를 등록할 수 있는 브랜드 등록 API도 제공되나요?
아닙니다. 현재 API를 통한 브랜드 등록 기능은 제공되지 않습니다. 대신 쿠팡은 조만간 WING 관리자 대시보드 내에 신규 브랜드 등록 포털을 추가할 예정입니다. 새 브랜드를 등록해야 하는 판매자는 WING 포털을 통해 수동으로 신청해 주셔야 합니다.
Q6: ERP(연동 업체) 및 자사몰 연동 개발자는 기존에 등록된 상품들을 어떻게 수정하고 대응해야 하나요?
현재 OpenAPI는 인터페이스를 통해 기존 상품의 속성 필드(예: brandId 등)를 직접 수정하거나 업데이트하는 기능을 지원하지 않습니다. 따라서 기존 판매 중인 상품의 정보를 수정하려면 아래의 WING 대시보드 수정 방식을 판매자에게 안내해 주시기 바랍니다.
방법 1: WING 백오피스 개별 상품 수정 WING > 상품 관리 > [상품 조회/수정] 메뉴로 이동합니다. 상단의 '정보 업데이트하고 매출 올리기' 영역에서 "누락된 필수 옵션 정보 입력" 또는 "필수 속성 입력" 대상 상품을 확인합니다. '상품 수정'을 클릭하여 누락된 식별 코드를 입력하고 저장합니다. (참고: 'AI 추천'이 노출되는 경우 검토 후 반영할 수 있으나, 판매자가 직접 검토 후 저장해야만 최종 적용됩니다.)
방법 2: WING 백오피스 엑셀 대量 업로드 WING > 상품 관리 > [상품 조회/수정] 메뉴로 이동합니다. '정보 업데이트하고 매출 올리기' 영역 하단의 [누락된 필수 속성 정보 일괄 입력] 버튼을 클릭합니다. [1단계]에서 엑셀 템플릿을 다운로드하여 누락된 속성/식별 코드를 입력 후 저장한 뒤, [2단계]를 통해 파일 업로드하여 반영합니다.