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

KOPA tích hợp với 6 nhà cung cấp hóa đơn điện tử phổ biến tại Việt Nam.

Misa MeInvoice#

Cách kết nối#

1. Vào MeInvoice → Cài đặt → API Token → tạo token.
2. Trong KOPA: Connectors → + Thêm → Misa MeInvoice → dán token + MST.
3. Bấm Test → KOPA pull thử 5 hóa đơn gần nhất.

Đồng bộ#

• Webhook real-time khi có hóa đơn mới (đầu vào / đầu ra).
• Pull lịch sử 12 tháng khi mới connect.

FPT eInvoice#

• Yêu cầu API access từ FPT (request qua tài khoản FPT).
• Pull mỗi 15 phút.

VNPT Invoice#

• Authentication qua VNPT API key.
• Real-time cho hóa đơn đầu ra.
• Pull batch cho hóa đơn đầu vào.

Viettel SInvoice#

• API key + Tax Code.
• Pull mỗi 30 phút.

EasyInvoice (Hilo)#

• OAuth flow.
• Real-time webhook.

iHoaDon#

• API key đơn giản.
• Pull mỗi giờ.

Phát hành hóa đơn từ KOPA#

KOPA có thể phát hành hóa đơn đầu ra qua các provider trên:

1. Trong Sales module → tạo dòng hóa đơn → trạng thái "Draft".
2. Bấm Phát hành.
3. KOPA gọi API provider để phát hành chính thức.
4. Trạng thái → "Published" + số HĐ chính thức từ provider.
5. Bút toán doanh thu được tạo.

Yêu cầu: Connector phải có quyền publish (không phải read-only).

Theo dõi hóa đơn#

Sau khi phát hành:

• KOPA theo dõi trạng thái: Draft / Published / Cancelled / Adjusted.
• Hóa đơn cancel/adjust sẽ tạo bút toán reverse tương ứng.
• Audit log đầy đủ.

Mapping mã thuế#

Khi import hóa đơn, KOPA cần map mã thuế:

• VAT 0% → TK 3331-0.
• VAT 5% → TK 3331-5.
• VAT 8% → TK 3331-8 (giảm theo Nghị quyết 142/2024/QH15).
• VAT 10% → TK 3331-10.
• Không chịu VAT → không hạch toán VAT.

KOPA tự gợi ý theo loại hàng hóa/dịch vụ.

Vấn đề thường gặp#

• Token hết hạn — re-auth từ portal provider.
• MST không khớp — kiểm tra MST trong KOPA Settings → Công ty.
• Hóa đơn duplicate — nếu provider gửi cùng hóa đơn 2 lần, KOPA dedupe theo (số HĐ + ngày + MST + tổng tiền).