Phiên bản lịch sử và mục đích sandbox
Hướng dẫn sáu trang ghi phiên bản 2.0 ngày 31 tháng 5 năm 2023, tiêu đề thử API sandbox YA2022; tuyên bố giới hạn lại ghi thông tin đến ngày 16 tháng 8 năm 2021. Khi dùng tình huống năm cơ sở 2021 phải giữ các mốc lịch sử này, không coi dữ liệu thử là khai trên hệ thống thật hiện tại. Sandbox mô phỏng môi trường thật để nhà phát triển kiểm tra tích hợp trước nộp hồ sơ hoa hồng thực; định nghĩa trường đầy đủ cần xem cùng đặc tả API và xác thực.
Tạo tài khoản và đăng ký API
Đăng ký ở cổng sandbox và đăng ký sử dụng Submission of Commission Records (Corppass). Đăng ký callback URL của phần mềm qua mẫu đăng ký. Điền First name và Last name là tên thật của người đăng ký, rồi trong My organisation đổi tên theo quy tắc “Tên tổ chức_Mã số thuế tổ chức”. Chi tiết thiết lập xem cùng mục 2 đặc tả Commission API CP và đặc tả API xác thực Corppass.
Dùng tổ chức thử được công bố
Nguồn công bố tài khoản Singpass sandbox S9991256A và mật khẩu thử Spcp1111. Lời gọi API dùng loại tổ chức UEN-Local Business, mã 98706710M; payload biểu diễn loại này bằng organisationIDType 7. Đây là thông tin thử sandbox công khai và giá trị giả định trong tài liệu, không phải thông tin đăng nhập môi trường thật. Nhóm A phải dùng giá trị chỉ định; riêng authorisedPersonIDNo và idNumber cần số định danh hợp lệ. Đổi organisationIDNo khác sẽ không nộp được qua API.
Nhóm A, tình huống 1: hồ sơ gốc
Đặt validateOnly=false, BasisYear=2021, organisationIDType=7, organisationIDNo=98706710M, authorisedPersonIDtype=1 và NRIC hợp lệ của người được ủy quyền. Người này tên TESTER 1, chức vụ MANAGER; tổ chức TEST 1 PTE. LTD.; điện thoại 61234567; email TESTER1@TEST1.COM; batchIndicator O; số hồ sơ 2; tổng hoa hồng 49856. Hồ sơ 1 có idType 1, NRIC hợp lệ của người nhận, tên EARNER 1, quốc tịch 301, giới tính M, mã chức vụ 3, ngày sinh 19810320 và hoa hồng 5396. Hồ sơ 2 có idType 8, UEN hợp lệ của người nhận, tên EARNER 2 và hoa hồng 44460. Tổng hai khoản là 49856. Dự kiến trả biên nhận dạng ES17DDMMYYCOMMNNNNNN, fieldInfoList rỗng và returnCode 10.
Nhóm A, tình huống 2: sửa bằng số âm
Đặt validateOnly=false, basisYear=2021, loại tổ chức 7 và cùng mã tổ chức. Loại người được ủy quyền 1, NRIC hợp lệ; tên TESTER 2, chức vụ IT SUPPORT; tổ chức TEST 2 S’PORE BRANCH; điện thoại 91234567; email TESTER2@TEST2.COM. batchIndicator A, số hồ sơ 1, tổng hoa hồng -4256. Hồ sơ duy nhất có recordID 1, idType 1, NRIC hợp lệ, tên EARNER 1, quốc tịch 301, giới tính M, mã chức vụ 3, ngày sinh 19810320, hoa hồng -4256. Dự kiến cũng có biên nhận, không lỗi trường và returnCode 10. Giữ dấu âm và cờ sửa, không coi như một tờ khai gốc số dương khác.
Nhóm A, tình huống 3: kiểm tra hồ sơ trùng
Đặt validateOnly=true, thông tin tổ chức và người được ủy quyền như tình huống 1; batchIndicator O, số hồ sơ 2, tổng hoa hồng 69520. Cả hai dùng cùng NRIC hợp lệ của EARNER 1, quốc tịch 301, giới tính M, mã chức vụ 3 và ngày sinh 19810320; recordID lần lượt 1 và 2, hoa hồng 25985 và 43535. Dự kiến returnCode 30, thông báo Arguments Error, messageCode 850301; fieldInfoList chỉ commissionEarnerDtl, báo Duplicate record exists và recordID 2. Dù tổng tiền đúng, tình huống chỉ kiểm tra này vẫn phải nhận diện định danh cố ý trùng.
Nhóm B và gửi kết quả thử
Tự tạo 10–20 hồ sơ thử giả định, tốt nhất gồm người nhận cá nhân và doanh nghiệp; cố định loại tổ chức 7, mã 98706710M. Lần nộp sandbox thành công thực sự trả biên nhận. Theo mẫu gốc gửi kết quả tới data_mgmt@iras.gov.sg: mã biên nhận nhóm A số 1, 2; số hồ sơ và tổng hoa hồng nhóm B. Tình huống 3 kiểm tra lỗi, không nằm trong các dòng biên nhận thành công của mẫu. IRAS nói trả kết quả thử trong mười ngày làm việc. Đây là quy trình thử của hướng dẫn lịch sử, không cho phép dùng hồ sơ giả định trong môi trường thật.
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 điều kiện, bước thực hiện và phụ lục trong phạm vi bài viết; các thông tin thực chất đã được đối chiếu với PDF chính thức. Liên kết bản gốc dùng kiểm tra cách diễn đạt chính thức; cần phân biệt ngày tài liệu và các sửa đổi về sau.
Xem PDF gốc chính thức ↗