优E通税务零申报
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-out31vpi/youyitong-shuiwulingshenbao。
技能介绍
要解决什么问题
小规模企业或代账场景里,零申报和申报状态核对往往要在优E通(YYT)后台与电子税局之间来回切换:先选对组织与税号,再确认税局登录号是否在线,最后才能发起任务或查表。把这套流程搬进对话,需要模型按固定顺序调 REST API,并把 JSON 里的状态码翻译成工程师能一眼看懂的表格。
技能如何工作
技能以 https://api-new.yoyitong.com 为 BASE_URL,所有请求在 Header 里携带 y-api-key: ${API-KEY}。执行任何业务前,先用 memory_search 查找记忆中的 yyt-api-key;没有则提示用户写入密钥,并说明未开通功能时可通过微信小程序下单获取账号。
核心能力分三层:
- 会话上下文:通用功能一~三依次完成「登录组织 → 登录税号 → 选择税局登录号(企业/代理业务)」,多候选时用名称或手机号模糊匹配;若
signInStatus为空则视为未登录,零申报前需走税局登录。 - 查询与展示:组织列表、启用税号、税局登录号、指定月份
taxCategoryList申报情况(含declarationOSS 图片解码后展示)、财务报表年报、登录管理列表(含切换次数限额)、任务记录taxMainTaskList等,统一按 Markdown 表格输出,并对status、cycleId、type等字段做映射。 - 操作类:
PUT /tax/taxMainTask提交当前YYYY-MM的零申报(type: 1);PUT /tax/taxEntityApplication新建税号(需用户确认 body 中的企业名称、识别号、开通年数、provinceCode)。
全局约定:响应按 application/json 解析;非 JSON(如 HTML)需明确报错。意图不明确时必须追问到可执行参数为止。
适用边界与注意点
- 本技能描述的是 优E通开放平台 API 的调用编排,不包含税局短信验证码登录的具体 UI 步骤(仅在其他意图中引用「税局登录」)。
- 零申报依赖已选中的税局登录号身份
taxAccountRoleId及该手机号在平台上的登录状态。 - 新建税号、提交零申报等写操作会在调用前展示参数或依赖前置通用功能,误选组织/税号会导致任务落到错误主体上,多主体环境建议先「查询我的组织」再切换。
使用场景
- 月末需在对话里先切换组织与税号,再查当月各税种申报状态并打开申报查询截图核对
- 多家客户主体并存时,按企业名称切换税号后拉取启用税局登录号,确认手机号是否已登录再提交零申报
- 代账人员收到「零申报」指令后,选定代理业务登录号并调用任务接口提交当前 YYYY-MM 期零申报
- 新签客户要在当前组织下新建税号,核对企业名称、纳税人识别号、开通年数与省份代码后发起申请
适合人员
- 代理记账公司财税员,需在多个客户组织间切换并批量查看申报与任务记录
- 小微企业财务负责人,自己管一两套税号,偶尔查申报情况或发起零申报
- 使用优E通税企模块的内部运维,要查登录管理列表与切换次数是否触达限额
- 刚接入优E通开放平台的集成开发,需要对照意图与 API 路径理解组织—税号—登录号链路