Blog

카페24 온라인 재고와 오프라인 매장 재고를 거의 실시간으로 연동하는 방법

카페24 온라인 재고와 오프라인 매장 재고는 API·웹훅·별도 서버를 이용하면 거의 실시간으로 연동할 수 있습니다.

다만 완전한 동시 일치보다 상품·옵션 매핑, 안전 재고, 충돌 처리와 실패 재처리 규칙을 함께 설계하는 것이 중요합니다.

정보성 글수정 2026.09.16
  • 카페24
  • 재고
  • 오프라인
  • 연동

카페24 쇼핑몰과 오프라인 매장을 함께 운영한다면 온라인 재고와 매장 재고를 얼마나 빠르게 맞출 수 있는지가 중요한 문제가 됩니다.

매장에서 상품이 판매됐는데 온라인몰에는 재고가 그대로 남아 있거나, 온라인에서 품절된 상품이 매장에는 남아 있는 것처럼 표시되는 상황이 생길 수 있습니다.

특히 매장 판매량과 온라인 주문량이 많은 쇼핑몰에서는 엑셀로 하루에 한두 번 재고를 맞추는 방식만으로는 관리가 어려워질 수 있습니다.

카페24 재고와 오프라인 매장 재고를 거의 실시간으로 맞출 수 있나요?

가능합니다.

다만 카페24 관리자에서 재고를 관리하는 것만으로 오프라인 매장의 POS 재고까지 자동으로 맞춰지는 것은 아닙니다.

일반적으로 다음과 같은 구조로 연동합니다.

온라인몰 또는 매장 판매 발생 → 재고 변경 확인 → 연동 서버 → 반대쪽 재고 반영

카페24와 오프라인 POS가 각각 제공하는 API, 웹훅 또는 데이터 연동 방식을 이용하고, 중간에 별도 서버를 두어 두 시스템의 재고를 맞추는 방식입니다.

다만 여기서 말하는 ‘거의 실시간’은 두 시스템의 숫자가 항상 같은 순간에 바뀐다는 의미는 아닙니다.

네트워크 지연이나 동시에 발생한 주문 때문에 짧은 시간 동안 수량 차이가 발생할 수 있기 때문에, 실제 개발에서는 재고 지연 시간과 과매 방지 규칙을 함께 설계하는 것이 중요합니다.

왜 온라인과 오프라인 재고가 자주 달라질까요?

예를 들어 쇼핑몰에 특정 상품이 5개 있다고 가정해 보겠습니다.

오프라인 매장에서 2개가 판매되면 실제 남은 수량은 3개입니다.

하지만 매장 판매 정보가 카페24에 전달되지 않는다면 온라인몰에서는 계속 재고 5개로 표시될 수 있습니다.

반대로 온라인에서 3개가 주문됐는데 매장 재고에 반영되지 않는다면 매장에서는 실제 수량과 다른 재고를 확인하게 됩니다.

문제는 판매가 발생할 때마다 반복됩니다.

  • 매장에서 판매됐지만 온라인 재고가 줄지 않음
  • 온라인에서 주문됐지만 매장 재고가 줄지 않음
  • 품절 상품이 다른 판매 채널에 계속 노출됨
  • 엑셀로 수량을 맞추다가 일부 상품이 누락됨
  • 주말이나 프로모션 기간에 주문이 몰리면서 과판매 발생
  • 같은 상품의 옵션별 수량이 서로 다르게 관리됨

따라서 단순히 재고 숫자를 한 번 맞추는 것보다 판매가 발생할 때마다 재고가 자동으로 반영되는 구조를 만드는 것이 중요합니다.

카페24 기본 기능만으로 오프라인 재고와 연동할 수 있나요?

카페24 기본 관리자에서는 쇼핑몰 상품의 재고와 품절 상태를 관리할 수 있습니다.

하지만 이것만으로 외부 매장의 POS 재고와 자동으로 거의 실시간 동기화하는 것은 어렵습니다.

