地区校准中心
先读这几条(所有地区通用)
- ·AI 和 RPA 都不替你承担税务责任。 系统只负责把数字搬过去,申报数据的正确性由持证人员负责,真实提交前必须人工复核
- ·验证码、短信、UKey、扫码一律转人工。 系统没有、也不会有自动识别验证码的能力——绕过验证码既违法,也会让客户税务账号直接暴露
- ·默认只演练不提交。 不显式关闭 dryRun,系统绝不点击「申报」按钮
- ·每一步都有截图留痕。 出了争议可以逐帧回看当时页面长什么样
系统部署在服务器上,操作员在网页控制台看截图、输验证码。适合账号密码登录的省份,**不支持 UKey 登录**(UKey 必须插在本地电脑)
操作员在自己电脑上运行客户端,浏览器在本地。适合强制 UKey、或 WAF 极严(如湖南/河北/山东)的省份,因为访问来自本地家庭宽带,特征更接近真人
https://etax.beijing.chinatax.gov.cn探测 200。直辖市,登录方式与省级系统不同,需单独校准。
一、开工前要准备什么
- 1.客户企业的纳税人识别号(统一社会信用代码)与电子税务局登录密码
- 2.已实名认证的办税人员手机号(收验证码用,必须是能用的人)
- 3.办税授权:由法定代表人或财务负责人在电子税务局「账户中心 → 人员权限管理」把代账会计添加为办税员,且被授权人本人完成实名确认。未授权则登录后会提示无权限
- 4.确认该企业的纳税人身份(小规模纳税人 / 一般纳税人)与申报周期(按月 / 按季)
- 5.确认该省是否支持「账号密码」直登,若强制 UKey 则云端自动化不可用,需改本地模式
- 6.一台固定出口 IP 的服务器:税务系统会记录登录 IP,IP 频繁变化极易触发风控
二、该省支持的登录方式
- 账号密码登录推荐
纳税人识别号(或统一社会信用代码)+ 登录密码,通常需要图形验证码或短信验证码。
- 数字证书 / 税务 UKey 登录
插 USBKey 后选择证书并输入证书口令。UKey 必须在本地机器,云端 RPA 用不了——这种情况下只能采用「本地代操作」模式,即操作员在自己电脑上运行。
- 电子营业执照 / 实名扫码登录
用微信或电子税务局 App 扫码。扫码必须在真人手机上完成,系统会在这一步停下等你扫码,属于人工闸门
三、申报菜单路径(以实际页面为准)
- 1.登录 → 首页 / 我的待办
- 2.我要办税 → 税费申报及缴纳
- 3.增值税及附加税费申报(小规模纳税人 / 一般纳税人,按企业身份选)
- 4.选择税款所属期 → 查询
- 5.填写申报表 → 暂存 → 校验
- 6.正式申报 → 获取受理回执
四、怎么校准(照着做)
- ① 准备一个真实但非关键的客户企业账号,或客户同意的测试账套。不要用正在申报期的关键客户做首次校准
- ② 用有头模式启动:
RPA_HEADLESS=false npm run dev(能看到浏览器实际操作过程,校准必备) - ③ 打开控制台 /rpa,选你的地区、引擎选 playwright、任务类型选「登录」、保持 dryRun
- ④ 任务会在验证码处停下,控制台显示截图,你输入验证码后点提交,流程继续
- ⑤ 看哪一步变红失败,点开该步截图对照真实页面
- ⑥ 在真实页面上按 F12 → 点左上角「选择元素」箭头 → 点目标元素 → 右键 Copy → Copy selector
- ⑦ 回校准页粘贴到对应项,优先用 text= 匹配文字(改版时 CSS 会变,按钮文字一般不会变)
- ⑧ 保存后 version 自动 +1,重跑任务,直到每一步都绿
- ⑨ 登录全流程绿灯后,再做一次「申报」任务(仍保持 dryRun),核对第 9 步交叉校验是否一致
- ⑩ 全部通过后,把该地区的「已校准」开关打开——此时才允许关闭 dryRun 做真实申报
五、选择器清单(在这里填)
login.username① 账号/纳税人识别号输入框登录页第一个文本框,F12 检查后 Copy → Copy selector
login.officer② 办税人身份证号/手机号输入框登录页第二步的输入框。有些省是「办税人证件号码」,有些省直接复用手机号框 —— 以页面标签为准
login.password密码输入框type="password" 的 input
login.captcha图形验证码输入框登录页标着「验证码」的 input。没有图形码的省留空
login.submit登录按钮用 text= 匹配按钮文字,比 CSS 更抗改版
home.marker登录成功的标志元素登录后页面上只有登录后才出现的文字,如「我的待办」「企业名称」。这是判断登录是否成功的关键
filing.entryUrl申报入口 URL点进申报菜单后,把浏览器地址栏整条 URL 抄下来
filing.period税款所属期选择控件可能是下拉框也可能是文本框,注意区分
filing.query查询按钮所属期旁的「查询」
filing.openForm打开申报表的入口列表里的「填写申报表」「申报」链接
filing.salesExTax销售额(不含税)输入框⚠️ 各省叫法不同:销售额、应征增值税不含税销售额、本期数…以页面标签为准
filing.outputTax销项税额一般纳税人有,小规模通常为「应纳税额」
filing.inputTax进项税额一般纳税人有,小规模无此栏(不抵扣)
filing.payable应纳税额本期应补(退)税额 / 应纳税额合计
filing.computedPayable页面自动算出的税额显示位置ⓘ 关键:这是交叉校验用的。填完页面会自动算,取那个只读数字所在元素,用于核对本地计算是否一致
filing.saveDraft暂存/保存按钮「暂存」「保存」「下一步」
filing.submit正式申报按钮真实提交相关⚠️ 真实提交,校准阶段务必保持 dryRun
filing.receipt受理回执标志真实提交相关申报成功后出现的「受理回执」「申报成功」字样
filing.pendingEntry首页「我的待办」登录后首页的待办区,点开就是本期要办的事
filing.pendingList「本期应申报」清册入口税局认定的本期应报税费清单(含状态:未申报/已申报)。⚠️ 报什么以这一屏为准,比我们推断的准
filing.formLink清册里的操作入口每行右侧的按钮,真实文案可能是「填写申报表」/「申报」/「去申报」,以页面为准(不要照抄默认配置)
filing.zeroFill「一键零申报」按钮(如有)零申报企业专用;没有也没关系,流程会退化为逐栏填 0(标 optional)
filing.submitConfirm提交确认弹窗「确定」真实提交相关统一规范系统点申报后会弹二次确认,漏点这一步等于没提交(与 P39 漏点验证码确定是同类错误)
六、常见失败与排查
- !页面在 iframe 里:很多省申报表嵌在 iframe 中,CSS 选择器选不到。解决办法:在 iframe 内右键「查看框架源代码」或在控制台 target 里加
frame=前缀(后续版本支持),当前版本若遇 iframe 请改用 text= 匹配 - !按钮文字带空格或全角符号:复制时容易带上不可见字符,建议手打一遍
- !同一个页面多个相同 class:Copy selector 出来的可能是 nth-child,改版即失效,优先用 id 或文字
- !登录后跳转慢:把 home.marker 的 timeoutMs 调大一点(默认 20 秒)
- !验证码形态变化:有的省是滑块、有的是点选文字。无论哪种,系统都不会自动破解,一律转人工闸门由你手动完成
- !申报期高峰拥堵:每月 1–15 号是申报高峰,系统响应慢、超时多。校准请避开这几天
- !北京登录成功后常见「多主体选择」页(一个账号挂多家企业),home.marker 要选进入具体企业之后的标志元素,否则后续步骤会在错误的主体下执行