상품·재고를 수백·수천 건씩 맞춰야 할 때
시즌 오픈, ERP·창고 재고와 맞추기, 가격 일괄 변경, 옵션 조합이 많은 카탈로그를 한꺼번에 올릴 때, 관리자에서 하나씩 고치면 일정이 버티지 않습니다. 엑셀 업로드로 버티다가 ‘외부 프로그램에서 자동으로 맞추고 싶다’는 요구로 카페24 API를 찾는 경우가 많습니다.
가능 여부부터 말하면, 카페24 API로 대량 상품·재고를 일괄 수정하는 것은 가능합니다. 다만 관리자 화면의 ‘엑셀 일괄 등록’과 같은 버튼 하나가 API에 있는 것은 아니고, 상품·옵션·재고마다 API 경로와 권한이 다릅니다. 실무에서는 OAuth 토큰을 별도 서버에 두고, 수정할 목록을 나눠 호출하며, 실패 건을 로그에 남기는 배치·재시도 구조로 갑니다. ‘한 번에 전부’보다 ‘몇 건씩 나눠 검증 가능하게’가 안전합니다.
한눈에 보는 핵심 답변
대량 상품·재고 일괄 수정을 볼 때 경로만 먼저 정리하면 아래와 같습니다.
- 카페24 API로 상품·옵션·재고를 대량 수정하는 것은 가능합니다.
- 관리자 엑셀·앱만으로도 버티는 몰은 API까지 가지 않아도 됩니다.
- 토큰·일괄 호출은 스킨이 아니라 별도 서버에서 처리합니다.
- 상품 정보(이름·가격)와 재고 수량·품절은 API 범위가 다를 수 있습니다.
- 호출 제한(레이트리밋)이 있어 한 번에 전량을 때리면 막힐 수 있습니다.
- 테스트몰에서 샘플 건수로 검수한 뒤 실몰에 적용하는 순서가 안전합니다.
관리자·앱으로 어디까지이고, API 일괄 수정은 어떻게 하나
카페24 기본으로 가능한 범위는 관리자에서 상품 등록·수정, 엑셀 형식으로 일괄 등록·수정, 재고·품절을 화면에서 고치는 것입니다. 상품 수가 많지 않고 가끔만 맞추면 이쪽으로 충분한 몰이 많습니다. 반복이 잦고 외부 ERP·창고 숫자와 맞춰야 하면 API·자동화를 검토하게 됩니다.
앱스토어에는 대량 등록·재고 연동·ERP 연동 관련 앱이 있습니다. 우리 상품 구조(옵션 조합, 세트, 예약판매)와 맞는지, 앱이 ‘표시용’인지 카페24 본 데이터를 바꾸는지 설치 전에 확인해야 합니다. 앱 DB만 바뀌고 관리자와 어긋나면 같은 CS가 남을 수 있습니다.
API로 일괄 수정하려면 흐름은 보통 네 단계입니다. 첫째, OAuth로 상품·재고에 필요한 권한(스코프)만 열고 토큰을 서버에 둡니다. 둘째, 바꿀 대상 목록을 외부 ERP·엑셀·DB에서 가져와 카페24 상품번호·옵션 식별자와 매핑합니다. 셋째, 건수를 나눠 상품 수정 API·재고 수정 API를 호출하고, 응답·실패를 로그에 남깁니다. 넷째, 샘플 상품을 관리자·상세·장바구니에서 확인한 뒤 전량을 돌립니다. 옵션이 많은 상품은 ‘상품’과 ‘옵션별 재고’를 따로 맞춰야 하고, 품절 플래그와 수량이 같이 바뀌는지 검수가 필요합니다.
상품 수정과 재고 수정을 나눠 생각해야 하는 이유
운영자가 ‘재고 일괄 수정’이라고 말해도 실무에서는 가격·상품명 변경, 옵션 조합 추가, 수량·품절만 바꾸기가 섞입니다. API도 항목마다 다릅니다. 재고만 ERP와 맞추면 되는지, 신규 상품 등록까지 포함하는지 먼저 나누면 범위와 견적이 덜 흔들립니다. 옵션 조합이 수백 개인 상품은 관리자에서도 부담이 크므로, 1차는 인기 품목·대표 옵션만 API로 맞추는 식으로 자르는 몰도 많습니다.
핵심 체크리스트
대량 상품·재고 API 연동을 상담·개발하기 전에 아래로 표시해 보세요. ‘예’가 많으면 엑셀·수작업만으로는 부족한 경우가 많습니다.
- 수정 대상이 상품 정보·옵션·재고·품절 중 무엇인지 구분했는가
- 외부(ERP·창고·엑셀)와 카페24 상품·옵션 식별자 매핑표가 있는가
- 하루·한 번에 몇 건을 맞춰야 하는지 대략 규모를 적었는가
- 호출 제한을 넘지 않도록 나눠 보낼 배치 크기를 정했는가
- 실패 건을 로그에 남기고 재시도·수동 처리할 담당이 있는가
- 테스트몰에서 샘플 상품으로 상세·재고·품절을 확인할 계획이 있는가
- 동시에 사람이 관리자에서 같은 상품을 고치지 않도록 일정을 나눴는가
- 토큰·시크릿을 스킨·브라우저가 아니라 서버에 둘 수 있는가
- 1차는 재고·품절만, 상품 등록·가격은 2차로 나눌 수 있는가
- 옵션 조합이 많은 상품은 별도 등록·동기화 전략이 있는가
제한·대안, 그리고 맞출 때 자주 막히는 지점
제한은 분명합니다. API 호출에는 제한이 있어, 수천 건을 짧은 시간에 연속 호출하면 막히거나 느려질 수 있습니다. 상품·옵션 구조가 복잡하면 한 번의 호출로 끝나지 않고, 상세 조회 후 수정이 이어질 수 있습니다. 같은 상품을 API와 사람이 동시에 고치면 숫자가 어긋납니다. 웹훅·재고 연동과 겹치면 같은 재고를 두 번 반영할 위험이 있어, 출처·처리 여부를 서버에 남기는 편이 안전합니다.
대안은 단계로 나눕니다. 가끔만 맞추면 관리자 엑셀·앱으로 1차를 여는 몰도 많습니다. 실시간이 꼭 필요하지 않으면 하루 1~2회 배치만으로 CS가 줄어듭니다. 재고만 외부와 맞추면 되고 상품 등록은 드물면, 1차는 재고 API만 열고 신규 상품은 관리자·엑셀로 두는 식이 일정에 유리합니다. 주문 API 개요 글은 ‘주문 가져오기’에 초점이 있고, 이번 글은 ‘상품·재고 쓰기’에 가깝습니다.
실무에서 이런 문제가 발생할 수 있습니다
ERP에서는 0인데 쇼핑몰에는 남아 주문이 들어가는 경우, API로 재고를 맞춘 뒤에도 관리자에서 수동으로 덮어쓴 적이 있거나, 옵션 단위 매핑이 빠진 경우가 많습니다. 이런 요구라면 샘플 SKU 몇 개로 ERP·관리자·상세 수량을 같이 보는 검수를 먼저 하고, 전량 배치는 그다음에 돌리는 편이 사고를 줄입니다.
세일 직전에 가격·재고를 한꺼번에 API로 넣다가 중간에 실패하면, 일부 상품만 바뀐 상태로 노출될 수 있습니다. 이런 요구라면 피크 전에 소량 테스트를 하고, 실패 시 롤백·재실행 절차를 운영 문장으로 적어 두는 것이 좋습니다. 옵션이 많은 상품은 대량 등록 글과 맞닿아 있지만, 이번 질문은 ‘이미 있는 상품·재고를 API로 일괄 고칠 수 있나’에 초점을 둡니다.
카페24 API로 상품·재고를 대량 수정할 수 있나요
가능합니다. 다만 관리자 엑셀과 같은 단일 기능이 아니라, 권한·매핑·배치·로그를 포함한 연동으로 봐야 합니다. 규모와 반복 빈도에 따라 API가 꼭 필요한지부터 판단하세요.
관리자 엑셀만으로도 충분한가요
가끔·소량이면 충분한 경우가 많습니다. ERP와 매일 맞추거나 건수가 많으면 API·앱·자동화를 검토합니다. 먼저 엑셀로 막히는 지점(시간·오류·매핑)을 적어 보세요.
브라우저·스킨에서 API를 직접 호출해도 되나요
되지 않습니다. 토큰이 노출되고 호출 제한·보안 문제가 생깁니다. 일괄 수정은 별도 서버에서 처리합니다.
재고만 바꾸면 되는데 상품 API까지 필요한가요
재고·품절만이면 재고 관련 API 범위로 줄일 수 있습니다. 신규 상품·가격·옵션 추가가 섞이면 상품 API까지 범위가 넓어집니다. 수정 항목을 먼저 나누세요.
한 번에 전 상품을 돌려도 되나요
호출 제한과 검수 때문에 나눠 돌리는 편이 안전합니다. 샘플→부분→전량 순서로 열고, 실패 로그를 보며 재시도합니다.
테스트몰 없이 실몰에 바로 적용해도 되나요
가능하면 테스트몰·소량 샘플로 먼저 확인합니다. 가격·품절·옵션 표시가 어긋나면 바로 CS로 이어집니다.
옴니어스24가 대량 상품·재고 API 문의를 나누는 방식
옴니어스24는 ‘API로 일괄 수정해 주세요’만 듣고 바로 전면 연동을 받지 않습니다. 상품 정보인지 재고만인지, 하루 몇 건인지, ERP가 정답인지, 옵션 구조가 복잡한지를 먼저 나눕니다. 엑셀·앱으로 되면 그쪽을 쓰고, API가 필요하면 배치 크기·로그·테스트 순서를 같이 정합니다.
자료가 없어도 ‘맞춰야 하는 항목’과 외부 파일 열 이름, 문제 난 상품 예시 몇 건만 있으면 방향이 보입니다. 주문 API·별도 서버가 왜 따라오는지는 관련 글에서 이어서 볼 수 있고, 문의에 수정 대상(가격·재고·품절)과 대략 건수만 남겨 주셔도 1차 범위를 안내해 드립니다.
대량 상품·재고 API 다음에 보면 좋은 글·페이지
API 인증·별도 서버가 왜 필요한지는 API·별도 서버 글에서, 주문 데이터를 가져오는 흐름은 주문 API 개요에서 이어서 볼 수 있습니다. 온오프 재고 맞추기, 옵션 조합이 많을 때의 한계, 상세 재고 표시는 각각 관련 글과 연결됩니다.
FAQ·서비스·진행 방식에서 범위를 더 볼 수 있고, 문의에 ‘엑셀·ERP에서 맞추는 항목’과 하루 대략 건수만 남겨 주셔도 됩니다. API가 꼭 필요한지·1차에 재고만 할지부터 같이 정리해 드립니다.