Invoice Hub là cổng hóa đơn tập trung của TCONNECT (dựa trên 1Invoice) giúp đấu nối nhiều nhà cung cấp hóa đơn điện tử qua một API duy nhất, thay vì tích hợp riêng lẻ với từng hãng như MISA, Viettel, VNPT, FPT, M-Invoice.

Invoice Hub hoạt động theo mô hình nào?

Hub theo mô hình adapter một-API-nhiều-nhà-cung-cấp. Phần mềm của bạn chỉ nói chuyện với một hợp đồng API chuẩn hóa; Hub định tuyến yêu cầu tới đúng hãng, dịch dữ liệu sang định dạng của hãng đó, điều phối ký số và gửi cơ quan thuế, rồi trả kết quả về theo một cấu trúc thống nhất.

Invoice Hub che giấu những khác biệt gì giữa các hãng?

Hub che giấu khác biệt về mẫu số, ký hiệu, dải số hóa đơn, định dạng XML, cơ chế xác thực, quy trình ký số (HSM hoặc USB token) và cách kết nối Tổng cục Thuế. Bạn làm việc với một API chung, không phải xử lý những khác biệt này cho từng hãng.

Invoice Hub kết nối được những nhà cung cấp nào?

Hub đấu nối sẵn 1Invoice (mặc định) và hướng tới các nhà cung cấp hóa đơn điện tử phổ biến khác tại Việt Nam như MISA, Viettel, VNPT, FPT, M-Invoice. Bạn chỉ tích hợp một lần với Hub.

Dùng Invoice Hub tốn phí request không?

Nếu phát hành hóa đơn qua 1Invoice thì miễn phí API request. Nếu định tuyến sang nhà cung cấp khác, Hub tính 50 đồng mỗi request. Dùng 1Invoice làm mặc định giúp tối ưu chi phí.

Khi nào nên định tuyến sang nhà cung cấp khác 1Invoice?

Khi khách hàng của bạn đã có hợp đồng hoặc thương hiệu hóa đơn với một hãng cụ thể, hoặc khi nghiệp vụ yêu cầu giữ nguyên nhà cung cấp hiện tại. Các trường hợp còn lại nên để 1Invoice làm mặc định để miễn phí request, trong khi vẫn giữ khả năng đổi hãng bất cứ lúc nào.

Hub có tránh phát hành hóa đơn trùng không?

Có. Mỗi yêu cầu có thể gắn khóa định danh riêng nên nếu bạn lỡ gửi lại vì mạng chập chờn, Hub nhận ra và không xuất hóa đơn thứ hai. Hub cũng có cơ chế thử lại an toàn để không tạo bản trùng.

Làm sao biết trạng thái hóa đơn đã phát hành, đã ký hay đã gửi Thuế?

Hub cung cấp webhook trạng thái phát hành và cho tra cứu đối soát, nên bạn theo dõi được hóa đơn đang ở bước nào trên cùng một tập trạng thái chuẩn hóa cho mọi nhà cung cấp.

Đang dùng một hãng hóa đơn rồi, chuyển sang Invoice Hub có phải làm lại từ đầu?

Không. Bạn tích hợp một bộ API của Hub; sau đó việc chọn hoặc đổi nhà cung cấp bên dưới không cần viết lại tích hợp.

Có tự xuất hóa đơn ngay khi khách thanh toán không?

Có. Vì thanh toán và hóa đơn dùng chung một giải pháp API của TCONNECT, hóa đơn tự phát hành tại thời điểm giao dịch thành công, và thông tin người mua có thể tự điền nhờ tra cứu mã số thuế.

Invoice Hub có thân thiện với AI coding agent không?

Có. Vì Hub cung cấp một bộ API chuẩn hóa và một tài liệu duy nhất, AI coding agent sinh code tích hợp nhanh và ít sai hơn so với việc ghép nối nhiều đặc tả khác nhau của từng hãng.

Ai nên dùng Invoice Hub?

