Lịch nộp thuế API
Lịch hạn nộp thuế trong năm: GTGT, TNCN, tạm nộp TNDN, quyết toán, tự lùi khi trùng ngày nghỉ, có gia hạn và xuất file lịch ICS.
Chọn năm, loại người nộp thuế (company doanh nghiệp hoặc household hộ kinh doanh) và kỳ khai, API trả về mọi hạn nộp rơi vào năm đó: tờ khai tháng ngày 20, tờ khai quý ngày cuối cùng của tháng đầu quý sau, tạm nộp TNDN ngày 30, quyết toán TNDN, TNCN và báo cáo tài chính vào cuối tháng thứ 3 sau khi kết thúc năm tài chính, cá nhân tự quyết toán cuối tháng 4, cùng lịch của hộ kinh doanh theo NĐ 68/2026/NĐ-CP.
Hạn nào trùng thứ Bảy, Chủ nhật hoặc ngày lễ được lùi sang ngày làm việc tiếp theo (NĐ 252/2026/NĐ-CP Điều 3), dựa trên lịch nghỉ chính thức trong API lịch nghỉ lễ Việt Nam; trường moved_because cho biết lý do. Lệ phí môn bài (hạn 30/1) chỉ còn đến năm 2025 vì Nghị quyết 198/2025/QH15 đã bãi bỏ từ 1/1/2026.
extension=true thêm hạn nộp tiền được gia hạn theo NĐ 245/2026/NĐ-CP cho đối tượng đủ điều kiện. month và upcoming=true để lọc, format=ics trả về file lịch có nhắc trước 3 ngày.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
year | query|body | number | không | Năm (mặc định năm nay). | |
entity | query|body | string | không | company | company (doanh nghiệp) hoặc household (hộ kinh doanh). |
vat_period | query|body | string | không | monthly | monthly, quarterly hoặc none (hộ kinh doanh mặc định theo quý). |
pit_period | query|body | string | không | Kỳ khai thuế TNCN khấu trừ (mặc định theo vat_period). | |
fiscal_year_end_month | query|body | number | không | 12 | Tháng kết thúc năm tài chính. |
extension | query|body | boolean | không | Thêm hạn nộp tiền gia hạn theo NĐ 245/2026. | |
month | query|body | number | không | Chỉ lấy các hạn trong tháng này. | |
upcoming | query|body | boolean | không | Chỉ lấy các hạn từ hôm nay. | |
format | query|body | string | không | json | json hoặc ics (file lịch). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"year": 2026,
"entity": "company",
"vat_period": "quarterly",
"pit_period": "quarterly",
"deadlines": [
{
"period": "2026-Q2",
"kind": "cit",
"title_vi": "Tạm nộp thuế TNDN quý 2/2026",
"title_en": "Provisional CIT payment, Q2 2026",
"due_date": "2026-07-30",
"statutory_date": "2026-07-30",
"moved": false,
"ref": "NĐ 126/2020/NĐ-CP Điều 55 (ngày 30 tháng đầu quý sau)"
},
{
"period": "2026-Q2",
"kind": "pit",
"title_vi": "Khai, nộp thuế TNCN khấu trừ quý 2/2026",
"title_en": "PIT withholding return, Q2 2026",
"due_date": "2026-07-31",
"statutory_date": "2026-07-31",
"moved": false,
"ref": "NĐ 252/2026/NĐ-CP Điều 10 khoản 3"
},
{
"period": "2026-Q2",
"kind": "vat",
"title_vi": "Khai, nộp thuế GTGT quý 2/2026",
"title_en": "VAT return and payment, Q2 2026",
"due_date": "2026-07-31",
"statutory_date": "2026-07-31",
"moved": false,
"ref": "NĐ 252/2026/NĐ-CP Điều 10 khoản 3"
}
],
"count": 3,
"notes": [
"Due dates falling on a weekend or public holiday move to the next working day (NĐ 252/2026/NĐ-CP Điều 3 khoản 7)."
],
"reviewed": "2026-11-11"
}
Ứng dụng
- Nhắc hạn nộp thuế trong phần mềm kế toán, nhân sự
- Làm bot Zalo, Telegram nhắc khách hàng nộp tờ khai
- Đăng ký lịch thuế vào Google Calendar hoặc Outlook
- Lên kế hoạch công việc hằng tháng cho dịch vụ kế toán
Hỏi đáp
Hạn nộp trùng Chủ nhật hoặc ngày lễ thì sao?
Được lùi sang ngày làm việc tiếp theo; kết quả vẫn giữ ngày theo luật và ghi lý do (ví dụ Chủ nhật, Quốc khánh).
Còn hạn nộp lệ phí môn bài không?
Chỉ có với các năm đến 2025. Nghị quyết 198/2025/QH15 đã chấm dứt thu lệ phí môn bài từ 1/1/2026.
Có tính gia hạn nộp thuế không?
Với extension=true năm 2026, API thêm hạn nộp tiền được gia hạn theo NĐ 245/2026/NĐ-CP; hạn nộp tờ khai không đổi.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.