Tính năng
Hóa đơn điện tử

Hóa đơn điện tử

XCaphe tích hợp xuất hóa đơn điện tử hợp lệ thuế qua cổng M-Invoice (kết nối trực tiếp với Cục Thuế). Bạn đăng ký ký hiệu hóa đơn với cơ quan thuế, nhập thông tin vào XCaphe, sau đó hệ thống tự động xuất hóa đơn cho từng đơn hàng.

⚠️

Tính năng hóa đơn điện tử hiện đang trong giai đoạn beta giới hạn. Để được kích hoạt, liên hệ bộ phận hỗ trợ XCaphe.


Mô hình hoạt động

flowchart TD A["1️⃣ Đăng ký hóa đơn điện tử<br/>với cơ quan thuế"] B["2️⃣ Nhận thông tin API<br/>(username, password, MST, ký hiệu HĐ)"] C["3️⃣ Nhập thông tin<br/>vào XCaphe Dashboard"] D["4️⃣ XCaphe tự động<br/>xuất & ký HĐ điện tử"] E["5️⃣ Hóa đơn gửi<br/>đến cơ quan thuế (CQT)"] A --> B --> C --> D --> E style A fill:#e3f2fd style E fill:#e8f5e9 style C fill:#fff3e0
Quy trình tích hợp hóa đơn điện tử qua M-Invoice

Bắt đầu sử dụng

Đăng ký hóa đơn điện tử

Liên hệ cơ quan thuế (Chi cục Thuế địa phương) để đăng ký sử dụng hóa đơn điện tử. Bạn sẽ được cấp:

  • Mẫu số (templateNo) và Ký hiệu (serialNo) — VD: 01GTKT0/0012C26MLN
  • Tài khoản API M-Invoice: username + password

Kết nối vào XCaphe

Vào Cài đặt → Hóa đơn điện tử trong dashboard, điền đầy đủ thông tin:

TrườngMô tả
usernameTài khoản M-Invoice
passwordMật khẩu M-Invoice
taxCodeMã số thuế doanh nghiệp
templateNoMẫu số hóa đơn (VD: 01GTKT0/001)
serialNoKý hiệu hóa đơn — phải có chữ "M" ở vị trí thứ 4 (VD: 2C26MLN, 1C25MAA)
serviceUrlURL API M-Invoice do nhà cung cấp cấp

Nhấn Kiểm tra kết nối để xác nhận thông tin đúng.

Cấu hình thông tin doanh nghiệp

Điền tên công ty, địa chỉ đăng ký kinh doanh — các thông tin này sẽ in trên hóa đơn.

Gửi hóa đơn thử nghiệm

Dùng nút Gửi HĐ thử nghiệm để kiểm tra luồng trước khi vận hành chính thức.


Xuất hóa đơn

Tự động

Khi bật Tự động xuất HĐ, mỗi đơn hàng hoàn thành sẽ tự động tạo và ký hóa đơn điện tử, gửi thẳng đến cơ quan thuế.

Thủ công

  1. Vào Đơn hàng → chọn đơn cần xuất
  2. Nhấn Xuất hóa đơn
  3. Điền thông tin người mua:
    • Cá nhân (HH): Tên, địa chỉ (tùy chọn)
    • Doanh nghiệp (DN): Tên công ty, MST, địa chỉ (bắt buộc)
  4. Xác nhận — hóa đơn được ký và gửi CQT

Tra cứu và tải lại hóa đơn

  1. Vào mục Hóa đơn trên menu chính
  2. Tìm theo số đơn, ngày, hoặc MST khách hàng
  3. Nhấn Tải PDF để lưu về máy, hoặc Gửi lại để gửi lại cho khách

Câu hỏi thường gặp

Q: Hóa đơn bị lỗi khi xuất thì xử lý thế nào?

Hệ thống tự động retry 3 lần. Nếu vẫn thất bại, hóa đơn ở trạng thái "Lỗi" — bạn có thể thử lại thủ công từ màn hình quản lý hóa đơn.

Q: Ký hiệu hóa đơn cần có chữ "M" ở đâu?

Ký hiệu (serialNo) phải có chữ "M"vị trí thứ 4 theo quy định cổng M-Invoice. Ví dụ đúng: 2C26MLN, 1C25MAA. Nếu sai, hóa đơn sẽ bị từ chối.

Q: Khách yêu cầu hóa đơn sau khi đã thanh toán thì làm thế nào?

Vào đơn hàng tương ứng và xuất hóa đơn thủ công. Không có hạn chế thời gian.

Q: Có thể xuất hóa đơn gộp nhiều đơn không?

Hiện tại mỗi đơn hàng tương ứng một hóa đơn. Tính năng hóa đơn gộp đang trong roadmap.

Q: Cần chuẩn bị gì trước khi đăng ký?

Bạn cần: Mã số thuế (MST) doanh nghiệp, tên công ty, địa chỉ đăng ký kinh doanh. Nếu chưa có MST, liên hệ cơ quan thuế để đăng ký trước.

⚠️

Hóa đơn điện tử chỉ hợp lệ về mặt thuế khi doanh nghiệp đã đăng ký với cơ quan thuế và sử dụng đúng ký hiệu hóa đơn được cấp phép.