Đăng ký tài khoản cổng thuế

Lưu tài khoản cổng thuế (MST + mật khẩu) của doanh nghiệp để hệ thống thay mặt đăng nhập và đồng bộ hóa đơn. MST được băm, mật khẩu được mã hóa — không lưu ở dạng thô.

POST /tax-accounts

Request body

Field	Kiểu	Bắt buộc	Ý nghĩa
mst	string	✅	Mã số thuế / tên đăng nhập cổng thuế
password	string	✅	Mật khẩu cổng thuế
triggerInitialSync	boolean		Tạo luôn yêu cầu đồng bộ lần đầu (mặc định true)
initialSync	object		Tham số đồng bộ lần đầu (dateFrom, dateTo, fetchDetails)

Ví dụ request

{
  "mst": "0319074775",
  "password": "••••••••",
  "triggerInitialSync": true,
  "initialSync": { "dateFrom": "2025-03-01", "dateTo": "2025-03-31", "fetchDetails": true }
}

Ví dụ response (201)

{
  "id": "cf00eea0-af08-4e84-9aa3-e12d23b3a568",
  "maskedMst": "03•••••775",
  "status": "active",
  "initialJob": { "id": "b6bf6a2a-9082-4882-b798-b35fc5985894", "status": "queued" }
}

id chính là accountId dùng cho các bước sau.

Quản lý tài khoản

Chức năng	Method	Endpoint
Xem	GET	/tax-accounts/{accountId}
Danh sách	GET	/tax-accounts
Đổi mật khẩu	PATCH	/tax-accounts/{accountId}
Xóa	DELETE	/tax-accounts/{accountId}

Cập nhật mật khẩu

Đổi mật khẩu qua PATCH sẽ tự gỡ khóa nếu tài khoản trước đó bị đánh dấu sai mật khẩu (INVALID_CREDENTIALS).