관리자가 매장 POS의 재고를 확인한 뒤 카페24 관리자에서 직접 수량을 수정한다면 재고를 맞출 수는 있습니다.

하지만 이것은 자동 연동이라기보다 수작업에 가깝습니다.

매장 판매가 하루에 몇 건 발생하지 않는 소규모 쇼핑몰이라면 수작업으로도 관리할 수 있지만, 판매량이 많아지면 관리 부담이 커집니다.

재고 연동 앱을 사용하면 해결할 수 있나요?

경우에 따라 가능합니다.

카페24 앱스토어에는 재고나 외부 시스템 연동을 지원하는 앱이 있을 수 있습니다.

하지만 중요한 것은 우리 쇼핑몰의 POS와 실제 재고 구조가 앱에서 지원되는지 확인하는 것입니다.

예를 들어 다음과 같은 차이가 있을 수 있습니다.

  • POS 상품 코드와 카페24 상품 코드가 다름
  • POS에는 바코드가 있지만 카페24에는 별도 옵션 코드가 있음
  • 하나의 상품에 여러 옵션이 존재함
  • 매장별로 재고를 따로 관리함
  • 온라인과 오프라인의 재고 기준이 다름
  • 세트상품과 단품상품의 재고 계산 방식이 다름

따라서 앱을 설치하기 전에 카페24 상품·옵션 코드와 POS의 상품·바코드를 서로 연결할 수 있는지부터 확인하는 것이 좋습니다.

구조가 단순하다면 앱이나 배치 방식만으로도 충분할 수 있습니다.

거의 실시간 재고 연동은 어떻게 개발하나요?

재고를 거의 실시간으로 맞춰야 한다면 보통 카페24 API + 웹훅 + 별도 서버를 이용합니다.

전체적인 구조는 다음과 같습니다.

1. 카페24와 POS의 상품을 연결합니다.

먼저 같은 상품이라는 것을 시스템이 알아볼 수 있도록 연결 정보를 만듭니다.

예를 들어 다음과 같은 정보를 관리할 수 있습니다.

카페24오프라인 매장
상품코드POS 상품코드
옵션코드바코드
옵션명매장 SKU
쇼핑몰매장코드

이 연결 정보가 정확하지 않으면 재고 동기화도 정확하게 이루어지기 어렵습니다.

2. 재고 변경을 확인합니다.

온라인 주문이나 취소 등으로 카페24 재고가 변경되면 API나 웹훅 등을 이용해 변경 내용을 확인합니다.

반대로 오프라인 매장에서 상품이 판매되었을 때 POS에서 외부 시스템으로 판매 정보를 전달할 수 있다면 매장 판매도 연동할 수 있습니다.

3. 별도 서버에서 재고를 조정합니다.

카페24와 POS의 재고를 단순히 서로 덮어쓰는 것이 아니라 중간 서버에서 필요한 규칙을 적용합니다.

예를 들어 다음과 같은 규칙을 사용할 수 있습니다.

  • 안전 재고 2개 유지
  • 특정 매장 재고만 온라인에 노출
  • 온라인 주문 발생 시 매장 재고 차감
  • 매장 판매 발생 시 온라인 재고 차감
  • 품절 상태 자동 변경
  • 취소·반품 발생 시 재고 복구
  • 동일한 이벤트 중복 처리 방지

4. 반대쪽 시스템에 재고를 반영합니다.

매장에서 상품이 판매됐다면 카페24 재고를 줄이고, 온라인에서 주문됐다면 필요한 경우 매장 재고에도 반영합니다.

이처럼 양쪽 방향으로 데이터를 주고받는 구조를 만들 수 있습니다.

양방향 재고 연동이 항상 필요한 것은 아닙니다

처음부터 온라인과 오프라인을 모두 양방향으로 연동할 필요는 없습니다.

예를 들어 가장 문제가 되는 것이 매장에서 판매된 상품이 온라인에 계속 재고가 남아 있는 문제라면,

매장 POS → 카페24

