Agent Skills
返回列表
优E通税务零申报

优E通税务零申报

行业专业 更新于 2026.08.30

将以下提示词粘贴到你的 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 申报情况(含 declaration OSS 图片解码后展示)、财务报表年报、登录管理列表(含切换次数限额)、任务记录 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 路径理解组织—税号—登录号链路