SCM 재고 합계 검수보유재고 판매가능재고 차이Shopify on_hand available 중복 합산재고 상태별 수량 대사

SCM 재고 합계 검수, 판매 가능 수량을 다시 더하지 않으려면

SCM 재고 합계는 상위 합계와 하위 상태의 포함 관계부터 확인합니다. Shopify 공식 정의와 가상 검수표로 보유·판매 가능·입고 예정 수량, 미조회·중복 행의 대사 기준을 정리합니다.

이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스

발행 ·알파카랩스

SCM 재고 합계는 상위 합계와 하위 상태를 함께 더하면 부풀어집니다. 2026-11-20 확인 기준, 미조회 상태는 0으로 채우지 않습니다.

원천 화면에는 보유재고 10개, 판매 가능 6개가 있는데 통합 화면의 총재고는 16개라면 연동 건수보다 산식부터 확인해야 합니다. 판매 가능 수량이 보유재고의 일부라면 같은 물건을 다시 센 결과입니다. 이 수량과 아래 오류 상황은 모두 설명용 가상 예시입니다.

이 글은 통합 조회 화면을 인수할 때 쓸 수량 정의·대사 기준을 다룹니다. Shopify 공식 문서를 제품별 상태 관계의 공개 예시로 사용하며, 특정 고객의 제품 채택이나 실제 장애 사례를 뜻하지 않습니다.

보유재고와 판매 가능 수량은 왜 더하면 안 되나요?#

보유재고가 하위 상태를 이미 포함한다면 판매 가능 수량을 다시 더할 수 없습니다. 먼저 원천의 상위 합계와 구성 상태를 나누고, 같은 상품·위치·기준 시점에서 비교해야 합니다. 다른 제품의 같은 이름이 같은 산식을 뜻하는지는 별도로 확인합니다.

Shopify 재고 상태 공식 안내는 on_hand를 available, committed, reserved, damaged, safety_stock, quality_control의 합으로 설명합니다. incoming은 아직 해당 위치에 도착하지 않은 수량입니다. 따라서 이 정의에서 보유재고, 판매 가능, 입고 예정을 하나의 총재고로 더하면 포함 관계와 도착 여부가 섞입니다.

화면 카드도 보유·판매 가능·입고 예정을 각각 둡니다. 보류 수량을 별도 표시한다면 어떤 하위 상태를 묶었는지 적습니다. Shopify 수량 조회·상태 관리 안내는 reserved, damaged, safety_stock, quality_control이 관리자 화면에서 Unavailable로 표시된다고 설명합니다. 이 묶음과 개별 상태를 동시에 합계에 더하지 않습니다.

인수표에는 카드 이름, 원천 필드, 구성 상태, 단위, 상품·위치 식별자, 기준 시점, 누락 처리, 기대 수량을 적습니다. InventoryLevel 공식 참조는 한 상품의 재고 항목과 한 위치를 연결하고 quantities(names:)로 상태별 수량을 조회합니다. 필요한 상태를 무엇으로 요청했는지까지 확인해야 합계의 의미를 설명할 수 있습니다.

어떤 표본으로 합계 오류를 판정하나요?#

정상 수량뿐 아니라 중복 합산·미조회·중복 행을 함께 대조합니다. 아래 표는 모든 상태가 같은 단위·확인 시점의 표본이라는 가정에서 만든 설계 예시입니다. 통과·보류는 이 글의 인수 정책이며 Shopify API의 오류 코드가 아닙니다.

가상 상품 A·위치 L1은 보유 10, 판매 가능 6, 확정 배정 2, 별도 예약 1, 파손 1, 안전재고 0, 품질검사 0, 입고 예정 5입니다. 보유 10의 구성은 6+2+1+1+0+0이며 입고 예정 5는 밖에 둡니다. 다음 JSON은 이 예시를 줄여 적은 내부 대사 형식으로, 실제 API 응답 형식이 아닙니다.

{
  "item": "A",
  "location": "L1",
  "unit": "ea",
  "quantities": {
    "on_hand": 10,
    "available": 6,
    "committed": 2,
    "reserved": 1,
    "damaged": 1,
    "safety_stock": 0,
    "quality_control": 0,
    "incoming": 5
  },
  "display": { "on_hand": 10, "available": 6, "incoming": 5 }
}
가상 입력·화면대조할 수량·조건인수 판정 예시
L1의 상태와 카드 일치보유 10, 판매 가능 6, 입고 예정 5통과: 세 수량 분리
보유에 판매 가능을 더함총재고 16 표시보류: 10 안의 6 중복
판매 가능에 입고 예정을 더함판매 가능 11 표시보류: 미도착 5 혼합
quality_control 미조회나머지 값만으로 합계 대조보류: 미조회를 0으로 채우지 않음
모든 상태가 명시적으로 0보유·판매 가능·입고 예정 0통과: 조회된 0 보존
같은 상품·위치 행이 두 번 수집됨L1 10개가 두 행에 존재보류: 중복 범위 확인
별도 위치 L2를 함께 조회L2 보유 4, 판매 가능 3, 입고 예정 0통과: 두 위치 합계 14·9·5
보유 11, 구성 상태의 합은 10동일 표본의 수량 불일치보류: 원천·수집 시점 재확인
출처: Shopify 공식 상태 정의를 바탕으로 작성한 알파카랩스 로컬 합성 검증 8조건, 2026-11-20. 실제 고객 데이터·API 호출 결과·성능 측정이 아닙니다.

