Shopify DraftOrderLineItem grams에서 weight로: value와 unit 함께 이전
필드 이름 이전은 단위 계약 이전이므로 새 숫자와 단위를 함께 정규화한 뒤 기존 업무 무게와 비교해야 한다.
Shopify DraftOrderLineItem grams에서 weight로: value와 unit 함께 이전
단일 grams 필드를 value와 unit의 쌍으로 바꾸면 숫자를 복사하는 작업과 무게를 보존하는 작업이 달라진다. 새 값의 단위를 읽지 않으면 필드 이전이 성공해도 배송 계산에 다른 크기의 무게를 넘길 수 있다. 원시 값·단위와 업무 기준 환산값을 함께 인계해야 한다. [1, 2, 3]
공개 원문이 보여 준 범위
Shopify는 DraftOrderLineItem.grams 제거를 알리고 value와 unit을 함께 반환하는 weight로 이전하도록 안내했다. 새 필드는 단일 grams 정수의 표현 한계와 단위 제한을 줄인다. grams 제거는 API 2026-07에서 시작된다. [1]
입력과 출력에서 확인할 관계
단위가 다른 작은 초안 주문을 만들고 각 명시 단위를 업무 기준 단위로 환산한다. 배송 계산에 전달한 무게를 원천과 대사하며 weight_value, weight_unit, canonical_grams, source_grams를 보존한다. 새 필드 조회가 성공했다는 사실만으로 크기가 달라진 값까지 승인하지 않는다. [1, 3]
승인 기준과 실패 사례
설명용 무게 1 kilogram은 1000 grams에 해당한다. 정규화 결과 1000은 기준을 충족하지만 새 value만 복사해 1 gram으로 읽으면 단위 이전에 실패한 것이다. 기준 환산은 응답 숫자의 크기에서 추측하지 않고 명시된 단위에서 계산한다. 이 대조는 실제 포장이나 저울 측정, 운임 계산의 정확성을 대신 확인하지 않는다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ColumnPairValidator는 승인한 단위 변환 뒤의 canonical_grams와 기준 무게를 비교할 수 있다. 단위 변환 함수와 원천 unit의 해석은 앞단에서 검증해야 한다. 배송비 계산이나 실제 저울의 정확성을 대신 확인하는 것은 아니다. [1, 2, 3]
다른 선택이 필요한 조건
단위 환산 검사로 실제 포장·계측 무게나 운임 정확성을 보장하지 않는다. 업무 기준 단위를 명시하고 value·unit 원문을 함께 보관한다. 새 API가 항상 GRAMS만 반환하도록 계약됐다면 다른 단위 fixture는 추가 활용 시험의 범위다. [1, 3]
적용 조건
weight_value, weight_unit, canonical_grams, source_grams 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
업무 기준 단위를 명시하고 value·unit 원문을 함께 보관한다.
한계
단위 환산 검사로 실제 포장·계측 무게나 운임 정확성을 보장하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
