历史版本与沙盒用途
六页指南标明版本2.0、2023年5月31日，标题为YA2022 API沙盒测试；免责声明另写资料截至2021年8月16日。使用其2021基础年度场景时须保留这些历史日期，不能把测试数据当作当前生产申报。沙盒模拟生产环境，供开发者在正式提交佣金记录前验证集成；更完整字段定义须结合API及身份认证规格。
创建账户与API订阅
在沙盒门户注册，并订阅Submission of Commission Records (Corppass)。通过注册表格登记软件回调URL。账户名与姓栏填写注册者实际姓名，再在My organisation按“机构名称_机构税务参考号码”规则更新机构名称。设置详情须结合佣金API CP规格第2节及Corppass身份认证API规格。
使用公布的测试机构
原文公布沙盒Singpass账号S9991256A、测试密码Spcp1111。API调用使用机构类别UEN-Local Business及机构号码98706710M；负载以organisationIDType 7表示该类别。以上是文件公开的沙盒测试凭据及虚构值，并非生产凭据。A组须采用指定值，只有authorisedPersonIDNo及idNumber须填有效身份号码；改用其他organisationIDNo会导致无法经API提交。
A组场景1：原始记录
设置validateOnly=false、BasisYear=2021、organisationIDType=7、organisationIDNo=98706710M、authorisedPersonIDtype=1及有效授权人NRIC。授权人为TESTER 1、职务MANAGER；机构TEST 1 PTE. LTD.；电话61234567；电邮[email protected]；batchIndicator O；记录数2；佣金总额49856。记录1的idType为1，填有效收款人NRIC，姓名EARNER 1、国籍301、性别M、职务代码3、出生日期19810320及佣金5396。记录2的idType为8，填有效收款人UEN、姓名EARNER 2及佣金44460。两笔合计49856。预期返回ES17DDMMYYCOMMNNNNNN模式回执、空fieldInfoList及returnCode 10。
A组场景2：负数修改
设置validateOnly=false、basisYear=2021、机构类别7及相同机构号码。授权人类别1、有效NRIC；姓名TESTER 2、职务IT SUPPORT；机构TEST 2 S’PORE BRANCH；电话91234567；电邮[email protected]。batchIndicator为A，记录数1，佣金总额-4256。唯一记录recordID 1、idType 1、有效NRIC、姓名EARNER 1、国籍301、性别M、职务代码3、出生日期19810320、佣金-4256。预期同样返回回执、无字段错误及returnCode 10。须保留负号与修改标志，不能当作另一笔正数原始申报。
A组场景3：重复记录校验
设置validateOnly=true，机构及授权人资料采用场景1；batchIndicator O，记录数2，佣金总额69520。两条记录均使用EARNER 1的同一有效NRIC、国籍301、性别M、职务代码3及出生日期19810320；recordID分别1及2，佣金分别25985及43535。预期returnCode 30、信息Arguments Error、messageCode 850301；fieldInfoList指向commissionEarnerDtl，提示Duplicate record exists，并标明recordID 2。即使金额合计正确，该仅校验场景仍应识别故意设置的重复身份记录。
B组及提交测试结果
自拟10至20条虚构测试记录，最好兼有个人及商业收款人，机构类别固定7、号码98706710M。成功的实际沙盒提交会返回回执。按原文模板将结果电邮至[email protected]：A组序号1和2的回执代码；B组的记录数及佣金总额。场景3是校验错误测试，原模板没有把它列为成功回执行。税务局说明10个工作日内回复测试结果。这是历史指南测试程序，并非允许在生产环境使用虚构记录。
官方来源
本文依据官方 PDF 的实质内容独立整理，涵盖相关条件、办理步骤及附录。原文链接用于核对官方措辞；文件日期与后续修订须另行确认。
查看官方 PDF 原文 ↗