API tra cứu mã số thuế
Tra cứu thông tin doanh nghiệp theo mã số thuế (MST): tên công ty, địa chỉ, cơ quan thuế quản lý, người đại diện, ngày thành lập, trạng thái hoạt động.
Dành cho AI/Agent
Tất cả đường dẫn dưới đây là tương đối so với base URL.
| STT | Chức năng | Method | Endpoint | Tính phí |
|---|---|---|---|---|
| 1 | Tra cứu mã số thuế | GET | /tax-code?tax={mst} | ✅ theo request |
Đặc điểm
- Không cần mã hóa — chỉ truyền
taxqua query parameter (khác với các API cần AES). - Có đo đếm để tính tiền — mỗi lần gọi được đếm request (dùng chung bộ đếm với API tra cứu hóa đơn đầu vào); quy ra tiền theo bậc thang. Xem Tính giá theo request.
Xác thực
Dùng chung cơ chế Open API: Authorization: Bearer <access_token> + Partner-Code (xem Giới thiệu). API này không mã hóa body/tham số.
Bảng giá (tóm tắt)
| Bậc (đến request thứ) | Đơn giá / request |
|---|---|
| 100 | 8.000đ |
| 500 | 4.000đ |
| 1.000 | 2.000đ |
| > 1.000 (vượt) | 1.000đ |
Bậc thang lũy tiến lùi — càng nhiều request đơn giá càng giảm. Công cụ tính: Tính giá theo request.