Styxis
Company
Knowledge

Shopify FULFILLMENT_NOT_REQUIRED: 미출고와 출고 의무 없음을 구별하기

새 이행 상태를 단순한 미출고로 매핑하면, 처리할 수량이 없는 주문이 작업 큐에 남는다.

물건이 나가지 않았다는 사실만으로 대기 작업을 만들지 않는다

미출고와 남은 출고 의무 없음은 다르다. 새로운 상태를 대기 주문으로 뭉개면 이행할 수 없는 작업을 현장에 넘기게 된다. 취소되거나 환불되어 출고할 품목이 없는 주문까지 미처리로 보이면 담당자는 이미 끝난 요청을 다시 조사하게 된다. 큐의 목적은 상태 이름을 그대로 옮기는 것이 아니라 남은 일을 인계하는 데 있다. [1, 2, 3]

새 상태가 적용되는 버전과 조건

Shopify의 2026년 7월 3일 공지는 2026-10부터 OrderDisplayFulfillmentStatus가 FULFILLMENT_NOT_REQUIRED를 반환할 수 있다고 설명한다. 아무 품목도 이행하지 않았으나 남은 이행 수량이 없는 주문이 대상이며, 이전에는 UNFULFILLED로 표시됐던 경우다. 이전 API 버전은 그대로다. 공지는 앞으로도 enum 값이 추가될 수 있으므로 미인식 값을 유연하게 처리하라고 안내한다. [1]

원문 상태를 보존한 뒤 큐 정책을 적용한다

출고 목록 담당자는 취소·환불 등으로 남은 출고 수량이 없는 주문의 표시 분기를 점검하고, 새 상태를 지원한 뒤 대기 큐의 포함 기준을 다시 확인한다. 원문 상태와 API 버전을 보존해야 구버전 응답에 새 분기를 잘못 요구하지 않는다. 미인식 상태를 바로 미출고로 치환하기보다 별도 확인 대상으로 남기면 새 enum이 추가될 때도 인계 의미를 잃지 않는다. [1, 3]

처리할 수량 0의 정상과 반례

설명용으로 아무 상품도 이행하지 않은 주문이 전부 취소되어 잔여 출고 수량이 0이라고 정한다. 대기 포함의 기대값은 false다. 실제도 false이면 실행할 물품이 없는 주문을 작업에서 분리했다. true이면 원문에 이행 의무가 없는데도 현장 큐에 넣은 것이므로 상태 매핑을 고친다. 이는 모든 상태를 자동 분류하는 규칙이 아니라 이 조건에 한정한 사례다. [1, 3]

Truthound는 인계표의 모순을 확인한다

Truthound Core 3.3.2의 RowLevelValidator는 row_validator 콜백으로 준비된 원문 상태·잔여 수량·큐 분류 사이의 조건을 검사할 수 있다. 콜백의 업무 규칙은 출고 책임자가 정해야 하며 검사기가 취소나 환불을 실행하지 않는다. 적용 버전, 확인된 상태와 수량이 없는 기록은 먼저 조사한다. 새 타입을 지원하는 수정과 미인식 값의 보류 경로도 함께 시험해야 이 한 사례의 통과를 전체 상태 처리의 정확성으로 확대하지 않게 된다. [1, 2, 3]

적용 조건

2026-10 이상에서 실제 원문 상태와 잔여 출고 수량을 확보하고, 대기 큐의 업무 정의를 출고 책임자가 승인한다. 알 수 없는 enum은 별도 보류 경로에 남긴다.

대안

매핑 표와 생성된 타입을 갱신하고, 미인식 enum에 대한 기본 보류 분기를 구현한다.

한계

  • Truthound는 취소·환불을 집행하지 않으며 다른 이행 상태를 이 한 규칙으로 분류하지 않는다. 새 enum을 기존 버전 응답에도 강제하면 안 된다.

근거

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