Styxis
Company
Knowledge

Shopify 재고 배송 webhook: 이동 ID를 보존하고 참조 범위를 확인하기

이동 ID가 제공되면 추정 조인을 줄일 수 있지만, 참조의 존재와 올바른 연결은 여전히 다른 검사다.

시각이 비슷한 이동을 원문 참조 대신 쓰지 않는다

원문에 제공된 이동 식별자를 우선 보존해야 수량과 시각이 비슷한 배송을 잘못 짝짓는 일을 줄일 수 있다. 물류 인계에서는 배송이 어떤 이동에 속하는지 알아야 후속 입고와 차이 조사를 같은 건으로 이어 갈 수 있다. 참조가 없는 배송까지 억지로 이동에 붙이는 방식은 연결률을 높여 보여도 근거를 약하게 만든다. [1, 2, 3]

새 필드가 알려 주는 관계

Shopify의 2026년 10월 1일 공지는 2026-10의 여러 inventory_shipments webhook에 inventory_transfer_id를 추가한다고 안내한다. 생성·삭제·품목 및 수량 변경·이동 중 표시·입고·추적 갱신 이벤트가 열거되어 있다. 목적은 배송이 어느 이동과 관련되는지, 관련된다면 그 이동이 무엇인지 직접 식별하도록 돕는 것이다. 모든 배송이 반드시 이동과 연결된다고 읽을 근거는 아니다. [1]

참조 실패보다 먼저 확인할 수집 범위

입고 담당자는 webhook의 이동 식별자를 수집표에 보존하고, 값이 있는 참조가 수집된 이동 원장에 없으면 원장 수집 범위를 확인한 뒤 연결을 재검토한다. 상점 경계를 섞지 않고 권한·수집 시점·누락 페이지를 함께 확인한다. 원장이 덜 수집된 상태에서 참조 실패를 원천 배송의 오류라고 부르면 조사 대상부터 잘못 잡는다. [1, 3]

존재하는 키가 언제나 맞는 키는 아니다

설명용 원문 이동 ID가 MOVE-A이고 승인된 완전한 원장에도 MOVE-A가 있으면 기대 참조 상태는 present다. 실제도 present이면 존재 조건은 충족한다. 원장에 없는 MOVE-X가 들어와 absent이면 원문과 수집 범위를 다시 확인한다. 반대로 다른 실재 이동인 MOVE-B로 바뀌면 존재 검사만으로는 통과할 수 있다. 따라서 원문 ID 보존 비교와 원장 참조 검사를 별도로 남겨야 한다. [1, 3]

Truthound에서 나누어야 할 두 책임

Truthound Core 3.3.2의 ForeignKeyValidator에는 준비된 자식·부모 표와 키 열을 지정해 원장에 없는 참조를 검사하도록 할 수 있다. 관계가 없는 배송의 null 처리 정책도 명시해야 한다. 이 검사는 원문과 다른 실재 ID로 바뀐 오연결을 찾아 주지 않으므로 원문 대조는 별도다. Truthound가 누락 webhook을 복원하거나 Shopify에서 이동을 조회하는 것도 아니다. 의심 참조는 원장 갱신과 공식 조회로 조사하며 시각·수량이 닮았다는 이유로 임의 연결하지 않는다. [1, 2, 3]

적용 조건

2026-10 이상에서 공지된 inventory_shipments 이벤트를 사용하며, 동일 상점과 확인 가능한 수집 범위의 이동 원장을 준비한다. 참조 없음과 원장 수집 누락을 구분한다.

대안

이동 원장 갱신과 권한을 확인한 뒤 공식 API 조회로 의심 참조를 조사하고, 시간·수량만으로 억지 조인하지 않는다.

한계

  • 참조 부재만으로 배송이 잘못됐다고 결론 낼 수 없다. Truthound는 빠진 webhook을 복원하거나 원천 이동의 존재를 조회하지 않는다.

근거

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