ksef-accountant-en

📑 波兰电子发票合规专家助手

波兰国家电子发票系统KSeF 2.0专业会计知识库,提供FA(3)发票结构、API集成、增值税合规等完整指导,纯文档型设计确保零代码执行风险。

收藏
7.7k
安装
2.3k
版本
2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

KSeF Accountant 是一款专注于波兰国家电子发票系统(KSeF 2.0)的专业知识型技能,采用纯文档架构设计,不包含任何可执行代码。该技能为会计人员和开发者提供完整的KSeF生态系统操作指南,涵盖FA(3)发票结构解析、KSeF 2.0 API调用模式、会计分录处理、增值税合规等核心领域。

用户可通过查询获取以下关键信息:发票开具与下载的完整API端点说明(包括Session初始化、发票发送、状态查询、同步查询等)、FA(3)与FA(2)的结构差异对比、销售与采购的标准会计工作流程、以及AI辅助功能的参考架构(费用分类、欺诈检测、现金流预测等算法的实现模式)。所有代码示例均为说明性质,用户需自行实现。

显著优点

零执行风险架构:作为纯Markdown文档型技能,无任何可执行脚本、二进制文件或运行时依赖,从根本上杜绝了代码注入、恶意执行等安全风险。

安全设计完善:采用多重安全声明机制——frontmatter中同时声明disableModelInvocation: truedisable-model-invocation: true,配套独立的skill.json清单文件,敏感环境变量明确标记secret: true,形成完整的安全元数据体系。

专业领域深度:覆盖KSeF 2.0全生命周期操作,包括紧急Offline24模式处理、UPO官方回执管理、MPP分割支付机制、更正发票流程、JPK_V7增值税申报表生成等高级场景,内容深度堪比官方技术文档。

合规意识突出:明确标注"非法律或税务建议",要求用户确认关键操作,强调DEMO环境测试优先,体现负责任的专业态度。

潜在缺点与局限性

平台依赖性强:安全标志的实际生效完全依赖托管平台的解析能力。若平台未能正确读取frontmatter或skill.json中的disable-model-invocation标志,技能可能被意外自动调用,导致未预期的行为。

纯知识无自动化:用户需自行实现所有代码示例,无法直接执行发票发送、状态查询等操作,对于追求即开即用体验的用户而言效率较低。

来源可信度有限:开发者账号为个人身份(T3级别),非官方机构或知名企业背书,在涉及财务合规的敏感场景中,部分企业可能对此有所顾虑。

时效性风险:KSeF作为政府电子政务系统,API规范和法律要求可能随政策调整而变化,文档内容存在滞后可能。

适合的目标群体

  • 波兰市场会计从业者:需要理解KSeF 2.0系统操作、FA(3)发票结构、增值税合规要求的专业会计人员
  • 企业ERP系统集成开发者:负责将KSeF API接入内部财务系统的技术团队
  • 跨国企业财务合规官:需要了解波兰电子发票法规以评估合规风险的管理人员
  • 财务SaaS产品团队:开发面向波兰市场的发票管理、费用报销等产品的产品经理和工程师

使用风险

平台安全验证风险:安装前必须人工验证平台注册表元数据是否与skill声明一致,若平台显示disable-model-invocation: false或未显示secret标记,则存在凭证泄露和未授权调用风险。

凭证管理风险:尽管skill声明不存储传输token,但若用户误将KSEF_TOKEN直接粘贴到对话中,且平台未正确隔离环境变量,可能导致敏感信息泄露。

生产环境误操作风险:KSeF生产环境(ksef.mf.gov.pl)开具的发票具有法律效力,若用户未充分测试即切换至生产环境,可能产生不可撤销的税务后果。

AI建议边界风险:skill提供的AI辅助功能(如费用分类、欺诈检测)仅为算法参考架构,实际部署需专业验证,盲目依赖可能导致分类错误或误判。

安全解读

核心用途

KSeF Accountant 是一款专为波兰国家电子发票系统(KSeF 2.0)设计的领域知识型Skill,面向在波兰开展业务或处理波兰VAT合规的企业会计、开发者和财务团队。

核心功能模块

1. KSeF 2.0 API操作

  • 会话初始化、发票发送与下载、状态查询
  • 支持Offline24应急模式、UPO官方回执获取
  • 完整端点文档与认证流程指引

2. FA(3)发票结构

  • FA(3)与FA(2)差异对比:附件支持、EMPLOYEE类型、扩展银行账号格式
  • 50,000行项目限额、JST和VAT组标识符
  • 完整XML示例(基础发票、多税率、更正发票、MPP分割支付)

3. 会计工作流

  • 销售端:生成FA(3)→发送KSeF→获取编号→过账
  • 采购端:查询KSeF→下载XML→AI分类→过账
  • 支付匹配、MPP分割支付机制、更正发票处理、VAT登记簿(JPK_V7)

4. AI辅助功能(参考架构)

  • 费用分类:基于承包商历史+关键词匹配+随机森林模型
  • 欺诈检测:孤立森林异常检测、VAT旋转木马图分析
  • 现金流预测:基于承包商历史、金额和季节性模式的回归模型

显著优点

  • 极致安全设计:instruction-only纯文档模式,零可执行代码、零依赖、零网络调用,获S+顶级安全评级
  • 双重安全标志disableModelInvocationdisable-model-invocation双重声明,配合skill.json机器可读清单
  • 凭证安全:敏感变量KSEF_TOKENKSEF_ENCRYPTION_KEY均标记secret: true,绝不存储或传输用户凭证
  • 平台无关性:仅提供知识与代码示例,用户自行实现,无运行时绑定
  • 完整参考体系:8份详细参考文档覆盖API、法律状态、FA3示例、工作流、AI特性、安全合规、故障排查

潜在局限

  • 非法律/税务建议:内容可能随KSeF系统更新而过时,重大决策需咨询税务顾问
  • 需用户自行实现:所有代码示例为教学性质,需用户根据实际技术栈开发
  • 平台依赖风险:安全标志(disableModelInvocation)需平台端强制执行,安装前必须验证注册表元数据
  • T3来源等级:社区个人开发者维护,虽经S+认证,但仍需用户自行审计内容

适合人群

| 用户类型 | 使用场景 |
|---------|---------|
| 波兰企业会计/财务 | 日常KSeF发票处理、VAT申报、支付匹配 |
| 跨境电商平台 | 波兰市场合规、自动发票系统集成 |
| ERP/SaaS开发者 | KSeF 2.0 API集成、FA(3)生成模块开发 |
| 税务顾问 | 客户KSeF系统配置咨询、合规审查 |
| 财务AI产品团队 | 费用分类、欺诈检测算法参考架构 |

常规风险与注意事项

安装前必做验证
1. 检查平台注册表元数据,disable-model-invocation必须为true

2. 确认环境变量显示secret标签,否则勿配置凭证

3. 仅使用DEMO环境(ksef-demo.mf.gov.pl)测试,生产环境需完整安全验证

使用禁忌

  • 绝不在对话中直接粘贴token、密钥或证书
  • 若平台未强制执行安全标志,视为高风险Skill,禁止配置凭证
  • AI辅助功能仅作参考,不得用于绑定税务或财务决策

法律合规

  • 生产环境发票具有法律效力,测试后务必确认环境切换
  • GDPR数据保留期后需匿名化处理
  • VAT白名单验证为强制前置步骤

ksef-accountant-en 内容

references文件夹
手动下载zip · 31.9 kB
ksef-accounting-workflows.mdtext/markdown
请选择文件