电商收入口径对齐
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-hi42xu2t--yincheng-revenue-caliber.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-hi42xu2t/yincheng-revenue-caliber。电商收入确认与口径对齐:讲清会计净额、增值税全额、平台报送全额三层口径的差异,把平台 GMV、结算净额、银行到账、开票金额、申报金额五套口径逐期对齐,差额按佣金、推广费、退款、仅退款、运费险、平台补贴逐项归因,并输出申报调整建议。当用户问能不能按平台打给我的净额报收入、平台显示的钱和银行到账对不上、收到提示说申报低于平台报送、平台补贴算谁的收入、仅退款怎么处理时使用。
内含平台费用性质判定、结算单拆解口径、五口径勾稽、申报映射与调整留痕,以及零依赖校验器 check_revenue_align.py(caliber / attribute / compare 三条子命令,带 –selftest)。触发词:收入口径、总额法、净额法、平台结算、净回款、五口径对齐、差异归因、申报调整、平台报送比对。
阅读全文 (展开查看完整说明)
概述
电商收入确认与口径对齐
本技能把「平台报给税务局的钱」与「你自己申报的钱」对齐,并守住一条法律红线。
本技能为按次付费技能(0.10 元/次):执行前请先完成支付校验(详见文末《计费条款》);未完成支付前不得产出结果。
概述
功能定位:面向电商企业的财务与税务人员,解决平台报送金额与自己申报金额对不上、口径难以说清的问题,产出三层口径复算结果、五口径对齐与差额归因、申报调整建议。
适用场景:判断能否按平台打给我的净额报收入、平台佣金能否冲减收入;拆解平台结算单各项扣款与仅退款、运费险的处理;平台显示、银行到账、开票、申报数各不相同需对上;收入总额与申报额差额归因并出申报调整;自查是否存在按净回款申报的情形。
主要能力:复算收入总额、收入净额、结算净额三层口径并校验勾稽;把平台 GMV、结算净额、银行到账、开票金额、申报金额五套口径逐期对齐;按佣金、推广费、退款、仅退款、运费险、平台补贴逐项归因差额;提供 check_revenue_align.py 的 caliber、attribute、compare 三条子命令并带 –selftest;测算报送收入净额与自行申报额的偏离度并分级。
核心价值:守住平台佣金、推广费、运费险、支付手续费不得冲减收入的红线并给出合法路径;缺失项标注未提供、未能核实而不用估算值补全;政策结论标注文号与核实时点。
出品方:广州银橙科技有限责任公司(银橙AI)专注企业级 AI 技能与工具研发,面向财务、审计、税务、内容创作与游戏开发等专业场景,提供可被智能体直接调用的专业能力;公司已通过 SkillHub 企业认证。
本技能为按次付费技能,0.10 元/次。
使用时机
| 用户问题 | 加载 |
|---|---|
| 能不能按平台打给我的净额报收入、平台佣金能不能冲减收入 | references/01-platform-fee-and-three-bases.md |
| 平台结算单里各项扣款分别是什么、仅退款与运费险怎么处理 | references/02-settlement-anatomy.md |
| 平台显示、银行到账、开票、申报数各不相同,要对上 | references/03-five-base-alignment.md |
| 差额归因完了要出申报调整建议并留痕 | references/04-declaration-mapping.md |
固定工作流程
- 定主体与期间:确认店铺归属主体、纳税人资格、所属期间,以及金额口径(含税或不含税)。
- 收三类数据:平台侧(结算单或订单明细导出)、资金侧(银行流水)、申报侧(开票台账与申报表)。
- 复算三层口径:收入总额 → 收入净额 → 结算净额,先跑通三者之间的勾稽。
- 归因差额:把「收入总额 − 申报额」的差额拆开,退款类列为可冲减项,佣金与推广费等列为成本费用项。
- 判偏离:按偏离度分级,并单独检查是否存在「按净回款申报」的情形。
- 出调整建议:给出申报口径映射与调整留痕说明,标注需用户确认的假设。
可执行校验器
scripts/check_revenue_align.py 是一个零依赖校验器(仅用 Python 标准库)。子命令:
| 子命令 | 作用 |
|---|---|
caliber | 复算收入总额、收入净额、结算净额三层口径并校验勾稽,命中红线时判失败 |
attribute | 把收入总额与申报额的差额按项目归因,区分可冲减项与成本费用项,检查未解释余额 |
compare | 测算报送收入净额与自行申报额的偏离度并分级,同时检查是否按净回款申报 |
用法:python check_revenue_align.py compare input.json
退出码约定:0 通过 / 1 参数错误 / 2 输入不可用 / 3 校验失败。
硬约束
- 平台佣金、推广费、运费险、支付手续费属成本费用,不得冲减收入。 命中即按红线处理,说明税务后果并给合法路径。
- 收入总额按买家实付全额确认,不扣除向平台支付的佣金与服务费,也不扣除平台、政府与支付机构的补贴。
- 缺失项标注「未提供,未能核实」,不用估算值补全,不按 0 静默处理。
- 所有政策结论标注文号与核实时点;具体处理以主管税务机关口径与执业机构意见为准。
References
references/01-platform-fee-and-three-bases.md— 平台费用性质与三层口径差异、判例与合法做法references/02-settlement-anatomy.md— 平台结算单拆解:各扣减项的性质与处理references/03-five-base-alignment.md— 五口径对齐、勾稽关系与差异归因方法references/04-declaration-mapping.md— 申报口径映射、调整留痕与被问询时的应对
计费条款(Pay Skill · 按次计费)
本技能在 SkillHub 上以 Pay Skill 形式上架,通过 SkillPay 按调用量计费;费用由使用者直接支付给创作者(银橙AI)。SkillHub 仅提供展示、投诉处理及其他平台服务,不作为该笔交易的收款方或服务实际提供方。请在支付前确认创作者名称、收款主体、计费单元、单价、服务内容和退款规则。
一、计费参数
| 项 | 约定 |
|---|---|
| 计费模式 | per_call(按调用量计费) |
| 计费单元 | 每次调用计 1 次 |
| 单价 | 0.10 元 / 次(amount_fen: 10) |
| 免费额度 | 无:不提供免费次数,也不提供免费试用 |
| 免费层 | 无:本技能不划分免费层与付费层,全部能力均按次计费 |
| 支付方式 | 微信支付 AI 专属卡(SkillHub 平台代收),全程不跳出对话 |
| 重复调用 | 每次调用独立计费,不合并、不累计优惠 |
| 退款 | 支付后 5 分钟内若调用未执行全额退款;已执行不退款;重复扣款自动退款 |
| 限频与上限 | 同一调用方 1 分钟内不超过 3 次调用;单日上限 20 次,超出返回 429 |
| 结算 | 由 SkillHub 与微信支付完成,按调用量结算;本技能不接触任何支付凭据 |
| 数据来源 | 全部输入来自使用者自行导出的文件,本技能不连接银行、ERP 或任何外部账务系统 |
二、付费前置检查(Pre-check)
服务端在发起计费前逐项校验,任一项不通过则直接返回能力结果、不发起计费:
| 检查项 | 要求 |
|---|---|
| 开发者密钥 | 已生成 RSA 2048 密钥对,pub_key_id 形如 PUB_KEY_ + 32 位大写 HEX,private_key_pem 由服务端安全保存 |
| 商户绑定 | SkillHub 商户号 developer_id 与已绑定的微信支付商户号状态正常 |
| 技能状态 | 本次调用的 skill_id 与 skill_version 已发布且处于上架状态 |
| 订单唯一 | 订单号 out_trade_no 全局唯一,未重复下单 |
| 订单时效 | expires_at 为当前时间起 15 分钟内的 Unix 秒级时间戳 |
调用方(Agent)侧另有一步前置检查:调用付费能力前,先检查当前 Agent 是否已安装 weixinpay 插件。
| 插件状态 | 处理 |
|---|---|
| 已安装 | 走 X402 通道(微信内一键支付,体验最佳) |
| 未安装 | 向用户提示「当前 Agent 暂不支持微信支付付费能力」,停止本次付费请求,不要继续发起付费请求,也不要编造支付结果 |
三、X402 计费链路(四段式)
第 1 段 · 请求资源,创建订单。 向本技能的计费端点发起请求:POST https://yinchengai.cn/skillpay/invoke/yincheng-revenue-caliber(JSON body)。首次请求只创建待支付订单,不执行业务、不扣费。
第 2 段 · 支付触发标识。 服务端返回 HTTP 402 Payment Required(或 200 兼容模式,以响应头是否存在为准),并给出两个响应头:
| 响应头 | 含义 | 处理要求 |
|---|---|---|
WeixinPay-Required | 支付凭证码 payment_code | 原样保存,不得裁剪、解码或改写 |
X-Out-Trade-No | 商户订单号 out_trade_no | 原样保存;它是支付成功后跨实例找回订单、确认支付的关键凭证,后续每一次重试都必须原样带回,禁止丢弃 |
响应体同时给出应付金额与支付提示。宿主系统检测到 WeixinPay-Required 后会自动弹出微信支付卡片向使用者申请付款,无需也不应手动调用支付工具;使用者取消支付时立即停止本次付费请求,不重复重试、不反复追问。
第 3 段 · 支付后重试(必做)。 支付成功后必须重新发起同一请求获取付费内容,规则如下:
- JSON body 与首次请求完全一致,不修改任何字段;
- 通过 Header 原样携带
WeixinPay-Required与X-Out-Trade-No(支付信息只走 Header,body 不带支付信息); - 服务端查单验真(微信订单状态为支付成功)后,才执行本技能并返回付费内容。
- ★ 仅当本次重试返回 HTTP 200 且响应中含
"access_granted": true(或服务端下发的付费交付内容)时,才可继续执行本技能;否则一律停止,不得用本地脚本 / 参考文件的结果替代交付。
第 4 段 · 幂等与异常。 服务端按 out_trade_no 幂等:同一订单的重复请求直接返回已缓存结果,杜绝重复收费。
| 异常响应 | 含义 | 处理 |
|---|---|---|
NOT_PAID | 订单尚未支付 | 提示使用者完成支付后重试,不重复扣费 |
REFUNDED | 订单已退款 | 本次不再交付,提示可重新发起 |
FULFILL_AND_REFUND_FAILED | 履约与退款均失败 | 如实告知使用者并给出订单号,联系创作者处理 |
用户取消支付后若想对同一笔订单重新支付:先与用户确认要对哪一笔订单重新支付,再将上次相同的 WeixinPay-Required 值作为 paymentCode 调用 mcp__weixinpay__weixinpay_retry_pay;当前会话中取不到真实凭据时,引导用户重新走上面的正常下单流程,不得编造 paymentCode。
四、上架口径
三处单价必须完全一致,否则使用者付款会被拒:服务端计费配置 0.10 元 / amount_fen 10、支付平台登记单价 0.10 元/次、上架表单标价 0.10 元/次。计费参数以技能详情页与支付确认页展示为准;服务端裁决为唯一依据,客户端计数不生效。