Hướng dẫn này trình bày cách kết nối MISA meInvoice với HexaSync Automation Engine cho một công ty trên MISA meInvoice. HexaSync đọc mẫu hóa đơn (mẫu số, ký hiệu) của công ty từ meInvoice, gồm cả mẫu đã phát hành và chưa phát hành. Hướng dẫn áp dụng khi bạn kết nối lần đầu hoặc cần cấp lại quyền cho Connector App đang dùng.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để đăng nhập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Mã số thuế của công ty, đúng như trong MISA meInvoice, kể cả phần đuôi chi nhánh nếu có (ví dụ
0123456789-001). - Một tài khoản đăng nhập meInvoice (email hoặc số điện thoại) và mật khẩu. Tài khoản này cần quyền xem hóa đơn trong meInvoice.
Lưu ý:
- Nếu muốn thử trước, hãy dùng công ty thử nghiệm trên
testapp.meinvoice.vnvà chọn môi trường Test.- Môi trường Production là dữ liệu thật của công ty trên app.meinvoice.vn.
- Trong HexaSync, Connector App là ứng dụng kết nối với MISA meInvoice. Bạn không cần xin AppID của MISA, vì HexaSync kết nối bằng AppID tích hợp do MISA cấp cho HexaSync.
Phần 1: Cấp quyền kết nối MISA meInvoice trên HexaSync
Bước 1: Đăng nhập HexaSync
- Đăng nhập HexaSync Automation Engine bằng tài khoản Beehexa.
Bước 2: Bắt đầu kết nối MISA meInvoice
- Mở trang thiết lập kết nối MISA meInvoice trên HexaSync.
- Trên màn hình Check connection details, chọn Connect tại mục MISA meInvoice.
Bước 3: Nhập thông tin đăng nhập meInvoice và cấp quyền
- Ở Environment, chọn Production cho công ty thật trên app.meinvoice.vn, hoặc Test cho công ty thử nghiệm trên testapp.meinvoice.vn.
- Điền Tax Code (mã số thuế), Email or Phone Number (email hoặc số điện thoại đăng nhập meInvoice) và Password, rồi chọn Continue.
- HexaSync đăng nhập meInvoice để kiểm tra và lưu thông tin dưới dạng mã hóa. Nếu có báo lỗi, xem Phần 4.
- Chờ thông báo cấp quyền thành công: MISA meInvoice có trạng thái Connected. Chọn Create MISA meInvoice Connector.
Bước 4: Đặt tên MISA meInvoice Connector App
- Trên màn hình Enter Connector App Name, HexaSync gợi ý tên Connector App theo tên công ty lấy từ meInvoice, ví dụ [BEEHEXA CORP] MISA meInvoice Connector. Nếu không lấy được tên công ty, tên gợi ý dùng mã số thuế. Bạn có thể sửa tên nếu cần.
- Kiểm tra nội dung trong trường Description, rồi chọn Continue.
- Quá trình khởi tạo Connector App mất vài phút. Giữ nguyên trang trong thời gian này.
Bước 5: Hoàn tất khởi tạo MISA meInvoice Connector App
Sau khi khởi tạo, hệ thống tự chuyển bạn đến MISA meInvoice Connector App vừa tạo. Connector App có một tác vụ [MeInvoice] Invoice Templates để lấy mẫu số và ký hiệu hóa đơn của công ty. Bạn có thể xem lại Connector App trong Connector Apps.
Tiếp theo, hãy kiểm tra kết nối và dữ liệu theo Phần 3.
Phần 2: Cấp lại quyền kết nối MISA meInvoice
Bạn cần cấp lại quyền khi mật khẩu tài khoản meInvoice đã đổi, khi tài khoản bị khóa rồi mở lại, hoặc khi tác vụ Invoice Templates báo lỗi đăng nhập.
Lưu ý: Cập nhật trên đúng dòng kết nối đang dùng. Không tạo Connector App hoặc kết nối mới để xử lý lỗi quyền truy cập.
Bước 1: Mở Settings của Connector App
- Mở Connector Apps, chọn MISA meInvoice Connector App tương ứng. Nhấn chọn Settings > Integration Apps & Credentials.
Bước 2: Chọn Re-authorize
- Tìm dòng MISA meInvoice và chọn Re-authorize.
Bước 3: Nhập lại thông tin
- Chọn đúng Environment, nhập cùng mã số thuế, tài khoản và mật khẩu mới, rồi chọn Continue.
- Với cùng mã số thuế, HexaSync cập nhật kết nối cũ, không tạo kết nối mới. Kiểm tra lại theo Phần 3.
Phần 3: Kiểm tra kết nối và dữ liệu
Kiểm tra thông tin kết nối
Mở Connector App và vào Settings > Integration Apps & Credentials:
- MISA meInvoice: trạng thái Connected.
- HexaSync: Connector được tạo thành công.
Kiểm tra dữ liệu
- Tác vụ [MeInvoice] Invoice Templates lấy mẫu hóa đơn lần đầu ngay khi Connector App khởi động, sau đó chạy mỗi giờ. Kiểm tra mẫu số và ký hiệu hóa đơn của năm hiện tại khớp với meInvoice.
- Mỗi mẫu cho biết đã phát hành hay chưa phát hành, và còn được sử dụng hay đã ngừng.
Phần 4: Lỗi thường gặp và cách xử lý
| Thông báo | Cách xử lý |
|---|---|
| meInvoice Rejected The Sign-In: không có công ty với mã số thuế này | Kiểm tra mã số thuế (kể cả đuôi chi nhánh như -001) và Environment, rồi chọn Fix my details and try again. |
| meInvoice Rejected The Sign-In: tài khoản không thuộc công ty này | Tài khoản đăng nhập không phải người dùng của công ty có mã số thuế đã nhập. Kiểm tra lại mã số thuế, hoặc nhờ quản trị viên meInvoice thêm tài khoản vào công ty đó. |
| meInvoice Rejected The Sign-In: sai email, số điện thoại hoặc mật khẩu | Thử đăng nhập meInvoice trực tiếp bằng thông tin đó, rồi chọn Fix my details and try again để nhập lại. |
| meInvoice Rejected The Sign-In: meInvoice từ chối kết nối của HexaSync | Đây không phải lỗi của bạn. Gửi ảnh chụp màn hình đến support@beehexa.com. |
| The name already exists | Tên Connector App đã được dùng. Chọn tên khác. |
| Connector App Quota Reached | Tài khoản đã dùng hết số Connector App cho phép. Liên hệ support@beehexa.com để tăng giới hạn. |
| Tác vụ Invoice Templates báo lỗi đăng nhập meInvoice | Khi mật khẩu tài khoản meInvoice đã đổi hoặc tài khoản bị khóa, cấp lại quyền theo Phần 2. |
Với các trường hợp khác, hãy gửi thông tin theo Phần 6 đến support@beehexa.com.
Phần 5: Bảo vệ thông tin và ngừng kết nối
Nhập mật khẩu meInvoice trực tiếp trên màn hình cấp quyền của HexaSync. Không đưa mật khẩu vào nhóm chat, email thông thường hoặc ảnh chụp báo lỗi.
Để ngừng kết nối:
- Thông báo Beehexa tắt lịch chạy và ngắt kết nối trong HexaSync.
- Đổi mật khẩu tài khoản meInvoice đã dùng để kết nối.
Lưu ý: Tắt lịch chạy không đồng nghĩa đã thu hồi quyền. Ngừng kết nối không tự xóa dữ liệu đã lấy về HexaSync.
Phần 6: Thông tin gửi Beehexa khi cần hỗ trợ
- Mã số thuế, môi trường (Production hoặc Test), tên Connector App và loại kết nối: MISA meInvoice.
- Bước đang thực hiện, thời điểm xảy ra lỗi, thông báo lỗi và phần Technical details nếu có.
- Thay đổi gần đây về tài khoản hoặc phân quyền trong meInvoice.
Ảnh chụp cần che mật khẩu và dữ liệu nhạy cảm. Liên hệ đầu mối Beehexa đang hỗ trợ doanh nghiệp, hoặc support@beehexa.com.
Phần 7: Câu hỏi thường gặp
HexaSync có ghi hoặc sửa dữ liệu trên MISA meInvoice không?
Không. MISA meInvoice Connector App chỉ đọc mẫu số và ký hiệu hóa đơn của công ty, gồm mẫu đã phát hành và chưa phát hành. HexaSync không tạo, sửa hay phát hành hóa đơn trên meInvoice.
Làm thế nào để kết nối MISA meInvoice trên HexaSync?
Quy trình gồm năm bước: đăng nhập HexaSync, mở trang thiết lập và chọn Connect, nhập mã số thuế và tài khoản meInvoice, đặt tên Connector App, rồi mở Connector App để kiểm tra.
Tôi có cần xin AppID của MISA không?
Không. HexaSync dùng AppID tích hợp do MISA cấp cho HexaSync. Bạn chỉ cần mã số thuế và một tài khoản đăng nhập meInvoice.
Một tài khoản meInvoice dùng cho nhiều công ty được không?
Được. Nếu tài khoản là người dùng của nhiều công ty hoặc chi nhánh, hãy kết nối từng mã số thuế riêng. Mỗi mã số thuế là một kết nối.
Dữ liệu được cập nhật bao lâu một lần?
Mẫu hóa đơn được lấy lần đầu ngay khi Connector App khởi động, sau đó cập nhật mỗi giờ.
Tham khảo thêm: Chính sách bảo mật của Beehexa và Chính sách hỗ trợ của Beehexa.