Hóa đơn điện tử
Nhóm API Hóa đơn điện tử cho phép Merchant tích hợp xuất hóa đơn điện tử (e-invoice) trực tiếp từ hệ thống TINGEE thông qua các nhà cung cấp được hỗ trợ: XCyber, HiLo, và SInvoice.
Luồng hoạt động
- Gọi Lấy danh sách nhà cung cấp để xem các provider được hỗ trợ.
- Gọi Tạo / Cập nhật tài khoản để kết nối tài khoản nhà cung cấp hóa đơn điện tử.
- Gọi Lấy mẫu hóa đơn để xem danh sách mẫu hóa đơn đã đăng ký trên nhà cung cấp.
- Gọi Tạo hóa đơn nháp hoặc Tạo và phát hành hóa đơn tùy theo nhu cầu.
- Gọi Tải hóa đơn để lấy PDF hoặc Gửi email hóa đơn cho người mua.
Lưu ý
Các trường provider và taxCode không bắt buộc khi thao tác hóa đơn — nếu không truyền, hệ thống sẽ tự lấy từ tài khoản mặc định.
Danh sách API
Nhà cung cấp & Tài khoản
| API | Phương thức | Mô tả |
|---|---|---|
| Lấy danh sách nhà cung cấp | POST | Lấy danh sách nhà cung cấp hóa đơn điện tử được hỗ trợ. |
| Lấy danh sách tài khoản | POST | Truy vấn danh sách tài khoản nhà cung cấp (phân trang). |
| Tạo / Cập nhật tài khoản | POST | Tạo mới hoặc cập nhật tài khoản nhà cung cấp. |
| Xóa tài khoản | POST | Xóa tài khoản nhà cung cấp. |
Hóa đơn
| API | Phương thức | Mô tả |
|---|---|---|
| Tạo hóa đơn nháp | POST | Tạo hóa đơn nháp (draft/preview), trả về PDF Base64. |
| Tạo và phát hành hóa đơn | POST | Tạo và ký phát hành hóa đơn trong 1 bước (HSM signing). |
| Tải hóa đơn | POST | Tải hóa đơn ở dạng PDF Base64. |
| Lấy mẫu hóa đơn | POST | Lấy danh sách mẫu hóa đơn đã đăng ký trên nhà cung cấp. |
| Gửi email hóa đơn | POST | Gửi hóa đơn qua email cho người mua. |