방향만 먼저 개발할 수 있습니다.

반대로 온라인 주문 때문에 매장 재고가 계속 어긋난다면,

카페24 → 매장

방향부터 시작할 수 있습니다.

이렇게 1차에서 가장 중요한 문제 하나를 해결하고, 운영하면서 문제가 없으면 2차에서 양방향 연동으로 확대하는 방식도 가능합니다.

‘거의 실시간’과 ‘완전 실시간’은 다릅니다

웹훅이나 API를 사용한다고 해서 두 시스템의 재고가 항상 정확히 같은 순간에 변경되는 것은 아닙니다.

예를 들어 같은 상품이 온라인과 오프라인에서 거의 동시에 판매될 수 있습니다.

또한 다음과 같은 상황도 발생할 수 있습니다.

  • 네트워크 지연
  • API 응답 지연
  • 웹훅 재전송
  • 외부 POS 서버 장애
  • 연동 서버 장애
  • 동시에 발생한 주문
  • 재고 데이터 처리 순서 차이

따라서 실제 개발에서는 ‘무조건 실시간으로 정확히 일치’라는 목표보다,

판매 발생 후 일정 시간 안에 재고가 반영되도록 한다.

와 같이 운영 기준을 정하는 것이 현실적입니다.

재고 연동에서 가장 중요한 것은 과판매 방지입니다

재고가 거의 실시간으로 연동되더라도 과판매가 완전히 사라지는 것은 아닙니다.

예를 들어 재고가 1개 남은 상품을 온라인 고객과 오프라인 고객이 거의 동시에 구매할 수 있습니다.

이 경우 두 시스템이 서로의 판매 정보를 확인하기 전에 주문이 발생할 수 있습니다.

그래서 필요하다면 안전 재고를 설정할 수 있습니다.

예를 들어 실제 재고가 10개라 하더라도 온라인에는 8개만 판매 가능하도록 설정하는 방식입니다.

또는 특정 상품은 재고가 2개 이하가 되면 온라인 판매를 자동으로 중지하도록 만들 수도 있습니다.

어떤 방식이 적합한지는 상품의 판매량과 과판매 발생 시 처리 방법에 따라 달라집니다.

옵션이 많은 상품은 별도의 재고 규칙이 필요합니다

특히 의류처럼 색상과 사이즈 옵션이 많은 상품은 재고 연동이 더 복잡해질 수 있습니다.

예를 들어 온라인에는 다음과 같은 옵션이 있다고 가정해 보겠습니다.

  • 블랙 / S
  • 블랙 / M
  • 블랙 / L
  • 화이트 / S
  • 화이트 / M
  • 화이트 / L

그런데 POS에서는 이 상품을 하나의 상품코드로만 관리한다면 카페24의 옵션별 재고와 POS 재고를 어떻게 연결할 것인지 먼저 정해야 합니다.

따라서 개발 전에 다음을 확인해야 합니다.

카페24 옵션 1개 = POS 상품 1개인지

또는

여러 카페24 옵션이 하나의 POS 상품 재고를 공유하는지

이 기준이 정해지지 않으면 API를 연결해도 재고 숫자가 계속 달라질 수 있습니다.

매장이 여러 곳이라면 매장별 재고도 확인해야 합니다

오프라인 매장이 여러 곳이라면 단순히 전체 재고만 맞출 것인지, 매장별 재고까지 관리할 것인지 결정해야 합니다.

예를 들어 매장 A에 5개, 매장 B에 3개가 있다면 온라인몰에 총 8개를 판매할 수도 있습니다.

반대로 매장별 재고를 따로 관리하면서 특정 매장의 상품만 온라인 판매에 사용하는 구조도 가능합니다.

또한 향후에는 다음과 같은 기능으로 확장할 수도 있습니다.

  • 매장별 재고 조회
  • 가까운 매장 재고 확인
  • 매장 픽업 가능 여부 표시
  • 매장별 판매량 확인
  • 특정 매장 재고의 온라인 판매 제한
  • 물류센터와 매장 재고 통합 관리

