FEAT-Order-001 | BA Management System

Feature Scope

Xây dựng logic tính tổng tiền đơn hàng khi áp voucher, bao gồm việc kiểm tra tính hợp lệ của mã, tính toán chiết khấu theo phần trăm hoặc số tiền cố định, và xử lý các kịch bản lỗi. Lưu ý: Không bao gồm UI quản lý voucher.

Business Rules

verified

Rule 1: Độc nhất

Mỗi đơn chỉ áp tối đa 1 voucher duy nhất.
verified

Rule 2: Thứ tự áp thuế

Giảm giá áp dụng trên tổng tiền sau khi đã tính thuế VAT.
verified

Rule 3: Hạn mức tối thiểu

Voucher chỉ có hiệu lực nếu Subtotal > Min Spend.
verified

Rule 4: Cap chiết khấu

Với voucher %, số tiền giảm tối đa không quá Max Discount.

Acceptance Criteria

Testable

Tổng tiền thanh toán cuối cùng = Σ(item_price) – discount_amount Hệ thống trả về mã lỗi INVALID_VOUCHER nếu code không tồn tại Không cho phép stack voucher bằng cách gọi API nhiều lần

UI / Wireframe

terminal

View Figma Prototype

Linked: 24 May 2024

Data / API Notes

POST /order/apply-voucher

content_copy

Input Breakdown

cart_id string

voucher_code string

user_id uuid

Output Response

original_total decimal

discount_value decimal

final_total decimal

Internal Review

Estimate

16 working hours

Risk

Ảnh hưởng logic tính toán đơn hàng cũ

Dependency

Voucher Service API (v2.1)

Handover

task Dev Ticket: DEV-231

Sprint: Sprint 12 (Q2)

Notes

"Cần Tech Lead confirm logic làm tròn số thập phân cho trường hợp tiền ngoại tệ trước khi dev."