네이버·쿠팡·카페24 상품등록 필드 완전 비교 — 3사 자동등록하며 실측한 레퍼런스
상품 하나를 네이버·쿠팡·카페24에 자동으로 올리려면, 각 플랫폼이 뭘 요구하는지 필드 단위로 알아야 합니다. 그런데 이 3사 비교표가 인터넷 어디에도 제대로 정리돼 있지 않더라고요. 각 플랫폼 API 문서는 자기 것만 설명하지, "네이버는 이런데 쿠팡은 저렇다"를 나란히 보여주는 곳은 없었어요. 그래서 3사 자동등록 시스템을 직접 만들며 필드마다 실측한 걸 그대로 표로 남깁니다. 저처럼 쇼핑몰을 자동화하려는 분이 이 글 하나로 지도를 얻으시길 바라요.
👤 이런 분께 상품을 여러 쇼핑몰에 올리는데 매번 필드가 달라 헤매는 분, 3사 등록을 코드로 자동화하려는 1인 셀러·개발자.
- 네이버·쿠팡·카페24 필수 필드 그룹 비교표(실측)
- 세 플랫폼의 카테고리 체계가 왜 그렇게 다른지
- 다들 빠뜨리는 고시정보(전상법) 필드의 정체
- 자동화가 조용히 실패하는 지점 5곳과 회피법
🎯 전제 계정·비밀·거래처 정보는 일절 담지 않습니다. 순수하게 "어떤 필드가, 어떤 형식으로 필요한가"의 공개 가능한 실측 레퍼런스입니다.
먼저 결론 — 3사는 '같은 상품'을 이렇게 다르게 받는다
같은 티셔츠 한 장을 올려도, 세 플랫폼은 요구하는 게 다 달라요. 필수로 채워야 하는 필드 그룹은 대체로 겹치는데, 형식과 규칙이 전부 달라서 "복붙"이 안 됩니다. 그게 자동화가 필요한 이유이자, 자동화가 어려운 이유예요.
① 필수 필드 그룹 비교표
먼저 큰 그림. 세 플랫폼 모두 아래 그룹은 필수예요(안 채우면 등록 자체가 안 됨). 차이는 오른쪽 "실제로 데인 점" 칸에 있습니다.
| 필드 그룹 | 세 플랫폼 공통점 | 자동화에서 실제로 데인 점 |
|---|---|---|
| 상품명 | 3사 모두 필수. 길이 제한·금지어 규칙 있음 | 플랫폼마다 권장 길이와 금지 표현이 달라, 같은 이름을 그대로 못 씀 → 플랫폼별로 이름을 다시 조립 |
| 카테고리 | 3사 모두 필수 | 체계가 완전히 다름(아래 ②에서 상세). 자동 매핑이 가장 어려운 지점 |
| 판매가·재고 | 3사 모두 필수 | 재고를 '수량'이 아니라 품절 여부 중심으로 관리하면 정합성이 훨씬 단순해짐 |
| 옵션(SKU) | 색상·사이즈 등 선택지 | 옵션 축 구조가 달라 조합(SKU)을 각 플랫폼 형식으로 다시 펼쳐야 함(아래 ③) |
| 대표이미지 | 3사 모두 필수 | 규격·장수·형식 요구가 달라 업로드가 거부되기도(아래 ④) |
| 상세페이지 | 3사 모두 필수 | 어디는 HTML, 어디는 에디터/이미지 기반 → 상세를 한 벌로 만들어 형식만 바꿔 내보냄 |
| 고시정보 | 전자상거래법상 필수 정보 | 가장 많이 빠뜨리는 필드. 매핑이 없으면 등록은 되는데 법정 정보가 비어서 나감(아래 ⑤) |
| 배송·원산지 | 3사 모두 필수 | 배송 템플릿·원산지 코드 체계가 달라 값을 플랫폼 코드로 번역해야 함 |
정리하면 — 필드 '그룹'은 8개 안팎으로 겹치지만, 각 칸을 채우는 규칙이 세 곳 다 달라서 한 상품을 세 번 손으로 올리면 지치고 실수가 납니다. 여기서부터가 자동화의 영역이에요.
② 카테고리 — 세 플랫폼이 가장 다른 지점
자동등록에서 제일 애먹은 게 카테고리였어요. 상품명이나 가격은 텍스트라 그나마 옮기기 쉬운데, 카테고리는 플랫폼마다 트리(분류 체계) 자체가 달라서 기계가 "이 옷은 저기 어디에 넣어야 하지?"를 매번 다시 풀어야 합니다.
| 플랫폼 | 체계 | 자동 매핑에서 주의할 점 |
|---|---|---|
| 네이버 | 여러 단계 트리(예: 여성 > 의류 > 팬츠)에 카테고리 코드로 지정 | 트리 깊이가 깊음. 최말단 코드까지 정확히 찍어야 검색·수수료가 맞음 |
| 쿠팡 | 자체 카테고리 코드 체계 | 네이버·카페24와 코드가 전혀 안 맞음 → 상품 특성 기준으로 다시 분류 |
| 카페24 | 몰이 직접 만든 분류. 잎(말단) 노드에만 상품 배정 가능 | 중간 노드에 넣으면 배정 실패. 게다가 몰에 카테고리가 0개면 아예 못 넣음(먼저 만들어야 함) |
그래서 우리는 상품마다 카테고리를 한 번 확정하면 세 플랫폼 코드로 각각 번역해 두는 방식으로 풀었어요. 카테고리를 상품명보다 앞 단계에서 못 박아두면, 뒤 작업(이름·수수료·검색)이 전부 안정됩니다.
③ 옵션(SKU) — 축 구조가 다르다
색상·사이즈 같은 선택지를 '옵션'이라고 하는데, 이걸 조합(SKU)으로 펼치는 방식이 플랫폼마다 달라요. 우리는 옵션을 축(axis) 개념으로 관리합니다 — 예를 들어 색상 축 3개 × 사이즈 축 4개 = 12개 조합. 여기에 '기획전 멤버' 같은 3번째 축이 붙으면 더 복잡해지고요.
| 원칙 1 | 옵션은 '축'으로 관리하고 조합은 마지막에 펼친다 → 플랫폼별 형식 변환이 쉬워짐 |
|---|---|
| 원칙 2 | 재고는 수량보다 '품절 여부'가 핵심. 수량 정합을 무리하게 맞추기보다 품절 정확성을 우선 |
| 원칙 3 | 같은 조합이라도 플랫폼별 추가금·판매자관리코드가 달라, 조합을 '상품의 신분증'처럼 하나로 묶어 추적 |
④ 이미지 — 규격이 다르고, 거부당한다
대표이미지는 3사 다 필수인데, 장수·크기·형식 요구가 달라서 그대로 올리면 거부당하는 경우가 있어요. 실제로 카페24에서 이미지 등록이 거부돼 원인을 한참 파본 적이 있습니다.
| 장수 | 대표 1장은 공통 필수. 추가 이미지 허용 개수는 플랫폼마다 다름 |
|---|---|
| 규격 | 권장 해상도·비율·용량 상한이 달라, 같은 원본을 플랫폼별로 리사이즈해 내보냄 |
| 거부 사유 | 형식·용량·외부 URL 정책 등에 걸리면 조용히 실패 → 업로드 응답을 반드시 확인하고 재시도 |
⑤ 고시정보(전상법) — 다들 빠뜨리는 그 필드
이게 이 글에서 가장 강조하고 싶은 부분이에요. '상품정보제공고시'는 전자상거래법상 반드시 표기해야 하는 정보(소재·제조국·치수·취급주의 등, 품목마다 항목이 다름)인데 — 자동등록을 짜면 이걸 매핑하는 걸 잊기 쉽습니다.
⚠️ 왜 위험한가
- 고시정보 매핑이 없어도 등록은 성공해버려요. 그래서 "다 됐다"고 착각합니다.
- 그런데 실제로는 법정 필수 정보가 빈 채로 상품이 올라간 상태 → 나중에 대량으로 문제가 됩니다.
- 품목(의류·잡화·식품…)마다 고시 항목 자체가 달라서, "한 벌"로 채울 수 없고 품목별 매핑이 필요해요.
그래서 우리는 상품의 소재·성분·원산지·치수 같은 사실(fact)을 한 곳에 모아두고, 그걸 각 플랫폼의 고시정보 칸으로 자동 배선했습니다. 자동등록을 만드신다면, "등록 성공"에 속지 말고 고시정보가 채워졌는지를 꼭 별도로 확인하세요.
자동화가 '조용히' 실패하는 지점 5곳
등록이 실패하면 차라리 낫습니다. 무서운 건 성공한 척하고 틀리는 것. 우리가 실제로 데인 5곳이에요.
| 지점 | 회피법 |
|---|---|
| ① 인증 토큰 2시간 만료 | 카페24 등 토큰 수명이 짧음 → 등록 직전에 토큰을 갱신하고, 만료 시 자동 재발급 |
| ② IP 허용목록(화이트리스트) | 쿠팡 오픈API 등은 등록 IP를 미리 등록해야 함 → 서버 IP가 바뀌면 통째로 막힘 |
| ③ 카테고리 잎 노드 규칙 | 카페24는 말단 카테고리에만 배정 → 중간 노드 매핑은 실패. 몰 카테고리 0개면 먼저 생성 |
| ④ 고시정보 미매핑 | 등록은 성공하지만 법정 정보가 빈 채 나감 → 품목별 고시 매핑을 필수 검사에 포함 |
| ⑤ 이미지 업로드 거부 | 형식·용량·URL 정책 위반 시 조용히 실패 → 업로드 응답을 확인하고 재시도 로직 |
정리 — 이 표가 필요했던 이유
처음 3사 등록을 자동화하려 했을 때, 저는 이런 비교표 하나가 절실했어요. 각 플랫폼 문서를 따로따로 읽으며 "그래서 네이버랑 쿠팡이랑 뭐가 다른 건데?"를 머릿속으로 매번 맞춰봐야 했거든요. 그 지도를 직접 그려가며 배운 걸, 다음 사람은 안 헤매도록 한 장에 정리했습니다.
핵심만 다시 담으면 — 필수 필드 그룹은 겹치지만 규칙이 다 다르고, 가장 어려운 건 카테고리, 가장 많이 빠뜨리는 건 고시정보, 가장 무서운 건 성공한 척 실패하는 5곳이에요. 이 글이 쇼핑몰 자동화의 출발점 지도가 되면 좋겠습니다. 3사 등록의 전체 흐름과 '번역기(어댑터)' 구조가 궁금하시면 이 글에서 이어집니다. 배배였습니다.