← Tất cả tích hợp

Kết nối MeInvoice với omniVN

Có thể kết nối

Kết nối MeInvoice từ Invoice: taxcode (MST), username, password và App ID do MISA cấp cho doanh nghiệp.

Kết nối MeInvoiceTạo tài khoản và làm theo hướng dẫn bên dưới — dùng thử 14 ngày.

Giới hạn hiện tại

Những điểm này ảnh hưởng đến khả năng kết nối hoàn chỉnh.
  • App ID do MISA cấp — cần liên hệ MISA nếu chưa có; omniVN không dùng App ID chung của server.
  • Không có search theo khoảng ngày; cần transaction ID hoặc ref ID.
  • SignType / IsInvoiceWithCode chưa được trả về sau connect (Connectors cần persist trên connection).

Tổng quan

MeInvoice (MISA) dùng taxcode, username, password và appid. omniVN có trang Invoice → tab MeInvoice để kết nối và xác thực token. Tra cứu hóa đơn theo transaction ID / ref ID (không có search theo khoảng ngày).

Điều kiện trước khi bắt đầu

  • Tài khoản MeInvoice đang hoạt động (sandbox hoặc live).
  • Mã số thuế (MST/taxcode), tên đăng nhập và mật khẩu MeInvoice.
  • App ID do MISA cấp cho doanh nghiệp của bạn (bắt buộc).

Các bước lấy credential

1. Chuẩn bị thông tin tài khoản

Thu thập mã số thuế (taxcode/MST), tên đăng nhập và mật khẩu MeInvoice.

2. Lấy App ID

App ID do MISA cấp cho ứng dụng tích hợp. Có thể dán vào form omniVN, hoặc để trống nếu deployment đã cấu hình MISA_APP_ID.

3. Kết nối trong omniVN

Vào Invoice → tab MeInvoice → điền Tax code (MST), Username, Password, App ID (nếu cần) → Connect MeInvoice. Backend xác thực token rồi lưu credential đã mã hóa.

4. Tra cứu hóa đơn

Chọn connection MeInvoice → nhập transaction ID và/hoặc ref ID → Look up invoices. MeInvoice không hỗ trợ search lịch sử theo khoảng ngày.

Ánh xạ credential với omniVN

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.
Field omniVNTên trong tài liệu officialBắt buộcLấy từ đâu
Tax code (MST)Mã số thuếBắt buộcuser_entered
UsernameTên đăng nhậpBắt buộcuser_entered
PasswordMật khẩuBắt buộcuser_entered
App IDappidBắt buộcuser_entered

MISA cấp cho doanh nghiệp của bạn. Bắt buộc trên form Invoice; omniVN không dùng App ID chung của server.

taxcode → Tax code (MST) / externalAccountId; username → Username; password → Password; appid → App ID (bắt buộc).

Vòng đời token

MeInvoice trả về token sau khi đăng nhập. omniVN xác thực lúc connect và khi lookup; thời hạn theo cấu hình MeInvoice.

Nguồn chính thức

MeInvoice API - Login
doc.meinvoice.vn·Công khai·Đã kiểm chứng 2026-08-29