Lấy trạng thái tờ khai

GET /core-api/customers/declaration-status

API dùng để lấy trạng thái tờ khai kiểm tra xem đã có tờ khai chấp nhận chưa.

Headers

Name	Required	Description
Authorization	✅	Bearer token
Content-Type	✅	application/json

Query Parameters

Name	Required	Description
provider	✅	Tên nhà cung cấp đang sử dụng (e.g., 'm-invoice').
taxCode	✅	Mã số thuế người bán.
sorting		Sắp xếp theo trường (e.g., 'creationTime').
sortType		Kiểu sắp xếp (DESCEND, ASCEND).
formDate		Ngày lập từ ngày (YYYY-MM-DD).
toDate		Ngày lập đến ngày (YYYY-MM-DD).
taxAuthorityFeedback		Phản hồi của CQT (1: Tiếp nhận, 2: Không tiếp nhận, 3: Chấp nhận, 4: Không chấp nhận).

Response

Name	Description
data[].id	Id tờ khai
data[].formality	Loại tờ khai, 1: Đăng ký, 2: Thay đổi
data[].taxCode	Mã số thuế người bán
data[].taxAuthorityFeedback	Phản hồi của CQT
data[].dateCreate	Ngày tạo, định dạng ISO 8601
data[].status	Trạng thái tờ khai, 0: Chưa gửi, 1: Đã gửi
data[].dateSign	Ngày ký, định dạng ISO 8601

cURL

curl --location  'https://stag-invoice-hub.atomsolution.vn/core-api/customers/declaration-status?provider=m-invoice&taxCode=0106026495-998&sorting=creationTime&sortType=DESCEND&fromDate=2024-12-31&toDate=2025-08-12&taxAuthorityFeedback=3' \
--header 'authorization: Bearer O87316arj5+Od3Fqyy5hzdBfIuPk73eKqpAzBSvv8sY='

Response

{
  "success": true,
  "data": [
    {
      "id": "3a1b94b4-04f9-d3d5-41a8-74dcba5c71d5",
      "formality": 2,
      "taxCode": "0106026495-998",
      "taxAuthorityFeedback": 3,
      "dateCreate": "2025-08-07T00:00:00",
      "status": 1,
      "dateSign": "2025-08-07T03:16:00.126946+00:00"
    }
  ]
}