Shopify 재고 재활성화: 생략한 수량과 0으로 지정한 수량 구별하기
재활성화 API의 기본 동작이 바뀌면, 이전 수량을 초기화하던 업무 가정도 함께 점검해야 한다.
활성화 버튼이 수량 조정은 아니다
활성 여부와 수량은 다른 상태다. 수량 인자를 생략한 재활성화에서는 기존 수량의 보존을 인수 조건으로 삼아야 한다. 위치를 다시 사용한다는 작업을 빈 재고로 시작한다는 뜻으로 받아들이면, 화면의 활성 표시는 맞아도 담당자 사이에 서로 다른 수량을 인계하게 된다. [1, 2, 3]
2026-04에서 달라진 생략의 의미
Shopify의 2026년 4월 17일 공지는 2026-04 이상에서 inventoryActivate의 available과 onHand를 지정하지 않으면 활성화 전 수량을 보존한다고 설명한다. 이전에는 수량을 0으로 초기화하는 동작이 있었으며, REST의 연결 요청에도 보존 변경이 적용된다. 이는 수량 인자를 명시한 요청까지 무조건 과거 값으로 되돌린다는 뜻이 아니다. [1]
인계할 때 요청 자체를 남기기
재활성화 담당자는 호출 직전 수량과 인자 생략 여부를 인계하고, 호출 뒤 값이 달라지면 수량 초기화에 의존하던 업무 규칙부터 확인한다. item과 location을 묶어 전후 값을 대응시키고, 시험 중 입출고가 있었는지도 기록한다. 경쟁 변경이 있었다면 단순한 전후 차이로 API의 보존 동작을 판정할 수 없으므로 별도 시험으로 분리한다. [1, 3]
기존 7개를 그대로 넘기는 시험
설명용으로 비활성 위치에 available 수량이 7이고, 시험 중 다른 재고 변경은 없다고 정한다. 수량 인자를 모두 생략한 재활성화 뒤에도 7이면 보존 조건을 만족한다. 0이 됐다면 초기화에 의존한 요청 변환이나 후속 조정이 남았는지 조사한다. 기대값 7은 응답을 복사해 만드는 값이 아니라 호출 전에 확보한 수량이다. 이 예는 Shopify를 실제 호출한 재현 결과가 아니다. [1, 3]
Truthound를 붙일 자리는 전후 대조표
Truthound Core 3.3.2의 ColumnPairValidator는 같은 item·location으로 준비한 두 수량 열을 비교할 수 있다. 이 검증기는 null이 있는 쌍을 건너뛰므로 비교 전에 필수값의 존재를 별도로 확인해야 한다. Truthound가 재고를 활성화하거나 거래를 잠그지는 않는다. 초기화가 필요한 업무라면 생략의 옛 부수효과에 기대지 않고 승인된 재고 조정 절차로 명시하는 편이 인계 기준도 분명하다. [1, 2, 3]
적용 조건
2026-04 이상에서 available과 onHand 인자를 모두 생략한 재활성화를 대상으로 하며, 동일 item·location의 전후 값을 결측 없이 확보하고 동시 조정은 별도 배치로 분리한다.
대안
초기화가 업무상 필요하면 생략의 부수효과에 기대지 말고 승인된 재고 조정 절차로 명시한다.
한계
Truthound는 재고를 활성화하거나 동시 거래를 잠그지 않는다. 명시적으로 수량을 보낸 요청에 보존 규칙을 강제해서는 안 된다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
