Files
loyalty-agent-service/docs/knowledge-cards/campaign/transaction_codes.md

5.1 KiB

card_id, title, domain, related_cards, tags
card_id title domain related_cards tags
campaign/transaction_codes Định danh Giao dịch (Transaction Codes & Category) campaign
campaign/campaign_rule
customer/operations_transaction
transaction code
TC
mapping
category
criteria

Định danh Giao dịch (Transaction Codes & Category)

Mô tả ngắn

Để hệ thống OLS có thể hiểu và định tuyến các giao dịch (từ bên ngoài hoặc nội bộ) vào đúng các quy tắc chiến dịch (Campaign Rules) phù hợp, hệ thống sử dụng cơ chế ánh xạ thông qua 3 thực thể cấu hình: External Transaction Code (Mã giao dịch ngoài), OLS Transaction Code (Mã giao dịch nội bộ) và Transaction Category (Danh mục giao dịch).

Thuật ngữ liên quan

  • TC (Transaction Code): Mã giao dịch, dùng để định danh loại nghiệp vụ (ví dụ: Thanh toán POS, Rút tiền mặt, Hoàn tiền).
  • External TC: Mã giao dịch nguyên bản được truyền vào từ các hệ thống nguồn (Core Banking, Card System).
  • OLS TC: Mã giao dịch được chuẩn hóa bên trong hệ thống OLS. Đây là chìa khóa đầu tiên (First key) để hệ thống tra cứu xem giao dịch sẽ kích hoạt Rule nào.

Cấu trúc dữ liệu và Ánh xạ (Data Schema & Mapping)

1. External Transaction Code

  • External TC: Mã định danh (ví dụ: TC4000, ATM_WDL).
  • Description: Mô tả loại giao dịch từ hệ thống nguồn để dễ nhận diện.
  • Ràng buộc: Mỗi External TC khi được nhận vào hệ thống bắt buộc phải được ánh xạ (map) tới duy nhất một OLS TC.

2. OLS Transaction Code

  • OLS TC: Mã chuẩn hóa nội bộ của OLS.
  • Mapping (1-N): Một OLS TC có thể nhận ánh xạ từ một hoặc nhiều External TCs (Ví dụ: TC4000 của hệ thống thẻ Credit và TC5000 của hệ thống thẻ Debit cùng map về OLS TC PURCHASE).
  • Nguồn nội bộ: OLS TC không bắt buộc phải có External TC đi kèm. Các giao dịch phát sinh hoàn toàn từ nội bộ (như CEP sinh ra, hoặc Award Transaction thủ công) có thể dùng thẳng OLS TC mà không cần qua bước mapping.
  • Reversal Indicator: Cờ (công tắc) báo hiệu đây là giao dịch hoàn trả/hủy (Reversal) hay giao dịch bình thường (Normal).

3. Transaction Category (Danh mục giao dịch)

  • Định nghĩa: Là một cấu hình tập hợp nhiều tiêu chí (Criteria) tạo thành một biểu thức logic phức tạp, được lưu lại dưới một cái tên (Code) duy nhất.
  • Cấu trúc:
    • Transaction Category Code & Name.
    • Configuration: Sử dụng Query Builder (kéo thả) để tạo các nhóm tiêu chí (AND/OR). Hỗ trợ cả công tắc đảo ngược logic (NOT) để loại trừ (Exclusion).
  • Mục đích (Tái sử dụng): Thay vì phải cấu hình một cụm điều kiện dài dòng (Ví dụ: MCC = Dining AND Currency = Local AND Is_DCC = True) lặp đi lặp lại trên nhiều Campaign Rules, người quản trị cấu hình thành TxCat1. Sau đó, trong Campaign Rule, chỉ cần chọn tiêu chí Transaction Category = TxCat1.

Cách hoạt động (How It Works)

  1. Giai đoạn tiếp nhận giao dịch:
    • Giao dịch đổ vào hệ thống mang theo External TC (ví dụ 05).
    • Hệ thống tra bảng ánh xạ, chuyển 05 thành OLS TC RETAIL_SPEND.
  2. Giai đoạn định tuyến Rule:
    • Engine tìm kiếm tất cả các Campaign Rules đang Active có khai báo OLS TC là RETAIL_SPEND.
    • Nếu Rule đó có sử dụng Transaction Category làm tiêu chí (Criteria), engine sẽ "bung" category đó ra để đối chiếu thêm các trường dữ liệu thực tế (MCC, Currency, Amount) của giao dịch có khớp với biểu thức Category hay không.
  3. Giai đoạn xử lý: Nếu toàn bộ điều kiện khớp, giao dịch được tính hợp lệ để chạy công thức cấp thưởng.

Mối quan hệ với modules khác

  • Campaign Rule: Sử dụng OLS TC và Transaction Category như một phần cốt lõi trong "Rule Criteria" để lọc giao dịch.
  • Operations Transaction: Khi nhân viên tạo "Award Transaction" thủ công (để giả lập giao dịch gửi vào Rule Engine), họ sẽ phải chọn trực tiếp OLS TC (không dùng External TC).

Ví dụ thực tế

Ngân hàng chạy chiến dịch: "Tặng 5% khi ăn uống bằng ngoại tệ" và "Tặng 2% khi ăn uống trong nước". Thay vì cấu hình lại nguyên cụm MCC Ẩm thực nhiều lần:

  1. Tạo Transaction Category 1: CAT_DINING = (MCC in [5812, 5814]).
  2. Tạo Campaign Rule 1: TC = PURCHASE AND Transaction Category = CAT_DINING AND Currency != VND. Rate = 5%.
  3. Tạo Campaign Rule 2: TC = PURCHASE AND Transaction Category = CAT_DINING AND Currency = VND. Rate = 2%. Khi giao dịch đến mang External TC TC4000 (được map về OLS TC PURCHASE), hệ thống sẽ đối chiếu và chia nhánh xử lý mượt mà.