公文包(预览版)

询问您的书籍内容:交易、增值税、帐单、索赔和报告。

此连接器在以下产品和区域中可用:

Service Class Regions
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Logic Apps 标准 除以下各项外的所有 逻辑应用区域 :
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人
Name 公文包
URL https://briefcase.so
Email support@briefcase.so
连接器元数据
Publisher 公文包
Website https://briefcase.so
隐私策略 https://briefcase.so/privacy-policy
Categories 人工智能;数据

公文包

公文包是英国企业及其会计师的会计软件。 它读取收据、发票和银行行,用显示的原因对其进行编码,并在公文包账本、Xero 或 QuickBooks 中使书籍保持最新。

此 MCP 服务器允许智能 Microsoft 365 Copilot 副驾驶®和Copilot Studio代理将公文包用作已登录用户:回答有关客户端书籍、上传文档、审阅和发布交易的问题、准备费用声明、管理财务收盘以及公文箱账本客户端、运行报表、发布手动日记和提出销售发票。

Publisher

公文包 Tech Ltd (https://briefcase.so)

Prerequisites

  • 有权访问至少一个客户端的公文包帐户(https://app.briefcase.so)。
  • 公文包工作区中允许的 AI 助手。 工作区管理员在“设置” > AI 助手中控制这一点。

支持的操作

52 个工具,按区域分组。 每个工具都充当登录用户,在连接时选择的客户端上。

帐户和客户端

  • briefcase_get_connection (获取连接):标识已登录的公文包用户、工作区和此助理授予。
  • briefcase_list_clients (列出客户端):列出此用户可以在授权下访问的客户端,其中包含等待评审、处理、失败和已发布计数。
  • briefcase_get_client (获取客户端):一个客户端:名称、账本类型(Xero、QuickBooks 或公文包账本)、文档转发电子邮件、Autopilot 是否打开,对于公文箱账本客户端,常规账本锁定日期。
  • briefcase_list_users (列出用户):列出允许的工作区或具有角色、有效权限和可见客户端分配的客户端用户。 现有的用户目录限制适用。
  • briefcase_list_contacts (列出联系人):搜索客户的供应商、客户和索赔者。
  • briefcase_get_contact (获取联系人):客户端绑定 ID 的联系人详细信息。
  • briefcase_get_reference_data (获取参考数据):查找帐户、税率、跟踪类别、货币、企业、财产、索赔者或销售项目(briefcase_raise_sales_invoice使用的公文包账本)。 返回最多 150 个项,总计为 150 个;使用account_class或search_term缩小帐户范围。
  • briefcase_list_ai_memories (列出 AI 记忆):客户端的活动 AI 记忆:处理规则公文包适用于其文档,例如如何编码供应商或要使用的截止日期约定。

文档和事务

  • briefcase_create_document_upload (创建文档上传):开始上传:返回生存期较短的上传 URL、公文包浏览器上传链接和客户端转发电子邮件。 提供文件时,公文包会下载该文件本身,上传即可提交。 注意携带用户的处理说明,如在应用中键入,公文包应用它们:帐户或用于代码的帐户或用途、跟踪类别、项目或位置(Xero 和 QuickBooks)、百分比拆分、将行分开或组合在一起,并将收据作为员工的支出声明(添加到其每月索赔中)。
  • briefcase_submit_document (提交文档):提交通过briefcase_create_document_upload上传的文件进行处理,就像在公文包应用中上传一样。 返回要遵循 briefcase_get_operation; 的操作;不生成事务的文档将报告为失败。
  • briefcase_get_operation (获取操作):写入或拒绝写入的持久状态。 不会存储成功的读取。
  • briefcase_get_attachment_download (获取附件下载):客户端绑定附件的短期下载 URL,包括从briefcase_get_sales_invoice引发的销售发票 PDF(pdf.attachment_id)。 签名的链接在expires_at停止工作。
  • briefcase_list_transactions (列出事务):搜索和筛选等待评审、处理、已发布或存档事务。
  • briefcase_get_transaction (获取交易):客户可见的事务详细信息、行项、附件、Autopilot 说明和发布阻止程序。
  • briefcase_update_transaction (更新事务):保存事务编辑而不发布。 最后写入获胜。 仅更改提供的字段。 提供line_items时,它是保留的完整集:已删除现有行项;省略line_items使其保持不变。
  • briefcase_publish_transaction (发布事务):将审阅的事务发布到账本。 预览返回阻止器和账本操作;执行公文包账本的帖子或创建 Xero/QuickBooks 文档。
  • briefcase_archive_transaction (存档事务):存档事务,在适用情况下反转其账本发布。 预览显示账本操作和计划影响。 仅支持 DELETED 的原因。
  • briefcase_list_archived_documents (列出存档的文档):存档交易、候选人、银行账单、供应商账单和销售发票。
  • briefcase_get_archived_document (获取存档文档):一个按存档 ID 存档的项目。
  • briefcase_unarchive_document (无存档文档):还原存档的事务、候选或语句。 销售发票不能未存档。

支出声明

  • briefcase_list_expense_claims (列出费用声明):列出客户端的费用声明。
  • briefcase_get_expense_claim (获取费用声明):费用索赔详细信息、成员资格和发布状态。
  • briefcase_create_expense_claim (创建费用声明):从一个或多个未发布的事务创建声明。
  • briefcase_add_claim_transactions (添加声明事务):将未发布的事务添加到现有声明。
  • briefcase_remove_claim_transaction (删除声明事务):从未发布的声明中删除事务。
  • briefcase_publish_expense_claim (发布费用索赔):除非重写,否则使用其存储的索赔人、日期和货币发布费用索赔。 预览返回将使用的阻止器和值。
  • briefcase_delete_expense_claim (删除费用声明):删除费用索赔,撤销其公文包日记,或删除其 Xero 发票(如果发布);应用付款时被拒绝。 除非archive_transactions属实,否则回执将返回复查。

银行

  • briefcase_list_bank_statements (列出银行帐单):客户银行对账单,其匹配状态。
  • briefcase_get_bank_statement (获取银行账单):银行帐单详细信息和行。
  • briefcase_list_bank_transactions (列出银行交易):公文包银行账户账本银行源行,最新。 running_balance是每个协调行后的协调余额,如公文包中所示;未协调的行没有。 连接客户端返回UNSUPPORTED_CAPABILITY。

财务收盘

  • briefcase_list_close_items (列出收盘项目):列出预付款、延期收入、固定资产或应计。 计划携带period_summary,而不是其时间段;获取一个具有briefcase_get_close_item的时间段。 Accruals 包括类型化的父引用和调整引用;存档的累积读取返回存档调整,而不是存档的父级。
  • briefcase_get_close_item (获取关闭项目):给定模块的一个财务关闭项。 计划返回最多 120 个周期,从下一个未发布时间段之前的一年开始;为其他人传递period_start_date和period_end_date。 从文档创建的计划的第一个周期为负,将未发布的金额移到资产负债表:在未创建文档的情况下创建的一个文档保存在opening_balance中。 对于应计,请确定目标是父级定期费用还是调整,包括存档调整。
  • briefcase_get_close_tracker (接近跟踪器):预付款、延迟收入和固定资产的周期网格。 累算跟踪器数学不是那个网格。 默认范围是当前日历年份。
  • briefcase_create_close_item (创建关闭项目):创建正在等待审阅的草稿关闭项目:没有帖子。 预付款和延期收入需要金额、start_date、end_date、联系人和两个帐户:除非提供,否则会每月生成句点。 固定资产需要金额(成本)、acquisition_date、residual_value、useful_life_months和asset_account_id。 应计需要日期、说明、liability_account_id以及包含金额的行或expense_account_id,并返回recurring_expense_id加adjustment_id。
  • briefcase_update_close_item (更新关闭项目):将编辑保存到仍在审阅中的关闭项;没有帖子。 仅提供更改的字段。 除非提供时间段,否则更改金额、日期、频率或开张余额将重新生成周期。 累积编辑以草稿调整为目标(close_item_id是adjustment_id),并按步骤保持链接的草稿逆转。
  • briefcase_publish_close_item (发布关闭项目):发布关闭项目并发布其计划或应计。
  • briefcase_archive_close_item (存档关闭项目):存档关闭项目。 预付款、延期收入和固定资产存档,并撤销其发布的日记。 对于应计,只能存档草稿调整,而不是提交调整或定期费用本身。
  • briefcase_unarchive_close_item (无存档关闭项):还原存档的关闭项,以便可以再次编辑或发布它。 还原时不会发布任何内容。

报告和日记(公文箱账本)

  • briefcase_get_profit_and_loss (获取利润和亏损):公文包账本客户端在日期范围内(按收入和支出帐户)的利润和损失,其销售额、毛利润和可选的比较范围。 没有移动的帐户被排除在外。帐户 ID 在briefcase_list_journals中充当account_id。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_get_balance_sheet (获取资产负债表):公文包账本客户端的资产负债表,按资产、负债和股票帐户(按资产、负债和股票帐户)的资产负债表,保留收益和可选的比较日期。 没有余额的帐户被排除在外。连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_get_trial_balance (获取试用余额):公文包账本客户端的试用余额(默认值为今天):每一个在借记或信贷列有余额的帐户、截至至今的财政年度收入和支出帐户、按保留收益提出的早期利润,以及账本余额时同意的总计。 使用客户财务年度结束,或 4 月 6 日用于个人,1 月 1 日用于无一家公司。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_get_working_paper (获取工作论文):公文箱账本客户端的工作文件(期关闭):最近一个时期是最新的,加上最新的一个或一个完全命名的。 显示关闭状态(银行阻止程序、待决账单、打开客户端请求)、未发布的发票和到期日期的调整草案,以及每个资产负债表帐户的对帐:状态、谁注销以及支持余额和差异的时间,以及余额是否自注销以来发生了变化。 休眠帐户计数,未列出。 只读;协调和关闭发生在公文包。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_get_aged_report (获取过期报告):年迈的债权人(ACCOUNTS_PAYABLE)或年迈的债务人(ACCOUNTS_RECEIVABLE)作为公文箱账本客户端的日期(默认值):每个联系人的桶总计,然后按未结金额订购的联系人,每个发票最多 10 张。 完整传递一个联系人的contact_id。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_list_journals (列出日记):公文包账本客户端的常规账本日记,最先。 传递帐户活动的account_id:借记、信用额度和总计,然后仅涵盖该帐户。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_get_journal (获取日记):一个总账本日记,其中包含其行、源文档链接和反向链接。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_create_manual_journal (创建手动日记):在公文包账本客户端上发布手动日记。 行是主要单位的总金额,每个单位是借记或信贷之一;tax_rate_id将 VAT 拆分为 VAT 帐户。 收入、支出和固定资产行需要tax_rate_id(无任何适用增值税):所有其他行都必须省略它。 预览版会阻止锁定时间段、不平衡的行、丢失或错放税率、保留或删除的帐户以及跨越企业或属性的行。 反向是仅限 Web 的。 连接客户端返回UNSUPPORTED_CAPABILITY。

销售发票(公文箱账本)

  • briefcase_list_sales_invoices (列出销售发票):以公文包形式为公文包账本客户端筹集的销售发票,最先是最新。 默认状态全部。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_get_sales_invoice (获取销售发票):一个带有行、总计、未结余额、付款和电子邮件的销售发票。 使用 pdf.attachment_id 下载带有briefcase_get_attachment_download的 PDF。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_raise_sales_invoice (开具销售发票):从销售项目(briefcase_get_reference_data种类项目)为公文箱账本客户提出和发布销售发票。 银行详细信息默认为企业的付款帐户。 预览显示行和总计,并阻止锁定期以及缺少颁发者或客户详细信息。 从不向客户发送电子邮件;反向是仅限 Web 的。 连接客户端返回UNSUPPORTED_CAPABILITY。
  • briefcase_create_customer (创建客户):将客户添加到公文包账本客户端。 预览列出了具有类似姓名或相同电子邮件的现有联系人;除非confirm_new_despite_candidates为 true,否则执行拒绝。 重复使用具有相同名称的联系人,而不是重复的。 连接客户端返回UNSUPPORTED_CAPABILITY。

帮助

  • briefcase_search_help (搜索帮助):搜索已发布的帮助文章。
  • briefcase_get_help_article (获取帮助文章):已发布的帮助文章或产品更新正文。

获取凭据

公文包使用 OAuth 2.0 和用户的公文包登录。 创建连接时,公文包会要求用户登录,选择助手可以使用的客户端,然后批准。 无需事先在公文包中设置任何内容。

入门

  1. 将公文包添加到代理并创建连接。
  2. 登录到公文包,选择客户端并批准。
  3. 请求,例如:
    • 谁欠我们钱?
    • 哪些账单正在等待审查?
    • 我们今年在软件上花费了什么?
    • 将此收据上传到 Dunder Mifflin。

已知问题和限制

  • 报告(利润和亏损、资产负债表、试用余额、年迈的债务人和债权人、工作论文)、日记、手册日记、银行源行、销售发票和客户仅适用于公文箱账本客户。 对于书籍保存在 Xero 或 QuickBooks 中的客户端,这些工具将返回 UNSUPPORTED_CAPABILITY;请改用账本自己的报表。
  • 助手对连接时选择的客户端具有登录用户的权限。 不允许用户使用返回 FORBIDDEN的工具。 工作区管理员可以关闭 AI 助手,或仅允许读取。
  • 发布、存档或还原的工具采用:modepreview显示效果而不更改任何内容,并execute做出更改并需要一个idempotency_key,因此重试的调用不会重复它。
  • 没有工具移动资金或支付账单。
  • 拒绝读取响应超过 80,000 个字符,并请求缩小其范围(搜索词、日期范围或较小的页面大小)。
  • 每个连接限制为每分钟 120 个请求。
  • 访问令牌持续一小时并自动刷新。 未使用 30 天的连接必须重新登录。 在公文包(设置 > AI 助手)中断开连接会立即撤销它。
  • 成功读取不会记录在公文包的活动日志中;写入和拒绝的请求是。

支持

操作

公文包

询问您的书籍内容:交易、增值税、帐单、索赔和报告。

公文包

询问您的书籍内容:交易、增值税、帐单、索赔和报告。