Lấy thông tin mã số thuế

GET /tax-code

Truy xuất thông tin chi tiết của một doanh nghiệp theo mã số thuế (MST). API này không cần chỉ định nhà cung cấp, nhưng cần Authorization: Bearer <access_token> và Partner-Code như các Open API khác.

Query Parameters

Name	Type	Required	Description
tax	string	✅	Mã số thuế

Response

Name	Type	Description
ma_so_thue	string	Mã số thuế đã tra cứu.
success	boolean	true nếu tìm thấy doanh nghiệp.
danh_sach	array	Thông tin doanh nghiệp — endpoint này trả đúng 1 phần tử.

Phần tử trong danh_sach:

Name	Type	Description
stt	string	Số thứ tự (luôn "1").
ma_so_thue	string	Mã số thuế của doanh nghiệp.
la_chi_nhanh	boolean	true nếu MST tra là chi nhánh.
ten_cty	string / null	Tên đầy đủ của công ty/doanh nghiệp.
dia_chi	string / null	Địa chỉ đăng ký kinh doanh.
cqthue_ql	string / null	Cơ quan thuế quản lý trực tiếp.
cqthuecap_tinh	string / null	Cơ quan thuế cấp tỉnh quản lý.
nguoi_dai_dien	string / null	Họ và tên người đại diện pháp luật.
ngay_thanh_lap	Date (YYYY-MM-DD) / null	Ngày thành lập doanh nghiệp.
ten_tthai	string / null	Tên mô tả trạng thái hoạt động.
dang_hoat_dong	boolean / null	Suy từ trạng thái (true nếu đang hoạt động).

cURL

curl --location 'https://sme-open-api-sandbox.tconnect.vn/openapi/v1/api-invoice/tax-code?tax=0319074775' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Partner-Code: <partner_code>'

Response

{
  "ma_so_thue": "0319074775",
  "success": true,
  "danh_sach": [
    {
      "stt": "1",
      "ma_so_thue": "0319074775",
      "la_chi_nhanh": false,
      "ten_cty": "CÔNG TY CỔ PHẦN GIẢI PHÁP T CONNECT",
      "dia_chi": "232 Nguyễn Lương Bằng, Phường Tân Mỹ, Thành phố Hồ Chí Minh, Việt Nam",
      "cqthue_ql": "Thuế cơ sở 7 Thành phố Hồ Chí Minh",
      "cqthuecap_tinh": "Chi cục thuế Hồ Chí Minh",
      "nguoi_dai_dien": null,
      "ngay_thanh_lap": null,
      "ten_tthai": null,
      "dang_hoat_dong": null
    }
  ]
}