Styxis
Company
Knowledge

Shopify 반품 배송비 세금: 확정 전 null과 확정된 0을 구별하기

예상 세금과 확정 세금은 계산 시점이 다르다. 정산에서는 값뿐 아니라 확정 여부를 보존해야 한다.

빈 금액을 보기 좋게 채우면 잃는 정보

확정 전 세금과 세금 없음은 다른 상태다. 미처리 반품의 null을 0으로 채우면 아직 정해지지 않은 금액이 확정값처럼 장부에 들어간다. 지원 화면에서 빈칸을 없애려던 변환이 정산 데이터에까지 이어지면, 다음 담당자는 무엇을 기다려야 하는지 알 수 없게 된다. [1, 2, 3]

예상액과 확정액을 위한 다른 필드

Shopify의 2026-10 변경 공지는 반품 배송비에 대한 예상 세금 taxAmountSet과 처리 시 확정되는 finalizedTaxAmountSet을 구분한다. 후자는 반품이 처리되기 전 null이고 세금이 적용되지 않으면 0이다. 처리 시점의 세금 공급자 계산이 달라지면 예상액과 확정액도 다를 수 있다. 두 필드의 차이를 무조건 데이터 오류로 해석할 근거는 없다. [1]

정산 표에 남길 것은 금액만이 아니다

정산 담당자는 예상 세금과 확정 세금을 다른 열로 보존하고, 반품 처리 전 확정값이 채워진 기록은 처리 상태와 원문 응답을 대조한 뒤 정산에서 보류한다. shop 통화와 presentment 통화도 나누어야 한다. 조회 시각이 다른 상태·금액을 섞었다면 먼저 같은 처리 경계로 맞춘다. 예상액을 임시 확정액 열에 복사하면 이후의 차이가 실제 재계산인지 가공의 흔적인지 구별하기 어렵다. [1, 3]

0이라는 값보다 존재 여부를 먼저 본다

설명용 반품이 아직 처리되지 않았다면 확정 세금의 기대 존재 여부는 false다. 원문의 null을 보존해 false로 남긴 경우는 정상이다. 0으로 채우고 존재 여부를 true로 만들면 미확정 상태가 사라졌으므로 실패다. 반대로 처리 완료 후 원문에 0이 왔다면 세금 없음이라는 확정 결과일 수 있다. 이 사례는 실제 세액을 계산하지 않으며 세금이 적용되는 지역과 조건을 판정하지도 않는다. [1, 3]

Truthound가 확인할 조건부 상태 계약

Truthound Core 3.3.2의 RowLevelValidator에 row_validator 콜백을 제공하면 준비된 처리 상태와 확정값 존재 여부의 모순을 검사할 수 있다. 콜백은 운영자가 명세를 바탕으로 정한 조건이며 세율을 추론하는 모델이 아니다. 원문의 결측 상태나 처리 시점을 잃은 자료는 먼저 복구 가능한 근거를 확인한다. 확정 전 금액은 별도 보류 상태로 표시하고 처리 후 확정액으로 정산하되, 제품 검사 통과를 세무 적합성의 인증으로 사용하지 않는다. [1, 2, 3]

적용 조건

2026-10 이상 응답에서 처리 상태와 원문 null 여부를 함께 보존하고 shop·presentment 통화를 구분한다. 처리 시점과 조회 시점이 어긋난 자료는 먼저 정렬한다.

대안

확정 전 금액을 별도 보류 상태로 표시하고 실제 처리 후 받은 확정액으로 정산한다.

한계

  • Truthound는 세액을 산정하거나 세무 적합성을 보증하지 않는다. 예상액과 확정액은 공급자의 계산 시점 때문에 달라질 수 있어 단순 동일성 규칙을 적용하지 않는다.

근거

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