Hướng dẫn sử dụng — iOptima Bản Chào Generator

i

Tổng quan

App này làm gì và dùng khi nào?

iOptima Bản Chào Generator giúp Advisor tạo bản chào giải pháp đầu tư iOptima gửi khách hàng — đầy đủ kịch bản lợi nhuận, luận điểm đầu tư, thông tin Advisor — trong vài giây.

Kết quả xuất ra file HTML / PNG / PDF sẵn sàng gửi ngay cho khách.

💡

Luồng sử dụng mỗi ngày Mở app → Dashboard → Tải data (1 lần/ngày) → Tạo bản chào → Tải file → Gửi khách

Sản phẩm	Ý nghĩa	Kỳ hạn
Vượt Trội (VT)	iOptima outperformance — lợi nhuận cao hơn nắm giữ CP thông thường	3–24 tháng
Phòng Ngự (PS)	Married Put — bảo vệ vốn có giới hạn lỗ, vẫn hưởng upside	1–3 tháng
Cân Bằng (CB)	Collar — giới hạn cả lãi lẫn lỗ, phù hợp khách ổn định	6–24 tháng
An Lãi (AL)	Capital-Protected Note — bảo vệ 100% vốn + lãi suất cố định	2 tuần – 4 tháng

1

Lần đầu sử dụng — Nhập token

App cần 2 token để lấy dữ liệu giá và phân tích

Tại sao cần token? App lấy dữ liệu từ 2 nguồn: WealthNet (giá / lãi suất sản phẩm iOptima) và TC Analysis (phân tích cơ bản cổ phiếu). Token là chìa khoá để xác thực — lấy từ tài khoản của bạn trên 2 website này.

Bước 1 — Lấy token WealthNet

Mở solution.wealthnet.com.vn và đăng nhập
Dùng tài khoản WealthNet của bạn (cùng tài khoản TCBS)
Mở Developer Tools
Nhấn F12 (Windows) hoặc Cmd+Option+I (Mac)
Vào tab Console, chạy lệnh sau
JSON.parse(localStorage['userInfoWN'])['authToken']

Copy toàn bộ chuỗi dài bắt đầu bằng eyJ...

Bước 2 — Lấy token TC Analysis

Mở tcinvest.tcbs.com.vn và đăng nhập
Dùng tài khoản TCBS của bạn
Mở Developer Tools → Console
Nhấn F12 rồi click tab Console
Chạy lệnh sau để lấy token TCA
JSON.parse(localStorage['userInfo'])['authToken']

Bước 3 — Dán token vào app

Mở app → Dashboard → Bấm vào mục ▶ Nhập token mới để mở form:

localhost:8080

▶ Nhập token mới (chỉ cần khi token hết hạn hoặc lần đầu)

Lấy token tại: JSON.parse(localStorage['userInfoWN'])['authToken'] (WealthNet) và JSON.parse(localStorage['userInfo'])['authToken'] (TCA) trong Console trình duyệt.

JWT Token — WealthNet

Paste Bearer token...

JWT Token — TC Analysis

Paste Bearer token...

🔄 Lấy data WealthNet + TCA + iConnect

Chỉ WealthNet

Chỉ TCA

⏰

Token hết hạn sau ~12 giờ Mỗi ngày làm việc cần nhập lại token 1 lần (hoặc dùng Cowork Claude để tự động refresh). Data WealthNet, TCA và iConnect sẽ được tải lại mỗi khi nhập token mới.

2

Dashboard

Quản lý token và trạng thái dữ liệu

Đây là tab đầu tiên bạn cần vào mỗi ngày. Dashboard hiển thị trạng thái dữ liệu hiện tại và cho phép bạn tải lại data mà không cần nhập lại token.

Giao diện Dashboard khi đã có token

localhost:8080

📊 Dashboard

📄 Tạo bản chào

📋 Prefill

🔎 Ticker Universe

TOKEN & DATA

WealthNet token: đã lưu ✕

TCA token: đã lưu ✕

🔄 Tải lại data

Chỉ WealthNet

Chỉ TCA

📈 Tải Trái phiếu

✅

Trái phiếu iConnect/iBond OK — lấy được 31 trái phiếu

▶ Nhập token mới (chỉ cần khi token hết hạn hoặc lần đầu)

WEALTHNET

40/42

tickers · hôm nay

TC ANALYSIS

40/40

tickers · hôm nay

iCONNECT / iBOND

31

trái phiếu · hôm nay

Ý nghĩa các nút

