Tích hợp Hóa đơn điện tử MISA meinvoice
Hướng dẫn cấu hình kết nối, đồng bộ và phát hành hóa đơn điện tử tự động qua API với nhà cung cấp MISA meinvoice.
Tài liệu này hướng dẫn cách thiết lập cấu hình, luồng dữ liệu nghiệp vụ và các lưu ý kỹ thuật khi tích hợp hệ thống hóa đơn điện tử MISA meinvoice trên OVIRO Store.
Vị trí menu admin
Để cấu hình tích hợp MISA meinvoice, truy cập: Cửa hàng > Cài đặt thuế & hoá đơn > tab Tích hợp Hoá đơn điện tử
1. Cấu hình kết nối API với MISA meinvoice
Tại phần Tích hợp nhà cung cấp hóa đơn điện tử, chọn nhà cung cấp MISA meinvoice và thiết lập các thông tin kết nối API sau:
| Trường thông tin | Loại dữ liệu | Giải thích | Ví dụ |
|---|---|---|---|
| Đường dẫn API (BASE_URL) để kết nối | URL | Endpoint API tích hợp do MISA cấp (kết thúc không có dấu /). | https://testapi.meinvoice.vn/api/integration/webapp/ |
| Client ID / API Username | Email / String | Tài khoản kết nối API được cấp bởi MISA meinvoice. | [email protected] |
| Client Secret / API Password | Password/String | Mật khẩu kết nối API đi kèm tài khoản trên. | ******** |
| Mẫu Hoá đơn | UUID / String | Mã định danh mẫu hóa đơn (InvoiceTemplateID) được thiết lập trên portal MISA. | 61d72791-8db0-40cf-ba3c-12b3d061fa97 |
| Ký hiệu hoá đơn | String | Ký hiệu phát hành của hóa đơn (InvSeries). | 1C25THG |
Công cụ hỗ trợ
- Nút Kiểm tra thông tin kết nối: Kiểm tra tính chính xác của các thông tin kết nối API trước khi áp dụng.
2. Thông tin cửa hàng người bán
Thông tin này dùng làm dữ liệu người bán trên hóa đơn điện tử khi phát hành:
- Tên cửa hàng người bán: Tên pháp nhân/doanh nghiệp người bán (ví dụ:
CÔNG TY TNHH HITECH GLOBAL). - Mã số thuế (Tax Code): Mã số thuế của doanh nghiệp (ví dụ:
2222222222-322). Trường này bắt buộc và được dùng để gửi kèm trong header yêu cầu API của MISA. - Địa chỉ cửa hàng người bán: Địa chỉ đăng ký kinh doanh chính thức.
Sau khi nhập đầy đủ thông tin, nhấn nút Lưu cài đặt ở góc dưới cùng bên phải để hoàn tất.
3. Các lưu ý vận hành quan trọng
Chức năng hủy hóa đơn (Cancel Remote) không hỗ trợ trên giao diện OVIRO: Hiện tại API tích hợp MISA meinvoice chưa hỗ trợ xóa/hủy hóa đơn trực tiếp từ admin OVIRO. Mọi thao tác hủy, thay thế hoặc điều chỉnh hóa đơn điện tử MISA cần được thực hiện thủ công trực tiếp trên trang quản trị dịch vụ MISA meinvoice của doanh nghiệp.
Kiểm tra kết nối thất bại: Nếu việc kiểm tra kết nối báo lỗi, hãy kiểm tra lại thông tin Mã số thuế người bán và các cặp khóa Client ID / Client Secret được cấu hình chính xác và không có khoảng trắng thừa.