Merge Code Build 4_0 Vao Build Stable

Last updated on Jan 14, 2025

Target release	2024/07/12
Document owner	Vu
Developer	Nhàn
QA	Vu

Merge build 4_0 vào build Stable sẽ có thêm new config show Custom Fee for all Reports dùng để show Custom Fee & Merchant fee cho Section Credit Card, Show Custom Fee cho Section Cash(ko show Merchant Fee vì Cash ko có tính Merchant Fee), Show 1 Section mới là Custom Fee Non Credit(cho những phương thức ko phải là Credit, VD Cash hoặc Custom methods) NOTE: config này đã ẩn vì logic hiện tại sẽ luôn luôn show Custom Fee, Merchant Fee ra trên report
Gift Card Issue khi enter amount cần nạp là số thập phân VD $100.75 thì khi chọn phương thức Cash cũng sẽ ko apply Coins Discount nữa, sẽ vẫn phải thanh toán đủ $100.75 chứ ko phải là $100 nữa. Tóm lại là khi issue Gift Card by Cash sẽ ko apply Coins Discount cho dù đang check vào config “Coins Discount” => Nguyên nhân là khi sử dụng Custom Fee 4%_0% thì sẽ ko biết sẽ nên trừ Coins discount vào Base amount hay Custom Fee amount
Gift Card Issue khi uncheck config “Apply Custom Fee&Cash Discount when purchasing Gift Card” và issue by Credit add Tip thì Tip đó sẽ ko có Custom Fee(Custom Fee = 0), nghĩa là add Tip $10 thì Base Tip = Final Tip = $10, nhưng vẫn sẽ có tính Merchant Fee khi show theo Deposit amount.
Amount của Gift Card Issue by Credit và Tip của Gift card sẽ được bỏ vào chung Section Credit Card trên report để cho dễ so sánh với Batch report => thêm 2 dòng Gift Card Sales và Gift Card Tips trong Section Credit card, hide đi nếu amount = 0.00 Gift Card Issue by Cash thì cũng phải bỏ chung vào Section Cash, nhưng amount thể hiện trên Header của Section sẽ là Total Sales ko bao gồm Gift Card Sales và Custom Fee(và nếu có Custom Fee thì phải bỏ vào Section Custom Fee Non-Credit) vì như khách hàng hỏi Eric thì Tổng Cash là $300 gồm $200 doanh thu của tiệm và $100 issue by Cash, nên nếu ko bỏ chung vào Section Cash thì sẽ khó kiểm soát => làm tương tự issue by Credit : Total Sales Gift Card Sales Custom Fee Total Ngoài ra Gift Card Issue vẫn ko được xem là doanh thu buôn bán của tiệm như trước giờ, việc bỏ vào Section Credit Card để show chung chủ yếu là để so sánh với Batch report, để biết được Custom Fee & Merchant Fee & Deposit amount trên Sale report thôi
Thêm 1 Section mới cho Online Order(Web, Phone App) chứ không để chung trong Section Credit Card nữa vì Web và Phone App sử dụng USA EPAY hoặc Authorize chứ ko phải PAX, mà Batch report thì chỉ report duy nhất PAX thôi, nên nếu để chung trong 1 Section Credit Card thì sẽ dễ confuse khi so sánh deposit amount của Section Credit Card với Batch report. Tuy nhiên vẫn phải hiểu rằng Online order thanh toán bằng USA EPAY hoặc Authorize thì vẫn được xem là thanh toán bằng phương thức Credit Card, chỉ là khi show chi tiết thì cần phải show riêng ra để không bị nhầm lẫn với ticket thanh toán từ Pax thôi • Lưu ý: Section Online Order sử dụng USA EPAY/Authorize nên không cần thiết show ra thông tin Merchant Fee và Deposit amount (đã confirm với Tuấn, nhàn) • QRCode Dine-In : ticket submit từ Qrcode (Web hoặc Phone App) nhưng thanh toán từ POS(sử dụng PAX) thì Section Online Order sẽ ko show ra amount mà phải show ở Section Credit Card mới đúng, vì cần khớp Total với Batch report => thanh toán bằng loại Merchant nào thì phải show đúng ở đó.
EBT Food, EBT Cash và Debit khi sử dụng Custom Fee 4%_0% nhưng vẫn không được phép tính Custom Fee vì đây là những phương thức đặc biệt, tuy nhiên vẫn phải tính Merchant Fee (đã confirm với anh Khánh trong 1 đoạn chat có lưu trong file Word)
Employee report và Shift Report có Section Cash Owed: Release này sẽ show Tip của transaction Gift Card issue by Credit lên Section Cash Owed bởi vì Tip dùng để chia cho nhân viên thì cần phải ghi nhận lên report đầy đủ
Tạm thời khi thanh toán Cash sử dụng file custom fee 4_0 và config apply Coins Discount thì logic tính Custom Fee vẫn y chang như Credit(Payment Screen), sau khi có kết quả cuối cùng(bao gồm Custom Fee) thì mới tính Coins Discount và trừ ra theo Final Total này, và trên report thì Coins Discount cũng vẫn sẽ được trừ vào Subtotal của item như trước giờ (đã confirm với Tuấn, Nhàn)
Logic của Cash Owed & Tip show trên các reports(Pos Dash Board) khi thanh toán bằng Cash/Non Credit(sử dụng Custom Fee 4%_0%)-(đã confirm với Tuấn,Nhàn,chị Thảo,Hương,Hằng): • Vì không có logic nào cụ thể rõ ràng chính xác cho Tip & Service charges cho Cash/Non Credit khi sử dụng Custom Fee 4%_0%, nên tạm thời Tip và các loại Service charges khi show lên reports và Section Cash Owed sẽ theo logic sau : • Đối với phương thức Cash thì sẽ luôn luôn không có Merchant Fee, cho nên khi thanh toán add Tip và Service charges thì show lên Section Cash Owed sẽ có Merchant Fee = 0, nghĩa là khi config chia Tip và Service charges cho nhân viên theo Deposit amount thì sẽ = Base Tip/Base Service charges + Custom Fee (vì Merchant Fee đã = 0 rồi). Tuy nhiên bản thân Tip by Cash sử dụng Custom Fee 4%_0% thì khi show lên reports theo Base amount thì phải dùng Base amount Fee% để tính ngược ra Base Tip để show lên report • Đối với Custom Methods có check vào config “Custom Fee” thì sẽ được xem như Credit Card và sẽ được tính Tip và Service charges y chang như logic của Credit Card, còn nếu ko check vào “Custom Fee” thì sẽ tính theo logic của Cash • 3 phương thức đặc biệt : EBT Food, EBT Cash, Debit sẽ không có Custom Fee nhưng có tính Merchant Fee
Config “Show Custom Fee on all reports” sẽ tạm thời ẩn đi và default là checked (Tuấn, Nhàn đã confirm): • Nguyên nhân là vì nếu show config này ra thì phải fix lại logic trên reports khi check config này thì show theo Deposit amount nhưng khi Uncheck thì show theo Total Sales mới đúng => như vậy sẽ kéo dài thêm thời gian của task, ko kịp Dead line nên tạm thời sẽ luôn luôn check và ẩn config này đi ko cho sử dụng
Web Online Order trên License sẽ thêm 1 field là Base amount Fee% cho giống với POS, và Base amount Fee này sẽ giống % với Merchant Fee cho những tiệm cũ khi upgrade lên, chỉ khi nào edit lại Custom Fee % thì Base amount Fee% mới tính lại theo Custom Fee% (Tuấn, Phúc đã confirm)
Cash Owed: Logic tính Custom Fee, Merchant Fee cho các loại Service charges theo config Base/Final/Deposit (Đã confirm với Chị Thảo, Tuấn, Nhàn, Hương, những người khác bận nên ko join-> sẽ phải apply theo logic được confirm)

Khi tính Custom Fee và Merchant Fee từ Service charges thì phải tính từ Base amount(ko bao gồm Tax của Service charges) vì Cash Owed là tiền cho nhân viên, Tax là để khai thuế nên khi tính tiền cho nhân viên thì phải trừ Tax ra để tính mới đúng(đã từng confirm với anh Khánh cách đây mấy năm) => Release này chưa làm, khi nào rãnh sẽ fix.