Tích hợp các nhà cung cấp Hoá đơn điện tử

Hệ thống OVIRO cung cấp giải pháp tích hợp tự động với các nhà cung cấp dịch vụ Hoá đơn điện tử (e-Invoice) hàng đầu tại Việt Nam theo chuẩn Nghị định 123/2020/NĐ-CP và Thông tư 78/2021/TT-BTC. Doanh nghiệp có thể thiết lập phát hành hóa đơn tự động từ đơn hàng bán lẻ POS, đơn đặt hàng trực tuyến (Website/App) hoặc tạo phiếu yêu cầu xuất hóa đơn GTGT đồng bộ trực tiếp với cơ quan thuế.

Vị trí truy cập trong Admin

Để mở màn hình cấu hình thuế và tích hợp hóa đơn điện tử, truy cập theo đường dẫn:

• Menu: Cửa hàng > Cài đặt thuế & hoá đơn
• Đường dẫn trực tiếp: http://localhost:3010/#/setting-sale/tax (hoặc #/setting-sale/tax)

Màn hình cấu hình gồm 3 tab chức năng:

1. Thuế suất: Cấu hình mức thuế suất VAT mặc định cho toàn hệ thống.
2. Tích hợp Hoá đơn điện tử: Cấu hình thông số API đối tác phát hành hóa đơn và thông tin bên bán.
3. Phương pháp xuất hoá đơn: Lựa chọn công thức tính giá trị xuất hóa đơn (Price Final, Price Sell, Price Sell After Discount) và tùy biến theo từng nguồn đơn hàng.

---

1. Tổng quan các nhà cung cấp hóa đơn điện tử hỗ trợ

Tại tab Tích hợp Hoá đơn điện tử, mục Chọn nhà cung cấp dịch vụ hoá đơn điện tử hỗ trợ 4 lựa chọn:

---

2. Hướng dẫn chi tiết cấu hình từng nhà cung cấp

2.1. MISA meInvoice

MISA meInvoice là đối tác được sử dụng phổ biến nhất trên OVIRO với cơ chế xác thực kép (API Application Key + Tài khoản người dùng MISA) và công cụ kiểm tra kết nối tức thì.

Bảng thông số cấu hình MISA:

Công cụ kiểm tra thông tin kết nối:

Phía dưới biểu mẫu cấu hình có khối Công cụ hỗ trợ liên quan đến tích hợp:

• Bấm nút Kiểm tra thông tin kết nối để hệ thống gửi yêu cầu xác thực thử nghiệm đến máy chủ MISA.
• (Lưu ý: Bạn cần nhấn nút Lưu cài đặt trước khi bấm kiểm tra để hệ thống lưu lại các thông số mới nhất vào cơ sở dữ liệu).
• Khi kết nối thành công, hệ thống sẽ hiện thông báo màu xanh xác nhận chứng thư số và thông tin tài khoản hợp lệ.

---

2.2. Viettel S-Invoice

Tích hợp với dịch vụ hóa đơn điện tử Viettel S-Invoice của Tập đoàn Công nghiệp – Viễn thông Quân đội Viettel.

Bảng thông số cấu hình Viettel:

---

2.3. Matbao Invoice

Tích hợp với giải pháp hóa đơn điện tử Matbao Invoice (Mắt Bão).

Bảng thông số cấu hình Matbao:

---

2.4. -Không tích hợp- (Tự xuất ngoài hệ thống)

Dành cho doanh nghiệp tự quản lý và xuất hóa đơn thủ công hoặc sử dụng chữ ký số cứng (USB Token) trên phần mềm kế toán độc lập.

• Đặc điểm: Khi chọn -Không tích hợp-, hệ thống ẩn toàn bộ các ô nhập tham số API.
• Ứng dụng vận hành:
  • Nhân viên bán hàng và thu ngân vẫn có thể tạo Phiếu yêu cầu xuất hoá đơn trên đơn hàng để ghi nhận đầy đủ thông tin bên mua (Tên công ty, MST, Địa chỉ, Email nhận).
  • Kế toán căn cứ vào danh sách Chờ xuất hoá đơn và Yêu cầu xuất hoá đơn để mở phần mềm ngoài xuất hóa đơn, sau đó cập nhật số hóa đơn thực tế vào hệ thống OVIRO.

