Styxis
Company
Knowledge

Shopify 입고 취소 수량: received 합계와 실제 재고 구별

새 입고 상태를 시험할 때 received를 물리적으로 도착한 수량으로 읽지 않도록 상태별 합계를 분리해야 한다.

Shopify 입고 취소 수량: received 합계와 실제 재고 구별

입고 처리의 received라는 이름이 실제 도착하거나 판매할 수 있는 재고만 뜻한다고 가정하면 상태 추가 때 합계가 달라질 수 있다. 취소를 별도 수량으로 기록하는 계약에서는 처리 완료와 물리적 이동을 구별해야 한다. API 버전과 상태별 수량을 함께 보관해야 전환 전후의 숫자를 설명할 수 있다. [1, 2, 3]

공개 원문이 보여 준 범위

Shopify는 inventory shipments에 CANCELED 수신 행동과 취소 수량 필드를 추가하면서 received 합계에 accepted·rejected·canceled를 포함한다고 공지했다. 이전 버전 webhook은 취소만 바뀐 수신을 알리지 않는다. 이 변경의 API 기준은 2026-10이다. [1]

입력과 출력에서 확인할 관계

수락·거절·취소를 섞은 시험 입고를 준비하고 API 버전별 received 합계와 webhook 전달 범위를 함께 기록한다. api_version, accepted, rejected, canceled, total_received를 대사해야 처리 완료 수량을 모두 판매 가능 재고로 잘못 해석하지 않는다. 버전 전환 구간은 webhook과 조회 보완 경로를 나누어 확인한다. [1, 3]

승인 기준과 실패 사례

설명용 입고는 수락 7개, 거절 1개, 취소 2개로 처리 합계가 10개다. 취소 수량을 빼고 8개로 보고하면 새 received 정의와 맞지 않는다. 합계 10이 통과한다는 것은 모든 수량이 물리적으로 도착했다는 주장이 아니다. 상태별 수량을 보존해야 수신 처리와 판매 가능 재고의 의미를 분리할 수 있다. [1, 3]

Truthound를 연결하는 검사 경계

Truthound Core 3.3.2의 ExpressionValidator는 준비한 상태별 수량 표에서 total_received와 구성 합계의 관계를 검사할 수 있다. filter_expr에 업무 정의를 명시하고 webhook 구독 버전도 함께 보존한다. 재고 이동이나 입고 취소를 수행하는 기능으로 설명하지 않는다. [1, 2, 3]

다른 선택이 필요한 조건

received 합계가 물리 도착·판매 가능 재고를 의미하지 않으며 구버전 webhook 무전달을 자동 수집 실패로 볼 수 없다. 상태별 수량을 보존하고 버전 전환 전후 webhook과 조회 보완 경로를 분리한다. 이전 API 버전만 사용하고 취소 행동을 사용하지 않으면 새 상태 합계를 적용하지 않는다. [1, 3]

적용 조건

api_version, accepted, rejected, canceled, total_received 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.

대안

상태별 수량을 보존하고 버전 전환 전후 webhook과 조회 보완 경로를 분리한다.

한계

  • received 합계가 물리 도착·판매 가능 재고를 의미하지 않으며 구버전 webhook 무전달을 자동 수집 실패로 볼 수 없다.

근거

사건 확인일
대상 확인일
수정일