Paperasse × Qonto/Stripe集成指南3步自动同步银行流水与支付数据彻底告别手工导表【免费下载链接】paperasse Skills pour agents IA spécialisés dans la bureaucratie française : Comptable, Notaire, ...项目地址: https://gitcode.com/gh_mirrors/pa/paperassePaperasse是一个为法国行政办公打造的 AI 技能集Comptable、Notaire 等专家角色内置Qonto 银行流水与Stripe 支付数据自动同步连接器。只需一条命令npm run fetch即可把银行账户交易和在线收款数据拉取到本地标准化 JSON 文件自动完成对账、分类和账簿生成让新手也能告别每月手工导出 CSV、逐行核对的重复劳动。为什么需要自动同步银行流水如果你用 Qonto 做企业网银、用 Stripe 收款传统流程是每个月登录后台手动导出 CSV用 Excel 清洗、归类、核对余额再交给会计或 AI 做账。Paperasse 在 integrations/ 目录内置了两个连接器直接调用官方 API 拉取全量数据连接器拉取内容需要的环境变量Qontofetch.js所有银行账户的全部交易流水QONTO_ID、QONTO_API_SECRETStripefetch.js充值、手续费、结算、退款等交易明细 结算单每个账户一个密钥变量如STRIPE_SECRET两个连接器还自带安全网Qonto 拉取后会逐笔校验累计余额连续性一旦导出中出现交易缺失会立即报警Stripe 支持单账户、多账户以及 Stripe Connect 子账户三种模式混用。第一步准备 company.json 配置文件所有配置集中在一个company.json里。项目根目录提供了完整示例 company.example.json复制一份后修改即可关键部分如下{ qonto: { enabled: true }, stripe_accounts: [ { id: main, name: Mon SaaS, env_key: STRIPE_SECRET } ] }qonto.enabled: true才会在拉取时启用 Qontostripe_accounts是一个数组可以配置任意多个 Stripe 账户env_key指向存放密钥的环境变量名。第二步配置 Qonto API 密钥打开 Qonto 后台Settings Integrations API记下你的 Organization slug 和 Secret key设置为环境变量export QONTO_IDvotre-organisation export QONTO_API_SECRETvotre-secret⚠️ 密钥只放在环境变量里永远不要提交到仓库或写进任何文件。第三步配置 Stripe 账户打开 Stripe 后台Developers API keys复制 Secret keysk_live_...或sk_test_...设置为环境变量例如export STRIPE_SECRETsk_live_...在company.json的stripe_accounts中登记该账户。多账户和 Stripe Connect 怎么办每个产品/子账户加一条记录、指定不同的env_key即可Connect 场景再加上stripe_account_id即acct_xxx连接器会自动携带Stripe-Account请求头以子账户身份调用 API。详见 integrations/README.md 的完整说明。一键拉取npm 命令速查配置完成后package.json 中预置了以下命令覆盖日常所有场景npm run fetch # 一键拉取 Qonto Stripe 全部数据 npm run fetch:qonto # 只拉银行流水 npm run fetch:stripe # 只拉支付数据需要按时间范围过滤时直接传参数即可node integrations/qonto/fetch.js --start 2025-01-01 --end 2025-12-31 node integrations/stripe/fetch.js --start 2025-01-01 --end 2025-12-31 --account main数据拉下来之后自动对账与成账所有交易统一写入data/transactions/目录如qonto-账户.json、stripe-账户.json并转换为 Paperasse 标准格式id、source、date、amount、currency、label等字段齐全our_category字段留给会计技能comptable后续自动归类到 PCG 科目。之后的高阶玩法银行对账自动化每个 Stripe 结算单payout对应一笔 Qonto 入账交叉核对即可自动发现在途结算或直接支出详见 comptable/references/integrations.mdStripe → 发票 → Qonto 全链路scripts/import-stripe-invoices.js 把已支付的 Stripe 账单自动转成合规发票含 Factur-Xscripts/upload-qonto-attachments.js 再把 PDF 回传挂到 Qonto 对应交易上全流程幂等、重复运行不会重复建号完整流程见 comptable/references/facturation/stripe-sync.md关账一条龙npm run closing自动生成 FEC、财务报表和 PDF。常见问题速查问题原因与解决提示Qonto 被忽略检查company.json中qonto.enabled是否为true且两个环境变量已设置Stripe 某账户被跳过对应的env_key环境变量未定义脚本会打印警告并跳过该账户想只查一个 Stripe 账户加--account id参数id 即stripe_accounts[].id拉取的日期对不上Qonto 按结算日settled_at过滤这是有会计意义、影响余额的日期属预期行为小结Paperasse 的集成体系把银行流水 支付数据的同步压缩成了三步填好 company.example.json 配置 → 设置环境变量 → 运行npm run fetch。数据自动落盘、自动校验、自动进入对账和成账流程配合 comptable/SKILL.md 定义的 12 步关账工作流从日常记账到年度 FEC 都能一条流水线跑完——这正是它告别手工导表的核心价值所在。【免费下载链接】paperasse Skills pour agents IA spécialisés dans la bureaucratie française : Comptable, Notaire, ...项目地址: https://gitcode.com/gh_mirrors/pa/paperasse创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
