公事包(預覽)

問你的帳簿任何問題:交易、增值稅、帳單、理賠和報告。

此連接器適用於以下產品和區域:

Service Class Regions
Copilot Studio 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Logic Apps 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人
Name 公事包
URL https://briefcase.so
Email support@briefcase.so
連接器中繼資料
Publisher 公事包
Website https://briefcase.so
隱私權原則 https://briefcase.so/privacy-policy
Categories 人工智慧;資料

公事包

Briefcase 是為英國企業及其會計師設計的會計軟體。 它會讀取收據、發票和銀行帳戶,並依照說明進行編碼,並以 Briefcase Ledger、Xero 或 QuickBooks 保持帳目最新。

此 MCP 伺服器讓 Microsoft 365 Copilot 與 Copilot Studio 客服人員以登入使用者身份使用 Briefcase:回答客戶帳務問題、上傳文件、審查與發布交易、準備費用理賠、管理財務結算,並對 Briefcase Ledger 客戶執行報告、手動掛帳及開立銷售發票。

Publisher

公事包科技有限公司(https://briefcase.so)

Prerequisites

  • 一個公事包帳戶(https://app.briefcase.so),至少能接觸到一位客戶。
  • 公事包工作區允許 AI 助理。 Workspace 管理員在設定 > AI 助理中控制這些功能。

支援的作業

52 種工具,依區域分組。 每個工具都會在連接時選擇的用戶端上扮演登入使用者的角色。

帳戶與客戶

  • briefcase_get_connection (取得連線):識別已登入的公事包使用者、工作區及此助理授權。
  • briefcase_list_clients (列出客戶端):列出此使用者可依授權存取的客戶端,並包含等待審查、處理、失敗及已發佈的計數。
  • briefcase_get_client (取得客戶端:一個客戶:姓名、分類帳類型(Xero、QuickBooks 或 Briefcase Ledger)、文件轉寄電子郵件、Autopilot 是否開啟,以及 Briefcase Ledger 客戶的總帳鎖定日期。
  • briefcase_list_users (清單使用者):列出允許的工作空間或用戶端使用者,並擁有角色、有效權限及可見的用戶端指派。 適用現有的使用者目錄限制。
  • briefcase_list_contacts (列出聯絡人):搜尋供應商、客戶及索賠人以尋找客戶。
  • briefcase_get_contact (取得聯絡人):客戶身份證的聯絡方式。
  • briefcase_get_reference_data (取得參考資料):查詢帳戶、稅率、追蹤類別、貨幣、企業、財產、申請人或銷售項目(公事包帳本;briefcase_raise_sales_invoice 使用)。 最多可歸還150件物品並全數回放;狹窄帳戶account_class或search_term。
  • briefcase_list_ai_memories (列出 AI 記憶):客戶的主動 AI 記憶:處理規則 Briefcase 適用於其文件,例如如何編碼供應商或使用哪個截止日期慣例。

文件與交易

  • briefcase_create_document_upload (建立文件上傳):開始上傳:回傳一個短暫的上傳網址、一個 Briefcase 瀏覽器上傳連結及客戶端轉寄電子郵件。 當檔案被提供後,Briefcase 會自行下載該檔案,並準備上傳。 note 包含使用者在應用程式中輸入的處理指示,Briefcase 套用這些指示:帳戶或編碼目的、追蹤類別、專案或地點(Xero 和 QuickBooks)、百分比分割、保持行列分開或合併,以及將收據作為員工的費用申報(加到他們的月申報中)。
  • briefcase_submit_document (提交文件):提交透過 briefcase_create_document_upload 上傳的檔案以供處理,與在 Briefcase 應用程式上傳完全相同。 隨後briefcase_get_operation回來執行手術;未產生交易的文件會被報告為失敗。
  • briefcase_get_operation (取得操作):寫入或拒絕寫入的持久狀態。 成功的讀取不會被儲存。
  • briefcase_get_attachment_download (取得附件下載):客戶綁定附件的短暫下載網址,包含一份briefcase_get_sales_invoice pdf.attachment_id的銷售發票 PDF。 簽名連結在expires_at停止使用。
  • briefcase_list_transactions (列出交易):搜尋並篩選待審、處理、已發表或已存檔的交易。
  • briefcase_get_transaction (取得交易):客戶可見的交易細節、行項目、附件、自動駕駛說明及發佈阻擋器。
  • briefcase_update_transaction (更新交易):儲存交易編輯後,但不發佈。 最後寫入獲勝。 只有所提供的欄位會被更改。 當line_items被提供時,則是要保留完整組:遺漏的現有行項目會被移除;省略line_items保持不變。
  • briefcase_publish_transaction (發布交易):將審查過的交易發布到帳本。 預覽回傳阻擋器與帳本動作;執行郵件至公事包帳本或建立 Xero/QuickBooks 文件。
  • briefcase_archive_transaction (歸檔交易):歸檔交易,並在適用時反轉其帳本過載。 預覽顯示帳本動作及排程影響。 唯一支持刪除的原因。
  • briefcase_list_archived_documents (存檔文件):存檔交易、候選人、銀行對帳單、供應商對帳單及銷售發票。
  • briefcase_get_archived_document (取得存檔文件):依歸檔編號標示一個已存檔項目。
  • 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 (列出銀行交易):Briefcase 銀行帳戶的帳本銀行資料,最新者排第一。 running_balance 是每行調和後的餘額,如 Briefcase 中;未調和的線則沒有。 連結客戶,回UNSUPPORTED_CAPABILITY。

財務結束

  • briefcase_list_close_items (列出結尾項目):列出預付款、遞延收入、固定資產或應計項目。 排程表帶有period_summary,而非週期;買一台有briefcase_get_close_item月經的。 累積項目包括類型化的父參考與調整參考;存檔的累積計算讀取回傳歸檔調整,而非歸檔的父。
  • 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 (建立手動日記帳):在 Briefcase Ledger 客戶端發布手動日記帳。 行數為主要單位的總金額,各為借記或貸記;tax_rate_id會將增值稅分成增值稅帳戶。 收入、費用及固定資產條目需tax_rate_id(若無增值稅則不適用);每隔一行必須省略。 預覽區塊會封鎖鎖定期間、不平衡的線條、缺失或錯置的稅率、保留或刪除的帳戶,以及跨越企業或物業的線路。 反轉僅限網路版。 連結客戶,回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類商品)開立並貼銷銷售發票。 銀行資料預設為企業的入帳帳戶。 預覽顯示額度和總額,並區塊鎖定期間及缺少發卡機構或客戶資料。 從不寄電子郵件給客戶;反轉僅限網頁版。 連結客戶,回UNSUPPORTED_CAPABILITY。
  • briefcase_create_customer (建立客戶):將客戶加入公事包帳本客戶。 預覽會列出名稱相似或電子郵件相同的現有聯絡人;除非confirm_new_despite_candidates為真,否則執行 拒絕 只要存在。 完全相同名稱的聯絡人是重複使用,而非重複。 連結客戶,回UNSUPPORTED_CAPABILITY。

Help

  • briefcase_search_help (搜尋說明):搜尋已發表的幫助文章。
  • briefcase_get_help_article (取得說明文章):已發表的說明文章或產品更新主體。

取得認證

Briefcase 使用 OAuth 2.0 格式,使用者需登入 Briefcase 登入。 連線建立後,Briefcase 會要求使用者登入,選擇助理可使用的客戶端,並進行核准。 在公事包裡不需要事先設定。

開始使用

  1. 把 Briefcase 加入你的經紀人,建立連結。
  2. 登入公事包,選擇你的客戶並核准。
  3. 例如,可以問:
    • 誰欠我們錢?
    • 哪些法案正在等待審查?
    • 我們今年在軟體上花了多少錢?
    • 把這張收據上傳到 Dunder Mifflin。

已知問題和限制

  • 報告(損益表、資產負債表、試算表、老期債務人與債權人、工作文件)、日記帳、手動日記帳、銀行支線、銷售發票及客戶,僅適用於公事包帳本的客戶。 對於帳簿存放在 Xero 或 QuickBooks 的客戶,這些工具會回傳 UNSUPPORTED_CAPABILITY;改用帳本本身的報告。
  • 助理擁有登入使用者在連線時選擇的客戶端權限。 使用者不被允許使用的工具會返回 FORBIDDEN。 工作區管理員可以關閉 AI 助理,或只允許閱讀。
  • 發佈、歸檔或還原的工具會先用 mode: preview 顯示效果,且不改變任何東西,並 execute 進行變更,需要 idempotency_key,這樣重試呼叫時不會重複。
  • 沒有工具能移動金錢或支付帳單。
  • 超過80,000字元的已讀回應會被拒絕,並要求縮小範圍(例如搜尋詞、日期範圍或更小的頁面大小)。
  • 每次連線每分鐘限制 120 次請求。
  • 存取權杖持續一小時,且會自動刷新。 連線若30天內未使用,則必須重新登入。 在公事包中斷線(設定 > AI 助理)會立即撤銷。
  • 成功的讀取不會記錄在公事包的活動日誌中;寫入和拒絕請求則是。

支援

動作

公事包

問你的帳簿任何問題:交易、增值稅、帳單、理賠和報告。

公事包

問你的帳簿任何問題:交易、增值稅、帳單、理賠和報告。