미조회는 원천 값이 없다는 뜻과도 다릅니다. 요청한 상태 목록과 받은 목록부터 맞춰야 합니다. 이 예시 정책에서는 분해 합계를 확정할 상태 하나라도 빠지면 대사를 보류합니다. 조회된 보유 수량 자체는 보여 주되, 구성 대사가 끝났다고 표시하지 않습니다.

여러 위치의 합계는 동일 상품·단위·확인 범위에서 같은 상태끼리만 더합니다. 위 L2의 구성은 판매 가능 3과 확정 배정 1, 나머지 보유 구성 상태 0으로 가정했습니다. 중복 행은 조용히 버리거나 두 번 더하기 전에 상품·위치·수집 회차로 원인을 확인합니다. 다른 시점의 행을 하나로 합칠지도 인수 조건에 포함합니다.

숫자가 맞으면 통합 화면 인수를 끝내도 되나요?#

아닙니다. 합계 산식이 맞아도 조회하지 못한 위치가 있거나 시점·단위가 섞이면 화면 범위가 달라집니다. 조회 대상 위치, 갱신 시각, 마지막 성공 수집, 누락·지연 표시를 원천 표본과 함께 확인해야 합니다. 표의 상태 관계만으로 실시간 재고 일치나 주문 가능 여부를 보장할 수는 없습니다.

기존 ERP나 BI 보고서에서 필요한 상태·범위·누락 표시를 설정할 수 있다면 그 보고서와 먼저 대조할 수 있습니다. 별도 개발을 검토할 때도 원천을 수정하는 재고 동기화나 배분 기능을 조회 화면의 기본 범위로 넣지 않습니다. 알파카랩스 SCM 개발 서비스는 공개 제공 범위로 지표 정의·기준일·갱신 조건·권한·표본 대사를 설명합니다. 이 설명은 자사 제공 방식이며 모든 채널 호환이나 특정 결과의 보장은 아닙니다.

예약재고 만료와 해제 검수는 실제 점유를 언제 돌려주는지, 검사대기 재고 처리는 보류를 어떤 절차로 해제하는지 다룹니다. 이번 합계 대사는 그 실행 전이를 바꾸지 않습니다. 숫자를 조회하는 범위와 원장을 변경하는 범위를 나눠 인수하세요.

어떤 공식 문서와 판본을 기준으로 했나요?#

2026-11-20에 Shopify 재고 상태 안내·수량 관리 안내와 GraphQL Admin API InventoryLevel의 2026-10 판본 선택 표시를 확인했습니다. 참조 URL은 현재 latest 문서로 정규화됩니다. 문서의 게시·수정일은 본문에서 확인하지 못했으므로 확인일을 신규 발표일로 해석하지 않습니다.

재고 상태 정의는 합계의 포함 관계, 수량·상태 관리는 조회와 관리자 표시의 관계, InventoryLevel 참조는 상품·위치·상태별 조회 구조의 근거입니다. 합성 표의 보류 정책은 이 문서를 바탕으로 한 설계 제안입니다. 적용 제품의 판본·상태 정의가 바뀌거나 실제 원천 표본이 확보되면 다시 대조합니다.

자주 묻는 질문#

on_hand와 available을 더해도 되나요?

이 글에서 확인한 Shopify 정의에서는 available이 on_hand의 구성 상태이므로 더하지 않습니다. 다른 원천은 각 필드의 포함 관계를 먼저 확인합니다.

incoming은 판매 가능 수량인가요?

Shopify 공식 안내에서는 아직 해당 위치에 도착하지 않은 수량입니다. 보유·판매 가능과 분리하고 입고가 반영된 상태를 확인합니다.

요청하지 않은 상태는 0으로 처리하나요?

이 글의 대사 정책에서는 미조회와 조회된 0을 구분합니다. 필요한 상태가 빠지면 구성 합계의 확정을 보류하고 누락 범위를 표시합니다.

모든 위치의 보유재고를 더할 수 있나요?

같은 상품·단위·확인 범위의 같은 상태인지 확인한 뒤 집계합니다. 중복 행, 누락 위치, 다른 수집 시점이 있으면 먼저 범위를 정리합니다.

표를 통과하면 주문 가능 수량도 보장되나요?

표는 가상 조회 수량의 대사 기준입니다. 실제 주문 승인·예약·재고 동기화와 실시간 일치는 별도 범위로 검수해야 합니다.

수량 정의·대사표 초안을 정리합니다#

비식별 상품·위치·상태 표본과 현재 화면의 합계 산식을 준비하세요.

수량 정의·대사표 초안을 정리합니다

첫 범위 협의에서 비식별 상품·위치·상태 표본을 대조해 수량 정의·대사표 초안을 정리합니다. 소요 시간은 원천 접근 조건·상태·표본 범위를 확인한 뒤 안내합니다.

수량 정의·대사표 초안 협의