1.1 KiB
1.1 KiB
KBX v13 — quantity → orderQty OMS Migration
배경
OMS 주문 상세에서 일반적인 quantity와 주문 의미가 명확한 orderQty가 혼용되었다.
KBX 표준의 동일 개념/동일 FieldKey 원칙에 따라 OMS 주문 입력·Excel·Validation은 orderQty로 정규화한다.
Frontend
신규 payload:
{
"orderQty": 10
}
Grid/Zod/Error field도 orderQty를 사용한다.
Backend 호환성
v13 RegisterOrderLineRequest는 일시적으로 다음 둘을 수용한다.
orderQty -> canonical
quantity -> v12 legacy input
Server는:
orderQty ?? quantity
순서로 해석한다.
DB column oms.order_lines.quantity는 이번 변경 대상이 아니다.
Field Dictionary는 UX/API 의미 계약이며 DB physical naming을 강제하지 않는다.
제거 조건
legacy quantity wire input 제거는 다음 조건을 충족한 별도 Breaking Release에서만 수행한다.
- 구 Client 사용량 0 확인
- API 소비자 공지
- Migration Guide
- Major change declaration
- Contract/E2E Test 갱신