Tax filings (tờ khai thuế)

Đường dẫn: /companies/{company_id}/tax-filings

Nó là gì?

Mỗi filing là một tờ khai thuế Check chuẩn bị và nộp thay công ty cho một kỳ (tháng, quý, năm) và một jurisdiction. Ví dụ: Form 941 quý 3 năm 2026 (liên bang), tờ khai DE 9 quý 3 của California.

Bảng có bộ lọc Status, Year, Period, Is Amendment, Jurisdiction và các cột Year, Period, Filing, Status, Document, Due on, Filed on, Closed at, Held at, Last submitted at, Period start, Period end, Type.

Zodinet mới chạy lương nên chưa có filing (No tax filings found). Filing xuất hiện sau khi có kỳ lương thật.

Trạng thái

Hình: Tờ khai 940, 941, W-2, CA, TX (Blocked)

Trạng thái	Ý nghĩa
pending	Check đang chuẩn bị
blocked	Bị chặn, xem lý do
submitted	Đã gửi cơ quan thuế (mốc tính đúng hạn)
filed	Cơ quan thuế đã chấp nhận
inapplicable	Không còn áp dụng

Lý do bị chặn thường gặp

Hình: Chi tiết tờ khai bị chặn

Hình: Tab Manage filing — ① blocker cần xử lý · ② Hold filing

Blocker	Cách gỡ
applied_for_tax_id	Nhập mã số thuế thật ở Setup parameters
invalid_tax_id	Sửa mã số thuế
invalid_ssn	Sửa SSN nhân viên
poa_failure, tpa_failure	Ký lại ủy quyền (Documents → Filing authorization)
held_by_customer	Partner tạm giữ, gỡ bằng Remove blocker

Một số blocker tự gỡ khi dữ liệu được sửa; một số cần liên hệ support của Check.

Cách dùng

• Định kỳ lọc Status = blocked để xử lý trước hạn.
• Báo cáo Blocked filings cho xem toàn bộ công ty cùng lúc.
• Tải tờ khai đã nộp ở cột Document hoặc trang Documents.

API: GET /filings?company=...&status=blocked, POST /filings/{id}/remove_blockers. Webhook company_filing.