API tra cứu hóa đơn đầu vào

Bộ API lấy hóa đơn mua vào (đầu vào) của doanh nghiệp từ cổng thuế. Đối tác cung cấp tài khoản cổng thuế (MST + mật khẩu); hệ thống tự đăng nhập, đồng bộ hóa đơn (HĐĐT + máy tính tiền), lưu mã hóa và trả về qua API.

An toàn & bảo mật

• Chỉ lấy hộ, không can thiệp — hệ thống tự động đăng nhập và lấy đúng hóa đơn của bạn từ cổng thuế thay cho thao tác thủ công. Không sửa, không xử lý, không thay đổi dữ liệu gốc — giữ nguyên như trên cổng thuế.
• Mã hóa mạnh — MST được băm HMAC-SHA256 (không lưu ở dạng thô); mật khẩu cổng thuế và dữ liệu nhạy cảm (tên, số tiền, dòng hàng) được mã hóa AES-256-GCM.

Dành cho AI/Agent

👉 Tải đặc tả API đầy đủ (single-file cho Vibe code / AI Agent)

Tất cả đường dẫn dưới đây là tương đối so với base URL (.../openapi/v1/api-invoice).

STT	Chức năng	Method	Endpoint	Tính phí
1	Đăng ký tài khoản cổng thuế	POST	/tax-accounts	—
2	Yêu cầu đồng bộ hóa đơn	POST	/tax-accounts/{accountId}/sync	✅ theo hóa đơn
3	Theo dõi tiến trình	GET	/sync-jobs/{jobId}	—
4	Danh sách hóa đơn	GET	/invoices	✅ 10% phí lượt đồng bộ
5	Chi tiết hóa đơn	GET	/invoices/{invoiceId}	✅ 10% phí lượt đồng bộ
6	Lấy chi tiết on-demand	POST	/invoices/{invoiceId}/fetch-detail	✅ theo hóa đơn
7	Đối soát sử dụng	GET	/tax-accounts/{accountId}/usage	—

Cách tính phí

• Theo hóa đơn — endpoint gọi ra cổng thuế: đồng bộ và lấy chi tiết on-demand (tính theo số hóa đơn, có bậc thang; ×1.5 nếu lấy chi tiết).
• 10% phí lượt đồng bộ / request — endpoint đọc dữ liệu đã lưu: danh sách hóa đơn và chi tiết hóa đơn (mỗi lần gọi = 10% phí lượt đồng bộ).
• Miễn phí — đăng ký/quản lý tài khoản, theo dõi tiến trình, đối soát.

Xem Tính giá theo API request.

Luồng đầy đủ

Tham số đồng bộ chính

Field	Kiểu	Mặc định	Ý nghĩa
dateFrom / dateTo	date (YYYY-MM-DD)	30 ngày gần nhất	Khoảng ngày lập hóa đơn (tối đa ~31 ngày/cửa sổ; dài hơn tự chia)
direction	string	purchase	purchase = mua vào (đầu vào)
fetchDetails	boolean	true	true = kèm dòng hàng (chi tiết); false = chỉ header (rẻ hơn)