Nút	Tác dụng	Dùng khi nào
🔄 Tải lại data	Fetch lại WealthNet + TCA + iConnect/iBond cùng lúc bằng token đã lưu	Đầu ngày làm việc hoặc khi cần cập nhật giá mới nhất
Chỉ WealthNet	Fetch lại riêng dữ liệu giá sản phẩm iOptima	Khi WealthNet lỗi nhưng TCA còn OK
Chỉ TCA	Fetch lại riêng dữ liệu phân tích cổ phiếu	Khi TCA lỗi nhưng WealthNet còn OK
📈 Tải Trái phiếu	Fetch lại riêng lãi suất trái phiếu iConnect/iBond	Khi cần cập nhật riêng lãi suất trái phiếu (thường dùng cho An Lãi)

✅

Data hợp lệ trong ngày hôm nay Tất cả data được cache trong ngày — bạn chỉ cần tải 1 lần, dùng cả ngày. Qua 00:00 hôm sau app sẽ yêu cầu tải lại.

3

Tạo bản chào

Form tạo bản chào cho 4 dòng sản phẩm

Giao diện chia làm 2 phần: Cột trái là form nhập liệu, cột phải là preview bản chào trực tiếp. Mỗi thay đổi sẽ cập nhật preview ngay.

localhost:8080

📊 Dashboard

📄 Tạo bản chào

📋 Prefill

🔎 Ticker Universe

iOptima Vượt Trội

iOptima Phòng Ngự

iOptima Cân Bằng

iOptima An Lãi

Thông tin bản chào · Vượt Trội

Mã CP bắt buộc

VIB

Giá CP hiện tại — tùy chọn

15,650

Kỳ hạn

12 tháng

Tăng giá kỳ vọng

15%

Size đầu tư — tùy chọn

25

tỷ =

0

cp

Luận điểm đầu tư (4 cards)

Card 1 · Card 2 · Card 3 · Card 4 — nhập hoặc tham khảo TCA

Thông tin Advisor

Tên Advisor

Title · Team

Số điện thoại

🚀 Tạo bản chào

📄

Preview bản chào xuất hiện ở đây

Sau khi bấm 🚀 Tạo bản chào

Hướng dẫn điền form

Sau khi chọn sản phẩm (4 tab ở trên), điền các trường theo thứ tự từ trên xuống:

Trường	Bắt buộc?	Hướng dẫn
Mã CP	Bắt buộc	Nhập mã cổ phiếu (VD: `VIB`, `MWG`, `HPG`). App tự động tra cứu dữ liệu khi bạn nhập.
Giá CP hiện tại	Tùy chọn	Nhập để app quy đổi số cổ phiếu ↔ số tỷ đồng. Nếu không nhập, bản chào sẽ hiển thị % thay vì số tiền cụ thể.
Kỳ hạn	Bắt buộc	Chọn từ dropdown. Tùy sản phẩm có kỳ hạn khác nhau (xem chi tiết từng sản phẩm bên dưới).
Tăng giá kỳ vọng / Mức bảo vệ / Coupon	Bắt buộc	Tham số chính của sản phẩm. Sau khi chọn, app hiển thị lãi suất sẽ áp dụng.
Size đầu tư	Tùy chọn	Nhập số tỷ đồng hoặc số cổ phiếu. Nếu nhập cả 2, app ưu tiên tỷ đồng. Để trống = bản chào chỉ hiện %.
Luận điểm đầu tư	Tùy chọn	4 card luận điểm — có 3 cách điền: • Tự đánh trực tiếp vào từng box bên dưới • Dùng box Lựa chọn Prefill (phía trên khu vực luận điểm): chọn Prefill folder → chọn Prefill → bấm Áp dụng • Bấm 📖 Tham khảo TCA để xem phân tích từ TC Analysis rồi copy sang Luận điểm đã nhập có thể bấm 💾 Lưu ngay trong form để lưu vào Prefill folder, dùng lại lần sau.
Thông tin Advisor	Tùy chọn	Tên, title, SĐT. Bấm 💾 Lưu để browser nhớ thông tin này cho lần sau.

Box "Lựa chọn Prefill" trong form

Mỗi tab sản phẩm (Vượt Trội, Phòng Ngự, Cân Bằng, An Lãi) đều có box chọn Prefill nằm ngay phía trên khu vực nhập luận điểm:

Lựa chọn Prefill

Prefill folder

Hiep ▾

Prefill

Template HPG ▾

Áp dụng

💾 Lưu

Prefill folder: chọn người dùng (folder của bạn hoặc của đồng nghiệp để tham khảo)
Prefill: chọn template đã lưu trong folder đó
Áp dụng: điền 4 card luận điểm từ template vào form
💾 Lưu: lưu nội dung 4 card đang nhập vào folder của bạn

Tải file sau khi tạo xong