Các giải pháp phần mềm bán hàng, POS, F&B, SaaS billing, PMS khách sạn, HIS bệnh viện, ERP phục vụ nhiều khách hàng dùng nhiều hãng hóa đơn khác nhau — đấu nối một lần cho tất cả, tiết kiệm thời gian và công sức tích hợp.

GIẢI PHÁP API · HOÁ ĐƠN ĐIỆN TỬ

Invoice Hub — đấu nối mọi nhà cung cấp hoá đơn điện tử

Tích hợp một lần với Hub — phát hành, ký số và kết nối cơ quan thuế cho 1Invoice, MISA, Viettel, VNPT, FPT, M-Invoice. Dùng 1Invoice miễn phí request; nhà cung cấp khác 50đ/request. Gộp cùng thanh toán trong một giải pháp toàn trình.

🧾 1Invoice 🏢 MISA 📡 Viettel ☎️ VNPT 💾 FPT 📄 M-Invoice

Liên hệ tư vấn Đấu nối Invoice Hub · TCONNECT

Tóm tắt nhanh

Thay vì tích hợp riêng từng hãng hoá đơn, bạn đấu nối một lần với Invoice Hub. Hub định tuyến tới đúng nhà cung cấp, phát hành và ký số hoá đơn, kết nối trực tiếp cơ quan thuế. Rất hợp cho phần mềm bán hàng, SaaS, PMS, HIS muốn tiết kiệm thời gian đấu nối.

Vấn đề

Tích hợp riêng từng hãng — chi phí nhân lên

Nhìn từ ngoài, các nhà cung cấp hoá đơn điện tử đều làm cùng một việc: tạo hoá đơn, ký số, gửi cơ quan thuế. Nhưng khi bắt tay vào tích hợp, mỗi hãng lại là một thế giới riêng — khác nhau ở gần như mọi lớp kỹ thuật. Khi bạn (hoặc khách hàng của bạn) dùng nhiều hãng, đội kỹ thuật phải gánh:

!
Viết và bảo trì nhiều đoạn tích hợp riêng lẻ — mỗi hãng một cơ chế xác thực (API key, chứng thư, token khác nhau), một cấu trúc dữ liệu, một cách báo lỗi.
!
Xử lý khác biệt về mẫu số, ký hiệu, dải số hoá đơn và định dạng XML mỗi hãng quy ước một kiểu.
!
Nắm quy trình ký số riêng của từng hãng: nơi dùng HSM đặt trên máy chủ, nơi dùng USB token, nơi ký phía nhà cung cấp — mỗi cách một luồng tích hợp.
!
Cập nhật lại code mỗi khi một hãng đổi API hoặc khi quy định thay đổi — và phải sửa ở tất cả các bộ tích hợp cùng lúc.
!
Tự đồng bộ trạng thái hoá đơn (đã phát hành / đã ký / đã gửi Thuế) từ nhiều nguồn có cơ chế thông báo khác nhau.

Chi phí ẩn

Chi phí lớn không nằm ở lần tích hợp đầu, mà ở bảo trì lâu dài: mỗi hãng bạn nối thêm là một bộ code phải theo dõi, test và vá lỗi mãi về sau. Với N nhà cung cấp, bạn đang duy trì N bộ tích hợp thay vì một.

Kiến trúc Hub

Mô hình một-API-nhiều-nhà-cung-cấp

Invoice Hub hoạt động theo mô hình adapter: phần mềm của bạn chỉ nói chuyện với một hợp đồng API duy nhất của Hub. Bên trong, Hub giữ sẵn từng bộ chuyển đổi (adapter) cho mỗi nhà cung cấp và định tuyến yêu cầu tới đúng hãng.

Quy trình một lần phát hành hoá đơn qua Hub diễn ra như sau:

1
Chuẩn hoá đầu vào: bạn gửi dữ liệu hoá đơn theo một cấu trúc thống nhất của Hub — không cần biết bên dưới là hãng nào.
2
Định tuyến: Hub xác định nhà cung cấp cho merchant/nghiệp vụ đó rồi chuyển sang adapter tương ứng.
3
Dịch sang định dạng hãng: adapter ánh xạ dữ liệu chuẩn thành XML và tham số đúng như hãng yêu cầu, gắn mẫu số/ký hiệu/dải số phù hợp.
4
Ký số & gửi Thuế: Hub điều phối bước ký số và kết nối cơ quan thuế theo đúng cơ chế của hãng.
5
Trả kết quả chuẩn hoá: dù nhà cung cấp nào, bạn nhận về một cấu trúc kết quả thống nhất (mã hoá đơn, trạng thái, link tra cứu).

Điểm mấu chốt

Mọi khác biệt giữa các hãng bị che giấu sau một lớp API. Code của bạn không đổi khi Hub thêm hãng mới hoặc khi một hãng thay đổi API — adapter thay đổi, hợp đồng API với bạn thì giữ nguyên.

Điều Hub che giấu

Các hãng khác nhau ở đâu?

Để hiểu vì sao một API chung có giá trị, hãy nhìn chính xác những gì khác nhau giữa các nhà cung cấp — và là những thứ bạn sẽ phải tự xử lý nếu tích hợp trực tiếp:

Lớp kỹ thuật	Khác biệt giữa các hãng	Hub xử lý
Mẫu số / ký hiệu / dải số	Mỗi hãng quản lý và cấp phát theo quy ước riêng	Ánh xạ tự động theo cấu hình
Định dạng dữ liệu	Cấu trúc XML, tên trường, kiểu dữ liệu khác nhau	Dịch từ một cấu trúc chuẩn
Xác thực	API key, chứng thư, token — mỗi hãng một cơ chế	Bạn chỉ giữ một bộ khoá của Hub
Ký số	HSM trên máy chủ, USB token, hoặc ký phía hãng	Điều phối tập trung
Kết nối Tổng cục Thuế	Luồng gửi và nhận phản hồi riêng từng hãng	Chuẩn hoá về một luồng
Báo lỗi & trạng thái	Mã lỗi, cách thông báo khác nhau	Về một tập trạng thái thống nhất

Nếu tự làm, mỗi ô bên phải là một mảng công việc riêng bạn phải nghiên cứu, viết và bảo trì cho từng hãng. Hub gom tất cả về một hợp đồng API.

Giải pháp

Một API — đủ mọi nhà cung cấp hoá đơn

Bạn gọi một bộ API chuẩn hoá, Hub định tuyến yêu cầu tới đúng nhà cung cấp, phát hành hoá đơn đúng chuẩn và trả kết quả về. Đặc tả đầy đủ (tạo hoá đơn, ký số, lấy dải số, tra cứu) có trong tài liệu API hoá đơn điện tử TCONNECT.

Tiêu chí	Tích hợp trực tiếp từng hãng	Invoice Hub (TCONNECT × 1Invoice)
Số lần tích hợp	Mỗi hãng một lần	Một lần duy nhất
Bộ API	Nhiều bộ khác nhau	Một bộ API chuẩn hoá
Cơ chế xác thực phải giữ	Nhiều bộ khoá/chứng thư	Một bộ khoá của Hub
Thêm nhà cung cấp mới	Viết tích hợp mới	Bật thêm trong Hub
Khi một hãng đổi API	Bạn phải sửa code	Hub cập nhật adapter
Ký số & gửi cơ quan thuế	Tự lo theo từng hãng	Hub xử lý tập trung
Đồng bộ trạng thái	Ghép từ nhiều nguồn	Webhook & trạng thái chuẩn hoá
Gộp với thanh toán	Tự đấu nối thêm	Có sẵn — một giải pháp API

Độ tin cậy

Phát hành đúng một lần, đối soát được trạng thái

Phát hành hoá đơn là nghiệp vụ không được phép sai: xuất trùng hoặc mất trạng thái đều gây rắc rối kế toán và với cơ quan thuế. Hub được thiết kế để tích hợp đáng tin cậy, không chỉ tiện lợi:

✓
Chống phát hành trùng (idempotency): mỗi yêu cầu có thể gắn khoá định danh riêng, nên nếu bạn lỡ gửi lại vì mạng chập chờn, Hub nhận ra và không xuất hoá đơn thứ hai.
✓
Webhook trạng thái phát hành: thay vì liên tục hỏi thăm, hệ thống của bạn nhận thông báo chủ động khi hoá đơn chuyển trạng thái.
✓
Cơ chế thử lại: khi nhà cung cấp hoặc đường truyền tạm lỗi, Hub thử lại theo cách an toàn, không tạo bản trùng.
✓
Đối soát trạng thái: bạn tra cứu và đối chiếu được hoá đơn đang ở bước nào — đã phát hành, đã ký, đã gửi Thuế — trên cùng một tập trạng thái chuẩn hoá.

Vì sao quan trọng

Những cơ chế này nếu tự làm cho từng hãng sẽ rất tốn công và dễ sót. Gom về một Hub nghĩa là bạn viết logic đối soát một lần và dùng cho mọi nhà cung cấp bên dưới.

Phí sử dụng

Miễn phí API request khi dùng 1Invoice

Invoice Hub được xây trên nền tảng 1Invoice — cũng là nhà cung cấp mặc định, đấu nối sẵn trong Hub. Chính sách phí request rất đơn giản:

Nhà cung cấp hoá đơn dùng qua Hub	Phí mỗi API request
1Invoice (mặc định, đấu nối sẵn)	Miễn phí
Nhà cung cấp khác (MISA, Viettel, VNPT, FPT, M-Invoice...)	50đ / request

Phát hành hoá đơn qua 1Invoice thì mỗi lời gọi API không mất phí request; chỉ khi định tuyến sang nhà cung cấp khác, Hub mới tính 50 đồng mỗi request. Bạn vẫn chủ động chọn nhà cung cấp bên dưới mà không phải viết lại tích hợp.

Ví dụ minh hoạ

Giả sử một tháng bạn phát hành 100.000 hoá đơn. Nếu chạy toàn bộ trên 1Invoice, phí request là 0đ. Nếu vì lý do nghiệp vụ bạn định tuyến 10.000 hoá đơn sang một hãng khác, phần đó tốn 10.000 × 50đ = 500.000đ; 90.000 hoá đơn còn lại trên 1Invoice vẫn miễn phí. Cách tối ưu chi phí là để 1Invoice làm mặc định và chỉ định tuyến sang hãng khác cho những trường hợp thật sự cần.

Khi nào nên định tuyến sang hãng khác? Khi khách hàng của bạn đã có sẵn hợp đồng/thương hiệu hoá đơn với một hãng cụ thể, hoặc khi nghiệp vụ yêu cầu giữ nguyên nhà cung cấp hiện tại. Với các trường hợp còn lại, dùng 1Invoice mặc định giúp bạn bỏ hoàn toàn phí request mà vẫn giữ khả năng đổi hãng bất cứ lúc nào.

Tính năng

Những gì Invoice Hub làm cho bạn

✓
Kết nối tập trung: một API liên kết nhiều nhà cung cấp hoá đơn, không cần lập trình riêng từng nơi.
✓
Tự động hoá: tự khởi tạo, phát hành và gửi hoá đơn ngay khi có giao dịch.
✓
Ký số hoá đơn: ký số đúng quy định trước khi gửi cơ quan thuế.
✓
Kết nối Tổng cục Thuế: phát hành đúng quy định hiện hành, kết nối trực tiếp cơ quan thuế.
✓
Quản lý & lưu trữ: tra cứu, tải PDF/XML, lưu trữ đám mây bảo mật.

Toàn trình

Gộp thanh toán + hoá đơn trong một giải pháp

Đây là điểm khác biệt lớn nhất so với một cổng hoá đơn thuần. Với giải pháp hoá đơn đơn lẻ, quy trình thường là: nhận tiền ở hệ thống thanh toán rồi mới gọi sang hệ thống hoá đơn — hai hệ thống, hai đầu mối, phải tự đồng bộ. Với TCONNECT, thanh toán và hoá đơn dùng chung một giải pháp API.

