Kết nối doanh nghiệp · Mở ra cơ hội · Hướng tới tương lai
WhatsApp
Zalo⌄
Mã QR Zalo của Hằng Tín

Quét mã để liên hệ qua Zalo. Nhấn để phóng to.

Di động: +65 8585 9090Email: info@acggroupsg.com
Thuế · PDF

Xác thực AIS-API 2.0: hướng dẫn kiểm thử từ tháng 9 đến tháng 12 năm 2026

Hướng dẫn mười một trang ngày 9 tháng 9 năm 2026 dành cho nhà cung cấp phần mềm muốn được liệt kê trong danh sách AIS, người sử dụng lao động có phần mềm nội bộ và đơn vị khai thay khách hàng. Đây là xác thực hệ thống, không phải điều kiện về thu nhập của nhân viên. Nhà cung cấp có tám bước; người sử dụng lao động và đơn vị dịch vụ có năm bước.

Ngày đối chiếu nguồn của bài gốc: 11 tháng 10 năm 2026 · Ngày phát hành tài liệu: 9 tháng 9 năm 2026

Giai đoạn kiểm thử và ba nhóm đối tượng

Hướng dẫn mười một trang ngày 9 tháng 9 năm 2026 dành cho nhà cung cấp phần mềm muốn được liệt kê trong danh sách AIS, người sử dụng lao động có phần mềm nội bộ và đơn vị khai thay khách hàng. Đây là xác thực hệ thống, không phải điều kiện về thu nhập của nhân viên. Nhà cung cấp có tám bước; người sử dụng lao động và đơn vị dịch vụ có năm bước.

Kết nối của nhà cung cấp và bốn tình huống

Phần mềm phải kết nối trực tiếp với Submission of Employment Income Records 2.0, tham gia APEX và đăng ký AIS-API 2.0 trong sandbox, sau đó chờ thông báo có thể bắt đầu. Tình huống 1 chỉ có IR8A; tình huống 2 thêm A8A; tình huống 3 gồm IR8A và A8B; tình huống 4 có cả ba. Nếu có nhiều sản phẩm, kiểm thử tổ hợp có nhiều loại biểu mẫu nhất mà phần mềm hỗ trợ. Xác thực hằng năm bao gồm tự kiểm tra.

Bộ A: dữ liệu giả định theo kết quả dự kiến

Tạo dữ liệu khai gốc với submissionType=O theo tình huống đã chọn, rồi so với JSON kết quả dự kiến. Giữ các khác biệt hợp lý, chẳng hạn softwareName phải là tên phần mềm thực tế; những khác biệt khác phải được điều tra, sửa nguyên nhân và tạo lại dữ liệu. Số liệu ví dụ là giả định, không được dùng làm căn cứ tính CPF hoặc thuế; biểu mẫu chính thức YA 2027 được công bố riêng. Nộp trong sandbox và lưu số xác nhận. Tài khoản công khai trong PDF chỉ dùng thử nghiệm sandbox, không phải thông tin đăng nhập hệ thống chính thức.

Bộ B: dữ liệu ngẫu nhiên và cách ủy quyền

Với bộ B, tạo dữ liệu giả định ngẫu nhiên dạng O, dùng định dạng số nhận dạng hợp lệ, nên có nhiều nhóm nhân viên. Tối thiểu có 20 bản ghi IR8A và năm bản ghi cho mỗi phụ lục được hỗ trợ. Nếu hỗ trợ khai với tư cách đại lý thuế, dùng đường ủy quyền trực tiếp từ khách hàng; nếu không thì nộp với tư cách người sử dụng lao động. PDF có thực thể sandbox và mã số kiểm thử tương ứng trong payload; phải chọn đúng đường, không trộn lẫn danh tính.

Bộ C/D: điều chỉnh chênh lệch và ghi đè

Bộ C chỉ cần khi phần mềm hỗ trợ khai điều chỉnh chênh lệch: dùng submissionType=A cho mọi loại biểu mẫu được hỗ trợ, với cả giá trị dương và âm. Nộp theo ủy quyền đại lý trong Client e-Services Group hoặc theo tư cách người sử dụng lao động. Bộ D chỉ áp dụng khi hỗ trợ khai thay thế: dùng submissionType=R để thay bộ A; nếu bộ A có phụ lục thì bộ D cũng phải gồm phụ lục. A điều chỉnh, còn R ghi đè thông tin đã nộp; lưu số xác nhận riêng cho từng bộ.

Cảnh báo và cách xử lý trên hệ thống chính thức

Với dữ liệu sandbox cho năm thu nhập 2026, có thể dùng bypassWarning để bỏ qua cảnh báo cụ thể về việc nộp trước năm. Trên hệ thống chính thức, mặc định phải là false; chỉ cho người dùng tùy chọn true sau khi họ xác nhận đã xem cảnh báo được trả về. Không tự động vô hiệu hóa mọi lỗi hoặc cảnh báo.

Tự xác minh và thời điểm được liệt kê

Sau khi nhận liên kết biểu mẫu qua email, chỉ nộp Self-Verification Form khi có đủ số xác nhận A–D bắt buộc; hồ sơ thiếu thông tin không được chấp nhận. IRAS kiểm tra ngẫu nhiên, liên hệ trong hai tuần nếu cần làm rõ, hoặc thông báo bước tiếp theo. Việc đăng ký API chính thức mở từ ngày 1 tháng 10 năm 2026; khi IRAS xác nhận hoàn tất kiểm thử, họ thông báo trong mười ngày làm việc. Phải hoàn tất kết nối chính thức chậm nhất ngày 30 tháng 11 năm 2026; sau đó công ty được liệt kê trong hai tuần. IRAS có thể chưa công bố tên khi kiểm thử chưa hoàn tất thành công.

Năm bước cho người sử dụng lao động và đơn vị dịch vụ

Người sử dụng lao động hoặc đơn vị dịch vụ thực hiện năm bước: tham gia và đăng ký sandbox; tạo bộ O ngẫu nhiên với cùng số bản ghi tối thiểu; tùy chọn tự kiểm thử điều chỉnh chênh lệch, thay thế hoặc khai qua đại lý; nộp biểu mẫu tự xác minh với các số xác nhận cần thiết; cuối cùng kết nối hệ thống chính thức. Không phải báo cáo kết quả các bài tự kiểm thử tùy chọn. Nguồn dẫn sang bước 4 và 6 của phần nhà cung cấp để tham khảo, nhưng hướng dẫn chi tiết về điều chỉnh chênh lệch thực tế nằm ở bước 5, nên phải xem nội dung tương ứng. Mặc định cảnh báo và các mốc thời gian áp dụng như trên. Liên hệ data_mgmt@iras.gov.sg.

Nguồn chính thức

Bản dịch tiếng Việt giữ đầy đủ nội dung bài viết tiếng Trung, gồm mọi điều kiện, bước, bảng và phụ lục trong phạm vi bài; các thông tin thực chất được đối chiếu PDF chính thức bằng tiếng Anh. Đây không phải bản dịch nguyên văn toàn bộ mọi tài liệu được liên kết. Xem bản gốc để kiểm cách diễn đạt, ngày và cập nhật về sau.

Xem PDF gốc chính thức ↗
Liên hệ tư vấn
Liên hệ tư vấn