Sau khi bấm 🚀 và thấy preview, bạn có thể tải file bằng các nút ở góc phải preview:

📥 Tải HTML

🖼️ Tải PNG

📄 Tải PDF

📌

Gợi ý định dạng PNG = gửi qua Zalo/Viber. PDF = đính kèm email chuyên nghiệp. HTML = xem trên browser, dễ in.

3a

iOptima Vượt Trội

Sản phẩm outperformance — lợi nhuận cao hơn nắm giữ CP

Trường đặc thù	Giá trị	Ghi chú
Kỳ hạn	3 / 6 / 9 / 12 / 24 tháng	Kỳ hạn dài hơn thường có lãi suất Vượt Trội cao hơn
Tăng giá kỳ vọng	5% / 10% / 15% / 20% / 25% / 30% / 40%	Kỳ vọng tăng giá CP trong kỳ hạn. Số này ảnh hưởng đến rate Vượt Trội.
Convert CP → iOptima	Checkbox	Tick nếu khách đang có CP và muốn chuyển sang iOptima — app sẽ trừ thuế 0.1% + phí 0.03%
Tính thuế 5% LN	Checkbox	Tick nếu muốn hiện LN sau thuế 5% khi HĐ iOptima có lãi

3b

iOptima Phòng Ngự

Married Put — bảo vệ vốn với giới hạn lỗ tối đa

Trường đặc thù	Giá trị	Ghi chú
Kỳ hạn	1 / 2 / 3 tháng
Mức phòng ngự	85% / 90% / 95% / 98%	Phần trăm vốn được bảo vệ. 98% = chỉ lỗ tối đa 2%
Kịch bản CP tăng	+10% / +15% / +20%	Mức tăng minh hoạ trong bản chào — không ảnh hưởng đến rate thực tế

Phòng Ngự · Thông số rate

Chi phí bảo vệ -2.3% / tháng

Sàn lỗ tối đa -2% vốn

Rate hiển thị tự động sau khi chọn mã + kỳ hạn + mức bảo vệ

3c

iOptima Cân Bằng

Collar — giới hạn cả lãi lẫn lỗ

Trường đặc thù	Giá trị	Ghi chú
Kỳ hạn	6 / 9 / 12 / 24 tháng	24 tháng có mức bảo vệ khác (90/95/100%)
Mức bảo vệ	85% / 90% / 95% (6-12T) 90% / 95% / 100% (24T)	100% = bảo toàn hoàn toàn vốn
Kịch bản CP tăng	+10% / +15% / +20%	Minh hoạ upside trần trong bản chào

3d

iOptima An Lãi

Capital-Protected Note — 100% bảo vệ vốn + lãi suất cố định

Trường đặc thù	Giá trị	Ghi chú
Kỳ hạn	2 tuần / 1 / 2 / 3 / 4 tháng
Coupon tối thiểu	0% / 1% / 2% / 3%	Lãi suất cố định tối thiểu khách chắc chắn nhận. Coupon cao hơn = trần lãi thấp hơn.

📈

Lãi suất trái phiếu iConnect/iBond An Lãi dùng lãi suất trái phiếu iConnect/iBond làm điểm so sánh trong bản chào. Nếu chưa tải trái phiếu, bản chào vẫn tạo được nhưng không có cột so sánh TP. Vào Dashboard → 🔄 Tải lại data để tự động tải cả trái phiếu.

4

Prefill Templates

Lưu sẵn luận điểm đầu tư theo từng folder cá nhân

Prefill giúp tiết kiệm thời gian: Bạn chuẩn bị sẵn 4 card luận điểm cho từng mã CP, lưu thành template trong folder của bạn. Khi tạo bản chào, chọn folder → chọn template → Áp dụng là xong. Mỗi người có folder riêng, nhưng có thể tham khảo folder của đồng nghiệp.

localhost:8080

📊 Dashboard

📄 Tạo bản chào

📋 Prefill

🔎 Ticker Universe

PREFILL FOLDER

+ Tạo folder

Hiep ▾

🗑 Xóa folder

Templates của Hiep

+ Thêm template

Template HPG

4 cards

✏️ Sửa

🗑️

MBB VT

4 cards

✏️ Sửa

🗑️

🗑 Thùng rác — có thể khôi phục trong 30 ngày

Nguyen (xóa ngày 01/07/2026)

↩ Khôi phục

Quản lý Prefill folder

Tạo folder của bạn
Vào tab Prefill → bấm + Tạo folder → nhập tên (VD: tên của bạn) → Xác nhận. Folder mới xuất hiện trong dropdown.
Thêm template vào folder
Chọn folder của bạn trong dropdown → bấm + Thêm template → đặt tên → nhập 4 card luận điểm → Lưu. Hoặc lưu nhanh từ form Tạo bản chào bằng nút 💾 Lưu trong box Lựa chọn Prefill.
Áp dụng khi tạo bản chào
Vào tab Tạo bản chào → box Lựa chọn Prefill (trên khu vực luận điểm) → chọn Prefill folder → chọn Prefill → bấm Áp dụng.
Xóa folder (có thể khôi phục trong 30 ngày)
Chọn folder cần xóa → bấm 🗑 Xóa folder → xác nhận trong hộp thoại (hiển thị số template sẽ bị xóa). Folder sẽ vào Thùng rác và có thể khôi phục trong 30 ngày bằng nút ↩ Khôi phục.

Thùng rác — Khôi phục folder đã xóa

Cuối tab Prefill có mục 🗑 Thùng rác. Các folder đã xóa xuất hiện tại đây kèm ngày xóa. Bấm ↩ Khôi phục để đưa folder và toàn bộ template về lại. Sau 30 ngày folder sẽ bị xóa vĩnh viễn.

💡

Chia sẻ trong team Mỗi folder lưu trên server — bạn có thể chọn folder của đồng nghiệp trong box Lựa chọn Prefill khi tạo bản chào để tham khảo template của họ. Muốn dùng lại thì lưu vào folder của bạn.

5

Ticker Universe

Danh sách mã cổ phiếu hỗ trợ

Tab này dành cho Admin. Xem và chỉnh sửa danh sách mã cổ phiếu nào được hiển thị trong form tạo bản chào. Cần mật khẩu Admin để chỉnh sửa.

localhost:8080

📊 Dashboard

📄 Tạo bản chào

📋 Prefill

🔎 Ticker Universe

Ticker Universe (42 tickers)

#	Mã CP	Tên công ty	Ngành
1	VIB	Ngân hàng VIB	Ngân hàng
2	MWG	The World Mobile	Bán lẻ
... 40 tickers khác

🔐 Chỉnh sửa Ticker Universe

[{"ticker":"VIB","name":"..."},...]

••••••

Lưu

🔐

Cần mật khẩu Admin để chỉnh sửa Mật khẩu Admin được cấu hình trong biến môi trường ADMIN_PASSWORD. Liên hệ người quản trị app để được cung cấp.

!

Xử lý sự cố

Các lỗi thường gặp và cách khắc phục

Triệu chứng	Nguyên nhân	Cách xử lý
❌ WealthNet / TCA không tải được	Token hết hạn (~12h)	Lấy token mới từ browser, nhập lại vào Dashboard
❌ "Không có rate cho XYZ 12T +15%"	Mã CP / combo kỳ hạn không có trong WealthNet	Thử combo khác, hoặc kiểm tra Ticker Universe xem mã này có được hỗ trợ không
⏳ Tạo PNG/PDF mất 10-30 giây	Playwright cần khởi động Chromium headless	Bình thường. Chờ thêm, không bấm lại.
❌ 504 PDF/PNG timeout	Server quá tải hoặc Playwright lỗi	Thử lại sau 30 giây. Nếu lỗi liên tục, báo Admin kiểm tra server.
🔴 Nút "📖 Tham khảo TCA" bị mờ	Chưa nhập Mã CP, hoặc TCA data chưa tải	Nhập Mã CP trước, đảm bảo Dashboard hiển thị TCA ✅
❌ Bản chào An Lãi không có cột trái phiếu	iConnect/iBond chưa được tải	Dashboard → 🔄 Tải lại data (đã bao gồm trái phiếu)

🛠️

Vẫn không được? Liên hệ team kỹ thuật Chụp màn hình lỗi và ghi rõ: bạn đang làm gì, mã CP nào, sản phẩm nào.

Hướng dẫn sử dụngiOptima Bản Chào Generator

Tổng quan

Lần đầu sử dụng — Nhập token

Bước 1 — Lấy token WealthNet

Bước 2 — Lấy token TC Analysis

Bước 3 — Dán token vào app

Dashboard

Giao diện Dashboard khi đã có token

Ý nghĩa các nút

Tạo bản chào

Hướng dẫn điền form

Box "Lựa chọn Prefill" trong form

Tải file sau khi tạo xong

iOptima Vượt Trội

iOptima Phòng Ngự

iOptima Cân Bằng

iOptima An Lãi

Prefill Templates

Quản lý Prefill folder

Thùng rác — Khôi phục folder đã xóa

Ticker Universe

🔐 Chỉnh sửa Ticker Universe

Xử lý sự cố

Hướng dẫn sử dụng
iOptima Bản Chào Generator