Shopify selling_plan_id 검증: 일반 구매의 null을 누락으로 세지 않기
새 webhook 필드는 구독 품목의 판매 계획을 전달한다. 일반 구매까지 필수값 규칙을 적용하면 정상 데이터가 실패한다.
모든 null이 재조회 사유는 아니다
일반 구매 품목의 null은 정상 의미다. 구독 품목 여부를 구분하지 않은 필수값 검사는 정상 주문까지 재조회 대상으로 만든다. 누락 비율을 낮추겠다고 임의 계획 ID나 문자열을 넣으면 품질 지표는 좋아 보여도 어떤 계약으로 구매했는지 설명할 근거는 사라진다. [1, 2, 3]
필드가 추가되면서 줄일 수 있는 호출
Shopify의 2026-10 공지는 Orders webhook의 품목에 selling_plan_id를 포함한다고 설명한다. 구독 품목에 적용된 판매 계획의 ID이며, 구독이 아닌 품목에서는 null이다. 원래 추가 Admin API 호출로 알아내던 값을 webhook에서 받을 수 있도록 한 변경이고, 이전 버전의 기존 동작은 영향을 받지 않는다고 안내한다. 새 필드가 존재한다는 사실과 모든 품목에 값이 있어야 한다는 주장은 다르다. [1]
구독 여부를 같은 결측값에서 추론하지 않는다
주문 지원 담당자는 품목의 구매 유형과 API 버전을 보존하고, 일반 구매의 null은 정상으로 두되 구독 품목의 참조만 확인 대상으로 분리한다. 구독 여부를 selling_plan_id가 비었는지로만 정하면 누락 여부를 검사하는 기준도 같은 관측값에서 나오게 된다. 주문 원장 등 독립된 구매 유형 근거와 품목 키를 먼저 대응시킨다. [1, 3]
일반 구매를 위한 조건부 반례
설명용 품목이 독립 주문 기록상 비구독이라고 정한다. 이때 계획 참조의 기대 null 여부는 true다. 실제도 true이면 적용되지 않는 참조를 억지로 만들지 않았다. false이면 일반 구매 품목에 계획 ID가 붙었으므로 다른 품목의 매핑이 섞였는지 원문을 확인한다. 구독 여부가 불명확하면 이 규칙으로 정상 또는 누락을 확정하지 않고 조사 대상으로 남긴다. [1, 3]
일률적인 NotNull 대신 명세의 조건을 검사한다
Truthound Core 3.3.2의 RowLevelValidator는 row_validator 콜백으로 구매 유형과 null 상태의 조건을 표현할 수 있다. 이는 전역 필수값 규칙을 좁혀 쓰자는 제안이다. 과거 버전에 필드가 없는 상태와 새 버전의 명시적 null은 먼저 분리해야 한다. Truthound가 구독 계약을 조회하거나 결제를 판단하지 않으므로, 근거가 부족한 품목만 승인된 조회 절차로 보내고 정상 null마다 호출을 반복하지 않는다. [1, 2, 3]
적용 조건
2026-10 이상 Orders webhook에서 품목 단위 원문을 읽고, 구독 여부를 같은 필드의 결측에서 역추정하지 않고 주문 원장과 대조한다.
대안
구독 여부가 불명확한 품목만 승인된 원장 조회로 보내고 모든 null에 추가 호출을 발생시키지 않는다.
한계
Truthound가 구독 계약을 조회하거나 결제를 판단하지 않는다. 과거 버전에 필드가 없는 상황과 새 버전의 명시적 null은 구분해야 한다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
