Chuyển tới nội dung chính

Luồng đồng bộ danh mục

Đảm bảo tính nhất quán dữ liệu giữa hệ thống đối tác và Simplize, tạo nền tảng chính xác cho các tính năng phân tích và cá nhân hóa.

  • Đồng bộ cho một người dùng: Dùng khi user thao tác real-time (vừa đăng nhập, vừa mở app...), xử lý ngay lập tức.

  • Đồng bộ hàng loạt cho nhiều người dùng: Dùng khi đối tác cần sync số lượng lớn user (end of day, scheduled job...), xử lý bất đồng bộ.

Luồng Tích Hợp Danh Mục

Chú thích các bước:



Các kịch bản lỗi hay gặp khi đồng bộ danh mục

1. Danh mục chưa được sync lần đầu (chưa tạo danh mục)​

Đối tác gửi giao dịch mua CTG cho user nhưng chưa tạo danh mục trên Simplize

Kết quả:

  • ⚠️ Hệ thống trả về lỗi PORTFOLIO_NOT_SYNCED vì không tìm thấy danh mục.
  • ✅ Đối tác cần gọi API Đồng bộ danh mục hoặc Đồng bộ hàng loạt trước để tạo danh mục, sau đó mới đồng bộ giao dịch.

2. Bán/chuyển nhượng vượt quá số lượng đang nắm giữ​

Danh mục của user đang nắm giữ 100 cổ phiếu CTG. Đối tác gửi lệnh bán 200 cổ phiếu CTG — vượt quá số lượng đang có.

Kết quả:

  • ⚠️ Hệ thống trả về lỗi TRANSACTION_INSUFFICIENT_VOLUME vì số lượng bán (200) vượt quá số dư hiện có (100) của CTG.
  • ✅ Đối tác cần kiểm tra lại dữ liệu giao dịch, đảm bảo đã đồng bộ đầy đủ các giao dịch mua trước đó để số dư chính xác trước khi gửi lệnh bán.

3. Giao dịch bị trùng partnerTransactionId​

Đối tác đã đồng bộ thành công giao dịch mua CTG với partnerTransactionId = "TXN_BUY_001". Sau đó gửi tiếp giao dịch mua HPG nhưng vẫn dùng cùng partnerTransactionId = "TXN_BUY_001".

Kết quả:

  • ⚠️ Hệ thống trả về lỗi TRANSACTION_CONFLICT vì partnerTransactionId = "TXN_BUY_001" đã tồn tại từ giao dịch mua CTG trước đó.
  • ✅ Đối tác cần đảm bảo mỗi giao dịch có một partnerTransactionId riêng biệt. Nếu muốn cập nhật giao dịch cũ, sử dụng forceUpdate: true.

4. Giao dịch có ngày ≤ ngày giao dịch đầu tiên​

Đối tác gửi một giao dịch cũ từ ngày 14/03/2024 hoặc trong ngày 15/03/2024 (Cutoff Date của user là 15/03/2024).

Kết quả:

  • ⚠️ Giao dịch bị hệ thống từ chối ghi nhận (action: SKIPPED) vì ngày giao dịch nằm trong hoặc trước mốc số dư ban đầu.
  • ✅ Danh mục và NAV không thay đổi.

5. Mã cổ phiếu nắm giữ không tồn tại trên hệ thống​

Đối tác gửi giao dịch mua cổ phiếu với mã ticker XYZ nhưng mã này không tồn tại hoặc chưa được hỗ trợ trên hệ thống Simplize.

Kết quả:

  • ⚠️ Hệ thống trả về lỗi TRANSACTION_TICKER_NOT_FOUND - Mã chứng khoán không tồn tại..
  • ✅ Đối tác cần kiểm tra lại mã ticker trước khi đồng bộ, đảm bảo sử dụng đúng mã niêm yết trên sàn chứng khoán Việt Nam.