FreshBooks账单管理

技能简介

freshbooks-cli 是一款面向 FreshBooks 云会计平台的命令行工具，支持通过终端完成发票创建、客户维护、账单查询等核心财务操作。该工具基于官方 SDK 构建，采用 OAuth2 认证机制，适合需要批量处理财务数据或集成到自动化工作流的场景。

业务背景

财务人员无需登录FreshBooks网页端，即可在命令行快速完成发票开具、客户档案维护等高频操作。特别适合需要批量处理账单或将其嵌入自动化脚本的企业，减少重复点击，提升账务处理效率。

落地案例：某自由职业者每月需为20+客户开具发票。通过freshbooks-cli，他在终端执行一条命令即可生成带明细的发票并直接获取分享链接发送给客户；月底批量归档已完成发票时，系统自动刷新令牌无需重新登录，全程无需打开浏览器。

能做什么

• 创建、查询、更新客户档案与联系信息
• 生成带明细项目的发票并获取分享链接
• 归档发票（FreshBooks 不支持永久删除）
• 自动刷新访问令牌，减少重复登录
• 以 JSON 格式输出全部数据，便于管道处理

使用说明

安装指令

npm install -g @haseebuchiha/freshbooks-cli

需在 .npmrc 中配置 GitHub Package Registry：@haseebuchiha:registry=https://npm.pkg.github.com

首次配置（一次性）

1. 执行登录命令（必须使用 --manual 模式）：
   freshbooks auth login --client-id "<ID>" --client-secret "<SECRET>" --manual
2. 浏览器授权后，复制页面返回的代码粘贴至终端
3. 验证状态：freshbooks auth status

常用操作示例

• 创建客户：freshbooks clients create --fname "张三" --organization "示例公司"
• 创建发票：freshbooks invoices create --client-id 818183 --lines '[{"name":"服务","qty":1,"unitCost":{"amount":"15000.00","code":"USD"}}]'
• 获取分享链接：freshbooks invoices share-link <invoice-id>

输入与输出

见下方输入与输出表格。

风险提示

• 修改发票或客户数据前需人工确认，避免误操作
• 金额字段为字符串格式，禁止转换为数值类型处理
• 令牌存储于本地配置文件，需确保文件权限为 0600
• 仅支持归档操作，无法恢复已归档发票
• localhost 回调地址不可用，必须采用手动授权流程

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/haseebuchiha/freshbooks-cli/SKILL.md
来源类型：GitHub 开源项目