名称： bexio
描述： Bexio 瑞士商业软件 API，用于管理联系人、报价/方案、发票、订单以及商品/产品。适用于处理 Bexio CRM、创建或管理发票、报价、销售订单、联系人管理或瑞士商业管理任务。支持列出、搜索、创建、编辑联系人和销售文档。

Bexio

瑞士商业软件 API，涵盖 CRM、发票、报价、订单和产品管理。

设置

从 Bexio 获取您的个人访问令牌（PAT）：
1. 访问 https://office.bexio.com → 设置 → 安全 → 个人访问令牌
2. 创建具有所需权限范围的新令牌

将令牌存储在 ~/.clawdbot/clawdbot.json 中：

{
  "skills": {
    "entries": {
      "bexio": {
        "accessToken": "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

或设置环境变量：BEXIO_ACCESS_TOKEN=xxx

所需权限范围

• contact_show, contact_edit - 联系人
• kb_offer_show, kb_offer_edit - 报价/方案
• kb_invoice_show, kb_invoice_edit - 发票
• kb_order_show, kb_order_edit - 订单
• article_show - 商品/产品

快速参考

联系人

{baseDir}/scripts/bexio.sh contacts list              # 列出所有联系人
{baseDir}/scripts/bexio.sh contacts search "查询词"   # 搜索联系人
{baseDir}/scripts/bexio.sh contacts show <id>         # 获取联系人详情
{baseDir}/scripts/bexio.sh contacts create --name "公司名" --type company
{baseDir}/scripts/bexio.sh contacts edit <id> --email "新邮箱@email.com"

报价/方案

{baseDir}/scripts/bexio.sh quotes list                # 列出报价
{baseDir}/scripts/bexio.sh quotes search "查询词"     # 搜索报价
{baseDir}/scripts/bexio.sh quotes show <id>           # 获取报价详情
{baseDir}/scripts/bexio.sh quotes create --contact <id> --title "项目报价"
{baseDir}/scripts/bexio.sh quotes clone <id>          # 克隆报价
{baseDir}/scripts/bexio.sh quotes send <id> --email "客户@email.com"

发票

{baseDir}/scripts/bexio.sh invoices list              # 列出发票
{baseDir}/scripts/bexio.sh invoices search "查询词"   # 搜索发票
{baseDir}/scripts/bexio.sh invoices show <id>         # 获取发票详情
{baseDir}/scripts/bexio.sh invoices create --contact <id> --title "发票"
{baseDir}/scripts/bexio.sh invoices issue <id>        # 发布草稿发票
{baseDir}/scripts/bexio.sh invoices send <id> --email "客户@email.com"
{baseDir}/scripts/bexio.sh invoices cancel <id>       # 取消发票

订单

{baseDir}/scripts/bexio.sh orders list                # 列出订单
{baseDir}/scripts/bexio.sh orders search "查询词"     # 搜索订单
{baseDir}/scripts/bexio.sh orders show <id>           # 获取订单详情
{baseDir}/scripts/bexio.sh orders create --contact <id> --title "销售订单"

商品/产品

{baseDir}/scripts/bexio.sh items list                 # 列出所有商品
{baseDir}/scripts/bexio.sh items search "查询词"      # 搜索商品
{baseDir}/scripts/bexio.sh items show <id>            # 获取商品详情

文档状态

• 报价：draft（草稿）, pending（待处理）, accepted（已接受）, declined（已拒绝）
• 发票：draft（草稿）, pending（待支付）, paid（已支付）, partial（部分支付）, canceled（已取消）
• 订单：draft（草稿）, pending（待处理）, done（已完成）

注意事项

• API 基础地址：https://api.bexio.com
• 认证方式：在请求头中使用 Bearer 令牌
• 速率限制：约 1000 次请求/分钟（请检查 X-RateLimit-* 响应头）
• 分页：使用 ?limit=X&offset=Y 参数
• 创建或编辑文档前请务必确认

API 参考

详细端点文档请参阅 references/api.md。