따라서 처음부터 필요한 범위를 명확하게 정하는 것이 좋습니다.

재고 연동을 시작하기 전에 확인해야 할 것

다음 항목을 먼저 확인하면 개발 범위를 정하기가 훨씬 쉬워집니다.

  • 카페24 상품코드와 POS 상품코드를 연결할 수 있는가?
  • 옵션별 SKU 또는 바코드가 존재하는가?
  • 매장이 한 곳인가, 여러 곳인가?
  • 매장별 재고를 따로 관리해야 하는가?
  • 사용하는 POS에서 외부 API를 제공하는가?
  • 온라인과 오프라인 중 어느 재고를 기준으로 할 것인가?
  • 온라인 판매용 안전 재고를 둘 것인가?
  • 주문 취소·반품 시 재고를 어떻게 복구할 것인가?
  • 세트상품은 어떤 방식으로 재고를 계산할 것인가?
  • 예약판매 상품도 연동해야 하는가?
  • 재고 연동에 실패했을 때 다시 처리할 방법이 있는가?
  • 처음부터 양방향으로 개발해야 하는가?

특히 POS에서 API를 제공하는지 여부는 개발 방법과 비용에 큰 영향을 줄 수 있습니다.

POS API가 없다면 어떻게 하나요?

POS에서 API를 제공하지 않는다고 해서 반드시 연동이 불가능한 것은 아닙니다.

상황에 따라 다음과 같은 방법을 검토할 수 있습니다.

하루에 몇 번씩 파일로 연동

POS에서 CSV나 엑셀 파일을 생성할 수 있다면 일정한 주기로 파일을 받아 카페24 재고를 변경할 수 있습니다.

중간 재고 시스템 사용

POS와 카페24 사이에 별도의 재고 DB를 두고 이곳에서 재고를 관리하는 방법도 있습니다.

반자동 방식

POS에서 판매 데이터를 내려받아 관리자가 확인한 후 카페24에 자동 반영하는 방식도 가능합니다.

따라서 ‘완전 실시간이 아니면 의미가 없다’고 생각할 필요는 없습니다.

10~30분 단위나 하루 여러 번의 자동 반영만으로도 기존 엑셀 수작업보다 관리 부담을 크게 줄일 수 있는 경우가 있습니다.

처음부터 모든 기능을 개발할 필요는 없습니다

재고 연동은 범위를 크게 잡으면 개발 비용과 테스트 기간이 빠르게 증가합니다.

그래서 다음처럼 단계적으로 개발할 수 있습니다.

1단계

  • 핵심 상품만 연동
  • 상품·옵션 코드 매핑
  • 매장 판매 → 온라인 재고 반영
  • 온라인 주문 → 재고 반영
  • 기본 로그 관리

2단계

  • 양방향 재고 연동
  • 여러 매장 관리
  • 안전 재고
  • 자동 품절
  • 실패 자동 재처리
  • 취소·반품 재고 복구

3단계

  • ERP/WMS 연동
  • 매장별 재고 조회
  • 매장 픽업
  • 판매량 분석
  • 복잡한 세트상품 재고 관리

처음부터 모든 기능을 넣기보다 현재 가장 많이 발생하는 재고 문제부터 해결하는 방식이 실제 운영에는 더 적합할 수 있습니다.

이런 쇼핑몰이라면 재고 자동 연동을 검토할 필요가 있습니다

다음과 같은 상황이라면 카페24 기본 재고 관리보다 자동 연동을 검토할 수 있습니다.

  • 오프라인 매장과 온라인몰을 동시에 운영하고 있음
  • 매장에서 판매될 때마다 온라인 재고를 수정하고 있음
  • 엑셀로 하루 여러 번 재고를 맞추고 있음
  • 온라인과 매장의 재고 차이로 CS가 발생함
  • 매장이 여러 곳임
  • POS와 카페24의 상품코드가 연결되어 있음
  • 프로모션 기간에 과판매가 자주 발생함
  • 온라인 주문량이 많아 수작업 관리가 어려움