✓
Tự phát hành khi thanh toán thành công: ngay tại thời điểm giao dịch, hoá đơn được xuất — không có bước thủ công xen giữa.
✓
Tự điền người mua: thông tin bên mua tự điền nhờ tra cứu mã số thuế trước khi xuất, giảm nhập tay và sai sót.
✓
Một đầu mối: một tài liệu, một bộ khoá, một nơi hỗ trợ — thay vì ghép nhiều nhà cung cấp.

Tích hợp một lần

Hub chuẩn hoá API để phần mềm bán hàng, SaaS, PMS, HIS đấu nối nhanh; đổi hoặc bổ sung nhà cung cấp bên dưới mà không phải viết lại tích hợp.

Chuyển đổi

Đang dùng một hãng — chuyển sang Hub thế nào?

Nỗi lo lớn nhất khi đổi hạ tầng là phải viết lại. Với Invoice Hub, bạn không viết lại tích hợp mỗi khi đổi nhà cung cấp: bạn chỉ đấu nối một lần với hợp đồng API của Hub, còn việc chọn hoặc chuyển hãng bên dưới là thao tác cấu hình.

✓
Giữ nguyên logic nghiệp vụ: code tạo hoá đơn của bạn nói chuyện với Hub, không phụ thuộc hãng cụ thể.
✓
Chuyển dần: có thể để hoá đơn mới phát hành qua Hub trong khi vẫn tra cứu được dữ liệu cũ.
✓
Linh hoạt về sau: khi cần thêm một hãng nữa cho một nhóm khách hàng, bạn bật trong Hub thay vì mở một dự án tích hợp mới.

Theo ngành

Ứng dụng theo từng loại phần mềm

Cùng một Hub, mỗi ngành khai thác theo nhu cầu riêng — nhưng đều hưởng lợi từ việc đấu nối một lần:

Loại phần mềm	Cách dùng Invoice Hub
POS bán lẻ	Xuất hoá đơn ngay tại quầy khi thanh toán, in kèm QR tra cứu.
F&B / nhà hàng	Phát hành khi khách thanh toán bàn, kể cả nhiều điểm bán dùng nhà cung cấp khác nhau.
SaaS billing	Tự xuất hoá đơn theo chu kỳ đăng ký, đối soát trạng thái qua webhook.
PMS khách sạn	Tự xuất hoá đơn khi khách check-out, gộp các dịch vụ trong kỳ lưu trú.
HIS bệnh viện	Phát hành hoá đơn viện phí sau khám/điều trị, kết nối cơ quan thuế đúng quy định.
ERP / phần mềm quản lý	Một tích hợp phục vụ nhiều khách hàng dùng nhiều hãng hoá đơn khác nhau.

Cho nhà phát triển

Thân thiện developer và AI coding agent

Vì Hub cung cấp một bộ API chuẩn hoá thay vì nhiều bộ khác nhau, đội phát triển chỉ phải học một hợp đồng và một tài liệu. Điều này cũng đặc biệt hợp với AI coding agent: một API nhất quán, tài liệu rõ ràng thì máy sinh code tích hợp nhanh và ít sai hơn nhiều so với việc ghép nối vài đặc tả khác nhau của từng hãng.

✓
Một tài liệu duy nhất: đọc tài liệu API hoá đơn điện tử là đủ để bắt đầu.
✓
Kết quả chuẩn hoá: cùng một cấu trúc phản hồi dù bên dưới là hãng nào — dễ viết logic xử lý.
✓
Ít bề mặt bảo trì: khi hãng đổi API, bạn không phải sửa — bề mặt code của bạn không đổi.

Bắt đầu

Đấu nối Invoice Hub cho phần mềm của bạn

Xem tài liệu API tích hợp hoá đơn điện tử, hoặc liên hệ để được tư vấn đấu nối theo nghiệp vụ cụ thể.

TCONNECT là nền tảng hạ tầng cung cấp API thanh toán (VietQR, cổng thanh toán, POS, Soundbox) và hóa đơn điện tử qua một tích hợp duy nhất, dành cho PSP, SaaS, ERP và doanh nghiệp tại Việt Nam.

Liên hệ TCONNECT