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.

GETPOSThttps://apibox.io.vn/v1/vn-tax-calendar
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
yearquery|bodynumberkhôngNăm (mặc định năm nay).
entityquery|bodystringkhôngcompanycompany (doanh nghiệp) hoặc household (hộ kinh doanh).
vat_periodquery|bodystringkhôngmonthlymonthly, quarterly hoặc none (hộ kinh doanh mặc định theo quý).
pit_periodquery|bodystringkhôngKỳ khai thuế TNCN khấu trừ (mặc định theo vat_period).
fiscal_year_end_monthquery|bodynumberkhông12Tháng kết thúc năm tài chính.
extensionquery|bodybooleankhôngThêm hạn nộp tiền gia hạn theo NĐ 245/2026.
monthquery|bodynumberkhôngChỉ lấy các hạn trong tháng này.
upcomingquery|bodybooleankhôngChỉ lấy các hạn từ hôm nay.
formatquery|bodystringkhôngjsonjson 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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →