Khắc phục sự cố

Connector#

VCB OAuth báo lỗi 403 / "IP not allowed"#

Nguyên nhân: IP request ngoài Việt Nam.

Giải pháp:

• Production KOPA: tự dùng proxy VN, không cần làm gì.
• Self-host / dev local: dùng VPN có exit node VN.

Token Misa hết hạn#

Triệu chứng: Hóa đơn ngừng kéo về.

Giải pháp:

1. Vào Misa → Cài đặt → API Token → renew.
2. Dán token mới vào Settings → Connectors.

Google Sheets "permission denied"#

Nguyên nhân: Service account của KOPA bị remove khỏi sheet.

Giải pháp:

1. Mở sheet → Share.
2. Add email service account (xem trong Settings → Connectors → Spreadsheets).
3. Cấp quyền Editor (nếu KOPA cần write) hoặc Viewer.

AI Agent#

AI nói không có quyền truy cập tool#

Nguyên nhân: User role không có quyền dùng tool đó.

Giải pháp:

• Kiểm tra role tại Settings → Permissions.
• Owner/Admin assign quyền phù hợp.

AI trả lời sai số liệu#

Bước 1: Mở Trace để xem AI lấy data từ đâu.

Có 3 trường hợp:

1. Tool gọi sai tham số — sửa prompt rõ ràng hơn.
2. Data trong sổ sai — sửa sổ rồi AI đúng.
3. Connector chưa sync — bấm Sync now.

AI chậm#

Giải pháp:

• Bật ít skill hơn (Settings → Skills).
• Tắt skill không dùng.
• Dùng model nhanh hơn (Auto thường ổn).

AI loop vô hạn#

Triệu chứng: Trace > 50 tool call.

Giải pháp:

• Bấm Stop ngay.
• Report bug tới support.
• Workaround: đặt limit max-turns trong skill config.

Sổ kế toán#

Bút toán không cân#

Nguyên nhân: Tổng Nợ ≠ Tổng Có.

Giải pháp:

1. Mở bút toán → kiểm tra mọi dòng.
2. Tìm ô bị thiếu giá trị hoặc sai dấu.
3. Kế toán trưởng có thể "force-balance" với note giải thích (audit log ghi).

Số dư đầu kỳ không khớp BCTC năm trước#

Giải pháp:

1. Mở Settings → Periods → Số dư đầu kỳ.
2. Kiểm tra từng tài khoản.
3. Sửa thủ công nếu cần (chỉ Owner).

Sai phân loại NCC#

Giải pháp:

1. Mở Master Data → Đối tượng → tìm NCC.
2. Sửa thông tin (loại NCC, mã thuế, …).
3. Bút toán tương lai sẽ tự đúng. Bút toán cũ giữ nguyên trừ khi sửa từng cái.

Khóa kỳ#

Không cho khóa kỳ vì có blocker#

Giải pháp:

• Đọc danh sách blocker, xử lý từng cái.
• Hoặc bấm Auto-fix cho 4 mục KOPA tự fix được.

Cần mở lại kỳ đã khóa#

Giải pháp:

1. Owner / Admin vào Settings → Periods → Reopen.
2. Nhập lý do bắt buộc.
3. Yêu cầu 2 chữ ký.
4. Sau khi sửa, khóa lại bình thường.

Hiệu năng#

Trang Documents load chậm#

Nguyên nhân: Quá nhiều chứng từ trong filter.

Giải pháp:

• Filter theo kỳ ngắn hơn.
• Dùng Saved view để KOPA pre-cache.

Sync ngân hàng chậm#

Nguyên nhân: Provider rate limit.

Giải pháp:

• Đợi 15 phút.
• Hoặc upgrade KOPA plan có dedicated rate quota.

Truy cập#

Không vào được KOPA sau khi reset password#

Giải pháp:

• Kiểm tra email reset có hết hạn không (1 giờ).
• Request reset lại.
• Nếu vẫn lỗi: liên hệ support@getkopa.com.

Mất 2FA#

Giải pháp:

• Dùng 1 trong 8 mã khôi phục đã lưu.
• Nếu mất luôn mã khôi phục: liên hệ support, cần verify danh tính.

Tài chính KOPA#

Hóa đơn KOPA hằng tháng#

Vào Settings → Billing để xem invoice.

Đổi gói#

Settings → Billing → Plans → upgrade/downgrade.

Liên hệ support#

• Email: support@getkopa.com
• Telegram: @KopaSupport
• In-app: Bấm ? ở header → "Contact support".
• SLA: 24h cho gói Starter, 4h cho Business, 1h cho Enterprise.