Shopify 주문 취소 인계: job 접수와 jobResult의 완료 근거 분리하기
비동기 취소 요청의 접수는 고객에게 완료를 안내할 증거가 아니다. 취소 전용 결과를 확인할 경계를 둔다.
접수됐다는 답변과 취소됐다는 답변
비동기 작업의 접수와 주문 취소의 완료는 다르다. 완료 안내는 취소 전용 결과의 상태·오류·대상 주문을 확인한 뒤 결정해야 한다. 지원 담당자가 일반 작업 ID를 받았다는 사실만 전달받으면 작업이 처리 중인지 오류로 끝났는지 설명할 수 없다. 인계표에 접수와 결과 확인을 별도 단계로 남겨야 한다. [1, 2, 3]
취소에 맞춘 결과 필드가 추가됐다
Shopify의 2026-10 공지는 orderCancel 응답에 OrderCancelJobResult 타입의 jobResult를 추가했다고 설명한다. 취소는 비동기로 실행되며 새 필드는 취소 상태, 오류, 대상 주문을 제공한다. 기존의 일반 job 필드는 그대로 작동한다. 따라서 새 결과를 도입할 수 있다는 안내를 기존 통합이 즉시 깨졌다는 장애 보고로 바꾸어 읽을 필요는 없다. [1]
안내를 승인하는 증거를 먼저 정의한다
고객 지원 담당자는 접수 기록과 취소 결과를 분리해 인계하고, 결과 확인 전에는 완료 안내를 보류하며 오류가 있으면 해당 주문의 처리 담당자에게 넘긴다. 요청 주문과 결과의 주문이 같은지도 확인한다. 실제 상태 enum과 성공 조건은 적용 버전의 API 명세에서 정하고, 짧은 변경 공지에 없는 상태 이름을 구현 편의대로 만들어서는 안 된다. [1, 3]
접수만 된 요청을 이용한 시험
설명용 요청은 접수됐지만 취소 전용 결과가 아직 수집되지 않았다고 정한다. 완료 안내 허용의 기대값은 false다. 실제도 false이면 결과 확인을 기다린다. true이면 확인되지 않은 취소를 완료로 안내하므로 발송을 보류한다. 이 시험은 작업이 나중에 성공할지를 예측하지 않으며, 결과를 아직 모른다는 상태를 고객 안내에 어떻게 반영할지 보여 준다. [1, 3]
확인되지 않은 성공을 표시하는 검사
Truthound Core 3.3.2의 ExpressionValidator는 filter_expr로 준비된 결과 확인·안내 승인표의 조건을 검사할 수 있다. 접수 기록을 결과 증거로 바꾸어 주지는 않는다. Truthound가 주문을 취소하거나 비동기 처리를 기다리는 기능으로 설명해서도 안 된다. 기존 job 기반 통합의 호환성을 유지하더라도 결과 확인 절차는 별도로 운영하고, 원천 결과가 없는 로그에는 완료 판정을 보태지 않는다. [1, 2, 3]
적용 조건
2026-10 이상에서 취소 전용 결과를 수집하고, 상태의 실제 enum과 완료 조건은 적용 버전의 API 명세로 확정한다. 일반 job ID만으로 완료를 추론하지 않는다.
대안
기존 job을 사용하는 통합은 호환성을 유지하면서 결과 확인 절차를 별도로 운영하고, 새 jobResult를 도입할 때 지원팀 안내 조건도 함께 갱신한다.
한계
Truthound는 주문을 취소하거나 비동기 작업을 기다려 주지 않는다. 이 글은 공지에 없는 상태 enum 이름이나 오류 재시도 가능성을 추정하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
