2.6版本与用途
2026年9月11日二十二页规格供薪资开发者HTTP／JSON验证提交IR8A及附8A／8B，含接入安全限制、全部示例对象类别和响应。独立字段验证Excel作为参考附件，不把未载PDF规则自行编入。
版本兼容变更
2024年8月基线，11月安全；2025年5月定版加入OAuth2.1新端点、去ERIS B／C／D及更新例；6月邮编字符串；7／9／12月字符验证，12月响应三代码改字符串；2026年6月去未用messageCode更新响应，9月更新链接。勿混旧数字类型新样例。
接入：Corppass与先测试
订阅前须Corppass。APEX建立应用生成API密钥、OAuth2.1客户端及订阅。先沙盒，使用IRAS测试实体及沙盒客户端，每年验证软件兼容。通过测试获IRAS批准方接生产，亦建生产OAuth客户端。
授权流程与端点
OAuth2.1取得Corppass令牌，授权tax_agent=y代表客户，n自身业务。POST沙盒https://sandbox.api.gov.sg/iras/employment-income-records/v2/Submit，生产https://public.api.gov.sg/iras/employment-income-records/v2/Submit。页眉样例仍旧/iras/prod/EmpIncomeRecords/submit路径，应用现端点表而非当另选。
服务安全与头字段
服务器对服务器TLS及IP白名单，支持HTTP／2、TLS1.2／1.3、GET／POST及两指定ECDHE-RSA-AES256／128-GCM套件。头含x-apex-apikey、Authorization的Bearer加JWT Corppass令牌、Content-Type application/json，例亦Accept。授权scope为EmpIncomeSub，示例凭据不可当真实。
批量与重提限流
每请求最多2000雇员记录及8MB。提取的20001是2000加脚注1，原文2001拒绝例确认。3000分2000／1000各合大小，第二失败仅修重发第二，已接受第一无需重发。1000记录超8MB亦拒。记录上限应可配置，每应用每小时3000请求，429限流原文建议下小时重试。
生产限制与格式
生产仅实际AIS申报，测试被禁可能停终权限。JSON区分大小写驼峰，日期ISO8601 YYYY-MM-DD，除注明可选均提供属性。String(n)长度、Number(4)四位整数、Decimal(13,2)十三位整数两小数。允许ASCII32–127、ü／Ü／İ、换行回车、长短破折号及弯引号，按白名单非已改旧黑名单。
申报头全部类别
orgAndSubmissionInfo含仅验证／略警告开关、收入年雇主税号提交类型、授权人姓名电话邮箱、软件公司软件名、IR8A数量金额及附8A／8B数量。头数金额应与雇员阵列一致，具体必填取值验证查工作簿。
雇员身份任职字段
阵列每项有记录ID、证件型号、名生日性别、地址型三行、字符串邮编境外国码、职称银行码、入离职日及嵌ir8a／appendix8A／appendix8B。键须精确；概览iR8A与例ir8a大小写不同。多附录例把职称填addressType，与早例L／F不一致，勿由该例推断合格地址类型。
IR8A薪酬其他收入扣款
含支付期间、薪金奖金非合约奖金支付日、董事费批准日45指标、津贴佣金酬谢代通知自愿款、失职补偿指标、1993后养老金及基金名、境外雇主养老金与超额自愿CPF、10(1)(b)／(g)股票收益、实物福利其他及总额。另免税宽免额指标、雇主负税指标及雇主雇员负金额、CPF指定基金、工资捐款回教建筑基金及寿险。
附8A全部住房福利组
住宿重复记录含ID地址入住日天数共住人数、年值家具指标值、雇主租金住宿税值雇员分担、杂务水电司机佣园维护。阵列外酒店服务公寓实付员工付款税值、假期旅程附益、利息保险度假教育会所入转费、资产收益车辆全成本汽车福利其他非金钱及实物总额。
附8B股权薪酬与两总额
eebrRecords重复ID公司税号名计划型授予行权归属日、行权价每股市价股份数及毛收益；总额分2003后10(1)(b)与之前10(1)(g)。2.0移除ERIS B／C／D，不从旧负载插入。
仅IR8A三雇员例
2024原申报三记录共165000、附录零。A薪36000加奖3000合39000，CPF7800捐12；B薪24000奖2000合26000六月30离；C境外地址董事费100000六月30批准45指标Y。每雇员仍有空附录对象，示例身份不是实际纳税事实。
多附录例与内部不一致
一雇员总收入77000、8A8B各一。两住宿租1000无分担，继租1500减800得700，各杂费司机维护300。例把2024一月1至六月30列181日但该年闰，应核实际日期非抄数字。ESOW500股市价4零行权得2000，2003前ESOP1000股价1得1000。部分示例总额期间须依工作簿验证，不当逐项税额演算。
全部响应代码诊断
returnCode字符串10成功处理、20接受但非致命警告、30错误未处理、40警告未处理。提交成功data.acknowledgementCode字符串。info含代码消息警告字段列表，定位节字段消息记录ID，同错可合列。850301参数、850302异常、850305沙盒用户无效。表Info／info及recordID与例recordId混，须验证准确运行键大小写。
警告与仅验证不同
略警告true可20接受带警，false有警40未提交；清洁请求10。仅验证true即10仍不提交无确认码，亦须有效令牌。接受生产申报发公司联系人及申报邮箱，邮件截图示收据非替代接口确认。
错误例与实施核对
缺授权名生日支付起日出字段诊断，错误结束日可要求收入年12月31或离职日。例混2024收入与2025日期错误消息，按真实收入年及工作簿非固定样年。修改且不略警可40停止，异常30／850302联系[email protected]。区分验证提交，保存确认对已接受批，只改失败块，保官方规格工作簿链接。
官方来源
本文依据官方 PDF 的实质内容独立整理，涵盖相关条件、办理步骤及附录。原文链接用于核对官方措辞；文件日期与后续修订须另行确认。
查看官方 PDF 原文 ↗