아키텍처ShopifySaaSCommerceGraphQLProductInventoryCheckout

Shopify 아키텍처

구매자 접점, 상품·재고·주문 관리, 외부 연동이 연결되는 커머스 플랫폼 구조

시각화 로드 중...

개요

Architecture Overview

Shopify는 구매자가 상품을 발견하고 결제하는 화면과 판매자가 상품·재고·주문을 관리하는 기능을 제공하는 SaaS 커머스 플랫폼입니다. 구조도는 개발자가 공개 데이터 모델과 API에서 확인할 수 있는 기능 경계를 보여줍니다.

구매자 접점과 판매 채널

Storefront는 구매자가 상품을 보는 채널입니다. Shopify 테마를 사용하면 온라인 스토어에서 상품을 표시할 수 있습니다. 자체 웹·모바일 화면을 만들 때는 Storefront GraphQL API로 채널에 공개된 상품과 컬렉션을 조회하고 카트를 관리합니다. Hydrogen은 이런 Headless 스토어를 개발하는 Shopify의 React 프레임워크입니다.

CartLine은 구매할 ProductVariant와 수량을 담습니다. 카트의 예상 비용은 배송, 할인, 세금이 반영되는 시점에 달라질 수 있습니다. Headless 채널에서 구매자가 결제할 준비가 되면 Cart의 checkoutUrl로 Shopify Checkout에 연결합니다. 배송 정보와 결제 수단은 Shopify Checkout에서 확정합니다.

상품 옵션과 위치별 재고

Product에는 상품명과 설명처럼 옵션에 공통인 정보를 둡니다. ProductVariant는 티셔츠의 ‘블랙 / M’처럼 실제 구매할 수 있는 옵션 조합입니다. Variant는 가격을 담고 InventoryItem을 참조합니다. 상품을 처음 등록하는 productCreate와 여러 옵션을 추가하는 productVariantsBulkCreate는 역할이 다릅니다. 상품별 소재나 규격처럼 별도로 관리할 속성은 Metafield로 표현할 수 있습니다.

InventoryLevel은 InventoryItem 하나와 Location 하나를 연결하고, 판매 가능 수량이나 주문에 할당된 수량 같은 재고 상태를 보관합니다. 예를 들어 ‘블랙 / M’의 판매 가능 수량이 서울 창고에 7개, 부산 창고에 3개라면 해당 InventoryItem에 연결된 두 위치의 InventoryLevel을 각각 조회합니다. 주문이 어느 위치에서 이행될지는 주문 쪽 FulfillmentOrder에서 확인합니다.

주문과 출고의 책임

Order는 구매 품목과 금액 등 거래 정보를 담습니다. FulfillmentOrder는 주문 품목 중 특정 위치에서 처리할 작업을 묶고, Fulfillment는 실제 진행 중이거나 완료된 이행을 기록합니다. 한 주문에 여러 FulfillmentOrder가 연결될 수 있습니다. 예를 들어 서울 창고와 부산 창고에서 나누어 보내면 배송 상태는 이행 단위로 추적하고, 환불은 Refund로 별도 관리합니다.

앱이 커머스 기능에 연결되는 방식

  • 운영 데이터 접근 — 앱은 GraphQL Admin API로 상품·재고·주문을 조회하거나 변경합니다. 주문과 이행 데이터처럼 별도 권한이 필요한 영역에서는 앱의 접근 범위와 필요한 스코프를 확인합니다.

  • 체크아웃 확장 — Checkout UI Extensions는 지정된 화면 위치에 UI를 추가합니다. Shopify Functions는 할인 계산 등 Shopify가 제공하는 지점에 로직을 적용합니다. 사용 가능한 지점은 기능과 플랜에 따라 달라집니다.

  • 외부 시스템 동기화 — 주문이나 재고 변경을 Webhooks로 구독하고 ERP·WMS에 반영할 수 있습니다. HTTPS 수신 시 원문으로 HMAC 서명을 검증하고 전달 ID로 중복을 처리합니다. 처리 순서나 데이터 차이로 생긴 불일치는 GraphQL Admin API로 원본 상태를 다시 조회해 조정합니다.

설계 시 고려할 점

테마 기반 채널은 Shopify 온라인 스토어 기능을 사용합니다. Headless 채널을 도입하면 프론트엔드 호스팅과 운영을 별도로 맡을 수 있으므로 구매 경험의 자유도와 운영 부담을 함께 검토합니다. 앱을 붙일 때는 결제 수단의 국가별 지원, 체크아웃 확장의 플랜 조건, API 버전과 호출 한도를 확인합니다.

핵심 정리

  • Storefront, Cart, Checkout은 구매자 접점이고 Catalog, Inventory, Orders는 판매 운영 기능입니다. Storefront의 상품 조회와 Checkout의 주문 생성이 두 영역을 연결합니다.
  • ProductVariant의 재고는 InventoryItem을 통해 Location별 InventoryLevel로 확인합니다. 주문의 출고 위치는 FulfillmentOrder에 연결됩니다.
  • 앱은 GraphQL Admin API로 운영 데이터를 다루고, Checkout UI Extensions와 Functions로 체크아웃을 확장하며, Webhooks로 변경을 구독합니다.

국내·해외 활용 사례

공개된 사례를 기준으로 확인한 사용처입니다. 한국 브랜드의 해외몰과 국내 운영 사례는 구분하며, 사례 발표 이후의 도입 상태까지 보증하지 않습니다.

국내 브랜드 · 해외 운영

cepolab

한국 바이오 뷰티 브랜드의 일본 온라인몰 구축 사례입니다. Shopify 테마, Metafields와 Shopify Forms로 상품 정보 및 고객 접점을 구성했습니다.

1mm · cepolab Shopify 일본몰 구축 사례 (2026-05-14)

출처 확인일: 2026-11-06

국내 브랜드 · 글로벌 운영

Biodance

한국 K-뷰티 브랜드의 글로벌 Shopify 스토어 구축 사례입니다. 제품 상세 페이지, Shoppable 영상, Shopify 앱 기반 상품 노출을 이용해 글로벌 구매자를 위한 D2C 접점을 구축했습니다.

Disrupt · Biodance 글로벌 Shopify 구축 사례

출처 확인일: 2026-11-06

해외 · 글로벌

Allbirds

온라인 스토어와 Shopify POS를 통합하고, 매장에서 온라인 주문을 발송하는 Ship from Store를 활용해 재고 활용 및 이행 방식을 확장했습니다.

Shopify · Allbirds 공식 고객 사례

출처 확인일: 2026-11-06

핵심 개념 및 실무 적용 분야

✓D2C 브랜드에서 상품 옵션과 가격은 Catalog에서 관리하고, 테마 스토어에서는 판매 채널에 게시된 상품을 노출합니다.
✓자체 모바일 스토어에서는 Storefront API로 상품 조회와 카트를 구현하고, 결제는 카트 URL을 통해 Shopify Checkout에 연결합니다.
✓창고와 매장이 함께 판매하는 경우 InventoryLevel로 위치별 수량을 파악하고 FulfillmentOrder로 주문 품목의 배정 위치를 확인합니다.
✓ERP·WMS 연동에서는 웹훅으로 주문 변경을 감지하고, 누락이나 불일치가 생기면 GraphQL Admin API의 주문 상태와 대조합니다.

참고 자료

개념과 기술 규격을 추가로 확인할 수 있는 외부 자료입니다. 구조도는 공개 자료에서 확인할 수 있는 기능과 관계를 중심으로 구성했습니다.