줌(JOOM)에 상품을 올린 뒤 카테고리가 잘못 들어간 것을 알게 됐습니다. 판매 프로그램에서 카테고리 번호인 categoryId 를 바꿔 수정 요청을 보냈고, 줌은 200 을 돌려줬습니다. 200 은 요청을 정상으로 처리했다는 뜻의 응답 번호입니다.

수정은 API 로 했습니다. API 는 사람이 화면을 누르지 않아도 프로그램이 마켓과 직접 값을 주고받는 통로입니다. 줌의 상품 수정 창구는 /products/update 이고, 바꿀 칸만 골라 담아 보냅니다. 담지 않은 칸은 건드리지 않습니다.
🔍 되읽어 보고서야 알았습니다
오류도 경고도 없었기 때문에 처음에는 바뀐 줄 알았습니다. 상품을 다시 읽어 와서 값을 하나씩 맞춰 보고 나서야, 카테고리가 처음 값 그대로라는 것이 보였습니다. 적어도 카테고리에서는 200 이 반영을 뜻하지 않았습니다.
그 뒤로는 수정 요청을 보내고 나면 상품을 다시 불러와 바뀐 칸을 직접 확인합니다. 응답 번호만 보고 끝내면 이런 일을 놓칩니다.
되읽을 때 맞춰 보는 칸은 셋입니다.
· category → 줌이 매긴 분류
· state → active(판매 중)·pending(심사 대기)·rejected(거절) 같은 상품 상태
· review.reasons → 상품에 붙은 사유 목록, 사유마다 J 로 시작하는 코드가 있다
📌 판매자 패널에서도 잠겨 있습니다
줌 판매자 패널에서 상품 편집 화면을 열면 「판매자 상품 카테고리」 칸이 비활성(disabled) 상태입니다. 눌러도 다른 값을 고를 수 없습니다. API 로도 화면으로도, 등록이 끝난 뒤에는 판매자가 카테고리를 바꿀 방법이 없다는 이야기입니다.
줌 상품 정보에는 줌이 직접 매긴 분류(category)가 들어 있습니다. categoryId 를 바꿔 보내도 꿈쩍하지 않은 것이 바로 이 값이었습니다. 요구 서류도 이 분류를 보고 붙습니다.
⚠️ 분류 하나로 요구 서류와 판매 국가가 바뀝니다
화장품인데 줌 분류가 기기 쪽(예: Cosmetology Equipment)으로 잡히면, 그 카테고리의 요구 서류에 CE 인증서가 들어갑니다. 그러면 J1452(CE 인증서 누락) 사유가 붙고 나라별 판매 제한이 걸립니다.
이 사유를 보면 인증서부터 구하려 들기 쉽습니다. 하지만 화장품이라면 고칠 대상은 인증서가 아니라 분류입니다. 그 분류를 판매자가 못 바꾸니, 길은 아래 둘뿐입니다.
· 줌 판매자 지원팀에 사유 코드와 함께 카테고리를 옮겨 달라고 요청한다
· 판매 이력이 없는 상품이면 /products/remove 로 지우고 같은 SKU 로 /products/create 해서 다시 올린다
다시 올리면 상품 번호가 새로 나옵니다. 주문·재고 연동을 옛 번호로 묶어 두었다면 그 연결도 새 번호로 바꿔야 합니다. 판매 이력이 있는 상품은 쌓인 후기와 순위가 새 상품으로 넘어가지 않으므로 지원팀 쪽을 먼저 봅니다.
🎯 신고가와 상품명은 고쳐집니다, 심사 여부만 다릅니다
아래 칸들은 /products/update 로 고쳐집니다. 어떤 칸을 담아 보내느냐에 따라 상품 상태가 갈립니다.
· variants(옵션 목록)에 sku(옵션 코드)와 declaredValue(신고가)만 담음 → active(판매 중) 유지
· name(상품명)·description(설명)·attributes(속성)·brand(브랜드)를 고침 → pending(심사 대기)
신고가만 담아 보낸 요청은 가격·재고·이미지·배송 치수에 손대지 않았습니다. 신고가만 고칠 때는 재심사를 걱정하지 않아도 됩니다. 신고가가 판매가보다 높을 때 붙는 J1066 사유도 이 방식으로 신고가를 판매가 이하로 내려 풉니다.
pending 으로 넘어가면 사유 목록에 J1107(심사 대기) 같은 코드가 붙습니다. 원래 팔리던 상품이면 판매는 그대로 이어집니다. 심사하는 동안 손님에게는 공개 버전, 곧 수정 전 상품이 계속 팔립니다. 심사는 하루를 넘기기도 했으니 수정 내용이 바로 안 보여도 기다립니다.

속성은 한 가지를 더 조심합니다. attributes 는 보낸 목록으로 통째로 갈아 끼워집니다. 속성 하나를 고치려고 그 하나만 보내면 나머지가 빠지므로, 남길 속성까지 함께 담아 보냅니다.
💡 줌 연결은 설정의 JOOM API 에서
싹마켓 사용 설명서의 줌 연결 순서에서 빠뜨리면 안 되는 칸은 Client ID 입니다. 설정에서 JOOM API 를 열고, 줌 연결에 쓰는 앱의 Client ID 를 꼭 넣은 다음 넓은 연결 단추를 눌러 줌 로그인 화면에서 허용합니다.

줌에 상품을 올리는 셀러가 챙길 것을 정리하면 이렇습니다. 카테고리는 등록 전에 확인합니다. 신고가는 심사 걱정 없이 고칩니다. 상품명·설명·속성·브랜드는 심사를 탄다는 것을 알고 고칩니다.
셋 가운데 되돌릴 수 없는 것은 카테고리 하나입니다. 내 가게에서 이 칸만큼은 처음에 맞게 넣어야 합니다.
'마켓API실전' 카테고리의 다른 글
| 줌 API description 은 plain text: 상세 이미지를 extraImages·richContent 로 나누는 법 (0) | 2026.10.28 |
|---|---|
| 줌 API 상품 등록의 dangerInfo 정리: isDangerous 와 위험물 종류 18가지 (0) | 2026.10.24 |
| 쇼피 API 문서 444개의 변경 기록을 다 세어 봤습니다: 조용히 필수가 되는 항목들 (0) | 2026.10.18 |
| 쇼피 수수료 다섯 칸, 연결한 날 넣은 값을 그대로 두면 생기는 일 (0) | 2026.10.13 |
| 라자다 API 연결, 한국 셀러가 Site 를 Crossborder 로 골라야 하는 이유 (0) | 2026.10.09 |
댓글