← 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; App ID tùy chọn nếu server đã có MISA_APP_ID.

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ó và server chưa có MISA_APP_ID.
  • 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. Omni0 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 — hoặc biến môi trường MISA_APP_ID trên Convex.

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 Omni0, hoặc để trống nếu deployment đã cấu hình MISA_APP_ID.

3. Kết nối trong Omni0

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 IDappidTùy chọnoperator_managed

MISA cấp. Form Invoice chấp nhận App ID tùy chọn; để trống nếu server đã có MISA_APP_ID.

taxcode → Tax code (MST) / externalAccountId; username → Username; password → Password; appid → App ID (tùy chọn nếu có MISA_APP_ID).

Vòng đời token

MeInvoice trả về token sau khi đăng nhập. Omni0 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