---

3. Cấu hình Thông tin cửa hàng người bán (Seller Info)

Khối THÔNG TIN CỬA HÀNG NGƯỜI BÁN nằm ở nửa dưới của tab Tích hợp Hoá đơn điện tử. Thông tin này bắt buộc phải chính xác vì sẽ được nạp trực tiếp vào dữ liệu bên bán (Seller Info) khi tạo và ký hóa đơn điện tử gửi cơ quan thuế:

[!IMPORTANT] Mã số thuế bên bán phải trùng khớp 100% với MST của tài khoản đối tác hóa đơn điện tử (MISA / Viettel / Mắt Bão). Nếu MST không khớp, nhà cung cấp sẽ từ chối lệnh tạo hóa đơn và trả về lỗi TaxCode mismatch.

---

4. Cấu hình Thuế suất mặc định (Tab Thuế suất)

Tại tab Thuế suất, doanh nghiệp thiết lập tỷ lệ thuế GTGT áp dụng chung trên toàn hệ thống:

• Thuế suất VAT mặc định cho Sản phẩm / Danh mục: Nhập tỷ lệ thuế (ví dụ: 8 % hoặc 10 %).
• Quy tắc ưu tiên tính thuế suất của sản phẩm:

---

5. Phương pháp xuất hoá đơn (Tab Phương pháp xuất hoá đơn)

Tab Phương pháp xuất hoá đơn xác định công thức chọn giá trị trên đơn hàng để ghi nhận vào giá trị hóa đơn điện tử:

5.1. Ba phương pháp tính giá trị mặc định

1. Giá trị thanh toán thực tế (Price Final) - Khuyến nghị:
   • Đặc điểm: Hóa đơn thể hiện đúng số tiền thực thu của khách hàng (sau khi đã tính phí ship và giảm trừ các khoản khuyến mãi, voucher).
   • Công thức: price_final = price_sell + price_shipping - price_discount + price_tax.
2. Giá trị hàng bán thuần (Price Sell):
   • Đặc điểm: Hóa đơn chỉ tính tổng tiền hàng thuần theo giá niêm yết ban đầu của các sản phẩm, không cộng phí giao hàng và không trừ chiết khấu.
   • Công thức: Tổng của (đơn giá × số lượng) cho tất cả sản phẩm trong đơn.
3. Giá trị hàng bán sau chiết khấu (Price Sell After Discount):
   • Đặc điểm: Hóa đơn bằng tổng tiền hàng trừ đi các khoản giảm giá trực tiếp trên sản phẩm, nhưng không bao gồm phí vận chuyển.
   • Công thức: price_sell - price_discount.

5.2. Tuỳ biến theo nguồn đơn hàng

Doanh nghiệp có thể thiết lập quy tắc tính giá trị xuất hóa đơn khác nhau tùy theo nguồn đơn:

• Ví dụ: Đơn bán tại quầy POS áp dụng Giá trị thanh toán thực tế; Đơn bán sỉ qua Website áp dụng Giá trị hàng bán sau chiết khấu.
• Bấm chọn Nguồn đơn hàng > Chọn Phương pháp > Bấm + Thêm cấu hình.

---

6. Luồng phát hành hoá đơn điện tử từ đơn hàng

Sau khi đã hoàn tất cài đặt, hóa đơn điện tử sẽ được phát hành qua các kênh sau:

1. Từ màn hình đơn hàng / POS:
   • Khi tạo đơn, thu ngân bật tùy chọn Xuất hóa đơn VAT và nhập thông tin người mua (Tên công ty, MST, Địa chỉ, Email).
   • Hệ thống tự động tạo Phiếu yêu cầu xuất hoá đơn.
2. Từ danh sách Chờ xuất hoá đơn & Yêu cầu xuất hoá đơn:
   • Mở Phiếu yêu cầu xuất hoá đơn.
   • Kiểm tra các dòng hàng, đơn giá, chiết khấu và tiền thuế.
   • Bấm Khởi tạo hoá đơn điện tử để truyền dữ liệu sang hệ thống nhà cung cấp.
   • Bấm Kiểm tra trạng thái hoá đơn để đồng bộ trạng thái cấp mã từ Tổng cục Thuế.

---

7. Xử lý sự cố thường gặp