Hoá đơn điện tử — HiTechCloud Pay eInvoice

Hoá đơn điện tử HiTechCloud Pay: phát hành và quản lý HĐĐT tự động theo Nghị định 123/2020/NĐ-CP và Thông tư 78/2021/TT-BTC, kết nối trực tiếp Cơ quan Thuế qua REST API.

Xem Markdown

HiTechCloud Pay eInvoice API là giải pháp tự động hóa toàn diện quy trình xuất hóa đơn điện tử dành cho doanh nghiệp và nền tảng thương mại. Ngay sau khi đơn hàng được thanh toán, hệ thống có thể tự động lập, ký số và truyền dữ liệu hóa đơn có mã hoặc không có mã lên hệ thống hóa đơn điện tử của Tổng cục Thuế Việt Nam.

Sơ đồ kết nối

Luồng phát hành hóa đơn điện tử
Hệ thống của bạnDữ liệu đơn hàng
eInvoice APIPOST /v1/invoices/create
Nhà cung cấp HĐĐTViettel / VNPT / MISA…
Ký số CKS / HSMKý dữ liệu hóa đơn
Cơ quan ThuếCấp mã & duyệt
Webhook trạng tháiPDF / XML gốc

Từ dữ liệu đơn hàng đến hóa đơn được Cơ quan Thuế cấp mã và file PDF/XML gốc.

Tuân thủ pháp lý & Tính năng nổi bật

  • Chuẩn pháp lý 100%: Hoàn toàn tuân thủ Nghị định 123/2020/NĐ-CP và Thông tư 78/2021/TT-BTC của Bộ Tài chính.
  • Kết nối đa nhà cung cấp: Tương thích và tích hợp sâu với các nhà cung cấp giải pháp HĐĐT hàng đầu: Mắt Bão, Viettel, VNPT, MISA, BKAV, v.v.
  • Tự động hóa theo thanh toán: Tự động kích hoạt xuất hóa đơn ngay khi nhận được tín hiệu thanh toán thành công từ Cổng thanh toán hoặc Webhook.
  • Tải file gốc tức thì: Cung cấp link tải file PDF thể hiện và file XML có chữ ký số gốc để gửi cho khách hàng và lưu trữ theo luật kế toán.

Môi trường và Base URLs

Môi trườngBase URL
Production (Chính thức)https://einvoice-api.hitechcloud.vn
Sandbox (Thử nghiệm)https://einvoice-api-sandbox.hitechcloud.vn

Quy trình 4 bước phát hành

  1. Lấy Access Token: Dùng client_id và client_secret qua Basic Auth để nhận Bearer Token (thời hạn 24 giờ).
  2. Chọn tài khoản nhà cung cấp: Tra cứu provider_account_id, mẫu số và ký hiệu hóa đơn đang hoạt động.
  3. Tạo và phát hành hóa đơn: Gửi payload thông tin bên mua và danh mục hàng hóa (POST /v1/invoices/create), nhận tracking_code bất đồng bộ.
  4. Kiểm tra trạng thái CQT: Polling kiểm tra kết quả duyệt mã của Cơ quan Thuế và lấy link tải file PDF/XML.