Giới thiệu
E-Invoice Hub là gateway giúp nền tảng thương mại (Merchant Platform) tích hợp một lần với nhiều nhà cung cấp hóa đơn điện tử qua một cổng duy nhất — thay vì phải tích hợp riêng lẻ với từng đơn vị. Nhờ đó, doanh nghiệp giảm chi phí, rút ngắn thời gian phát triển và chuẩn hóa việc kết nối.
Tài liệu này hướng dẫn nhà phát triển cách kết nối ứng dụng (Client) tới dịch vụ hóa đơn điện tử thông qua E-Invoice Hub.
Về hóa đơn điện tử & 1Invoice
Hóa đơn điện tử (e-invoice) là hình thức hóa đơn được khởi tạo, ký số và lưu trữ hoàn toàn điện tử, kết nối trực tiếp với Cơ quan Thuế để đảm bảo hợp lệ và minh bạch.
1Invoice là một nhà cung cấp hóa đơn điện tử cho doanh nghiệp SME (được hơn 10.000+ doanh nghiệp tin dùng) — và là một trong các nhà cung cấp mà E-Invoice Hub có thể kết nối tới. Điểm nổi bật:
- Phát hành nhanh — xuất hóa đơn chỉ với 1 click, giảm tới 85% thời gian xử lý.
- Tuân thủ 100% — kết nối trực tiếp Cơ quan Thuế, đảm bảo hóa đơn hợp lệ.
- Đa thiết bị & an toàn — chạy trên Mobile, Web, Desktop; đạt chuẩn PCI DSS / ISO 27001.
Đường dẫn API
| Môi trường | Base URL |
|---|---|
| Staging | https://stag-invoice-hub.1invoice.vn |
| Production | https://invoice-hub.1invoice.vn |
Chỉ thực hiện test trên môi trường Staging, không test trên môi trường Production.
Quy ước chung
- Khi gọi một API vào E-Invoice Hub, cần chỉ định rõ nhà cung cấp muốn sử dụng. Cấu trúc URL của một request:
<base_url>/<provider>/<endpoint>. - Quy ước đặt tên field trong request body:
a.x: fieldxcủa objectaa.n[]: fieldnlà một mảng trong objectaa.n[].x: fieldxtrong mỗi phần tử của mảngna[n]: phần tử thứn+1của objectaa[n].x: fieldxtrong phần tử thứn+1của objecta