반대로 매장 판매량이 적고 재고 변경도 많지 않다면 앱이나 수동 관리만으로도 충분할 수 있습니다.

카페24 재고 연동은 어떻게 개발하나요?

옴니어스24에서는 먼저 ‘실시간으로 재고를 맞춰 달라’는 요구를 그대로 개발 범위로 잡지 않습니다.

현재 어떤 부분에서 재고가 어긋나는지부터 확인합니다.

예를 들어 다음과 같은 내용을 확인합니다.

1. 카페24와 오프라인 매장에서 각각 어떤 상품코드를 사용하는지

2. 옵션과 바코드를 어떻게 연결할 수 있는지

3. 매장이 몇 곳인지

4. POS가 외부 API를 제공하는지

5. 어느 방향의 재고 연동이 필요한지

6. 완전 실시간이 필요한지

7. 일정 주기의 자동 반영으로 충분한지

8. 과판매를 어느 수준까지 줄여야 하는지

그 결과에 따라 카페24 기본 기능, 앱, 배치 연동, API 연동, 웹훅, 별도 서버 중 필요한 방식을 선택합니다.

단순한 문제라면 복잡한 시스템을 만들 필요가 없고, 여러 매장과 POS를 연결해야 한다면 별도의 재고 연동 서버를 구성하는 방식으로 범위를 확장할 수 있습니다.

FAQ

카페24 재고와 오프라인 매장 재고를 실시간으로 맞출 수 있나요?

가능합니다. 다만 카페24 기본 기능만으로는 어렵고, POS가 제공하는 API와 카페24 API·웹훅 등을 연결하는 별도 연동 구조가 필요할 수 있습니다.

웹훅을 사용하면 완전히 실시간인가요?

웹훅은 재고 변경을 빠르게 전달하는 데 사용할 수 있지만 완전히 동시에 변경된다고 보기는 어렵습니다. 네트워크 지연이나 중복 이벤트, 오류에 대비한 검증과 재처리 구조가 필요합니다.

재고 연동 앱만 설치하면 되나요?

POS와 카페24의 상품코드·옵션·재고 구조가 앱에서 지원된다면 가능합니다. 그렇지 않다면 별도의 API 연동이나 서버 개발이 필요할 수 있습니다.

양방향 재고 연동이 꼭 필요한가요?

꼭 그렇지는 않습니다. 가장 문제가 되는 방향부터 단방향으로 연동한 뒤 안정적으로 운영되면 양방향으로 확대할 수 있습니다.

매장이 여러 곳이면 매장별 재고도 연동할 수 있나요?

가능합니다. 다만 매장코드와 상품·옵션 정보를 연결하고, 온라인에서 전체 재고를 사용할지 특정 매장 재고만 사용할지 먼저 정해야 합니다.

재고 연동을 하면 과판매가 완전히 없어지나요?

완전히 없어진다고 보기는 어렵습니다. 온라인과 오프라인에서 거의 동시에 판매되는 상황이 있을 수 있기 때문에 안전 재고, 판매 제한 등의 추가 규칙을 함께 적용하는 것이 좋습니다.

POS에서 API를 제공하지 않으면 연동할 수 없나요?

반드시 그렇지는 않습니다. CSV·엑셀 파일, 정기 배치, 중간 DB 등을 이용한 반자동 또는 주기적 연동 방법을 검토할 수 있습니다.

카페24와 POS 연동을 처음부터 모두 개발해야 하나요?

아닙니다. 핵심 상품과 가장 문제가 되는 재고 방향부터 1차로 개발하고, 이후 매장 확대·양방향 연동·ERP/WMS 연동 등으로 확장할 수 있습니다.

카페24 커스텀, 상담부터 시작해 보세요

가능 여부와 대략 범위만 먼저 여쭤보셔도 됩니다. 문의 페이지에서 편하게 남겨 주세요.