Hóa đơn đầu vào

Bộ API cho phép doanh nghiệp tự động lấy hóa đơn đầu vào (hóa đơn mua vào do người bán xuất cho doanh nghiệp) từ cổng của Tổng cục Thuế (TCT), phục vụ đối soát, hạch toán và quản lý chi phí.

Điều kiện sử dụng

• Doanh nghiệp đã đăng ký dịch vụ hóa đơn đầu vào tại nhà cung cấp XCyber (x-cyber). Các nhà cung cấp khác chưa hỗ trợ dịch vụ này.
• Tài khoản hóa đơn điện tử trên TINGEE được cấu hình với dịch vụ input-invoice qua API Tạo/Cập nhật tài khoản.

Trước khi bắt đầu

• Base URL: https://uat-open-api.tingee.vn (UAT) · https://open-api.tingee.vn (PROD)
• Xác thực: Mọi request cần gửi kèm các header x-client-id, x-request-timestamp và chữ ký x-signature (HMAC SHA512). Xem Hướng dẫn lấy API Key & sinh chữ ký.
• Tài khoản sử dụng: Mọi API nhận accountId (ID tài khoản hóa đơn điện tử). Nếu bỏ trống, hệ thống dùng tài khoản mặc định.

Quy trình tích hợp

1

Cấu hình tài khoản

Gọi API Tạo/Cập nhật tài khoản với provider = "x-cyber" và services chứa "input-invoice".

2

Kết nối tài khoản Thuế

Gọi API input/connect để kết nối tài khoản cổng hóa đơn điện tử của Tổng cục Thuế. Có thể bỏ qua nếu thông tin đã được lưu tại nhà cung cấp.

3

Đồng bộ hóa đơn

Gọi API input/sync để đồng bộ hóa đơn theo khoảng thời gian.

4

Tra cứu & tải hóa đơn

Dùng input/list để lấy danh sách, input/detail để xem chi tiết và input/preview-base64 để tải file PDF.

Sơ đồ luồng

Luồng lấy hóa đơn đầu vào

← Vuốt ngang để xem thêm →

Danh mục API

Chức năng	Method	Endpoint
Kết nối tài khoản Thuế	POST	/v1/e-invoice/input/connect
Ngắt kết nối tài khoản Thuế	POST	/v1/e-invoice/input/disconnect
Đồng bộ hóa đơn đầu vào	POST	/v1/e-invoice/input/sync
Danh sách hóa đơn đầu vào	POST	/v1/e-invoice/input/list
Chi tiết hóa đơn đầu vào	POST	/v1/e-invoice/input/detail
Bản thể hiện hóa đơn (PDF)	POST	/v1/e-invoice/input/preview-base64