连接器指南阅读约 3 分钟22 个 MCP 工具7 种语言

SmartBill MCP连接Meta Muse:发票与库存

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

SmartBill

SmartBill

SmartBill Cloud API for Romanian invoicing: issue invoices and estimates (proforme) as drafts or final documents, create an invoice from an estimate, check payment status, download PDFs, email documents to clients, and read document series, VAT rates and stock by warehouse. Reversal, cancel, delete and payment registration are switched off. Email and API token.

个工具

22

区域

RO

类别

会计

身份验证

Basic Auth

所需环境变量

SMARTBILL_EMAILSMARTBILL_API_TOKENSMARTBILL_CIF
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

引导式设置

2 分钟将 SmartBill 连接到 Meta Muse

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 SmartBill,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

SmartBill 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

SmartBill · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → SmartBill,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

SmartBill + Meta Muse

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF

第 1 步 — 获取凭据

设置大约需要 2 分钟。

  1. 登录 SmartBill Cloud,打开 Contul meu, Integrari,部分 API (https://cloud.smartbill.ro/core/integrari/)。
  2. 将 Email 复制到 SMARTBILL_EMAIL,将 Token 复制到 SMARTBILL_API_TOKEN,将公司的 CIF 复制到 SMARTBILL_CIF。

调用使用 HTTP Basic 认证,电子邮件作为用户名,令牌作为密码。连接器将公司 CIF 添加到每个调用中,因此一个连接器只能用于一个公司;对于第二个公司,请再次安装。

从哪里开始:smartbill_list_series(每个文档所需的系列名称)和 smartbill_list_taxes(增值税率名称)。然后是 smartbill_create_invoice 或 smartbill_create_estimate。

API 无法做什么:V1 没有发票、客户或产品的列表或搜索,也没有文档的 JSON 视图。文档通过其系列和编号进行寻址,用户提供这些信息或创建调用返回这些信息。请保留你创建的 series、number 和 documentViewUrl。

发票:smartbill_create_invoice 保存为草稿,除非 is_draft 为 false。最终发票将获得系列的下一个编号,并且是财政文件:SmartBill 根据账户设置将其发送到 ANAF e-Factura,而此 API 不控制该设置。smartbill_create_invoice_from_estimate 将预开票转换为发票。smartbill_get_invoice_payment_status 告诉哪些已付款,哪些到期,smartbill_get_invoice_pdf 下载文件,smartbill_send_document_email 将发票或估算通过电子邮件发送给客户。smartbill_reverse_invoice(撤销)、smartbill_cancel_invoice、smartbill_restore_invoice 和 smartbill_delete_invoice 默认关闭。

估算(预开票):smartbill_create_estimate、smartbill_get_estimate_invoices(是否已开票)、smartbill_get_estimate_pdf;smartbill_cancel_estimate、smartbill_restore_estimate 和 smartbill_delete_estimate 默认关闭。

付款:smartbill_get_fiscal_receipt_text 读取财政收据。smartbill_register_payment(记录收款或开具收据)、smartbill_delete_receipt 和 smartbill_delete_payment 默认关闭。这里没有任何操作会收费或转移资金:付款仅为记账记录。

库存:smartbill_list_stocks 返回某日期每个仓库的数量(gestiune);仓库名称区分大小写。

编写文档:seriesName、taxName 和 measuringUnitName 必须与账户完全匹配;绝不要自行创建。价格不含增值税,除非 isTaxIncluded 为 true。每行都需要 taxPercentage(自 2025 年 8 月起标准税率为 21)。如果账户使用产品代码,每行需要 code。折扣行需要 numberOfItems 和负的 discountValue,否则将被静默忽略或添加。对于位于布加勒斯特的客户,city 必须为 Sector 1 至 Sector 6,否则 e-Factura 将拒绝发票。每个文档,包括草稿,都计入 SmartBill 计划的文档中。

错误:响应的 errorText 是原因,使用罗马尼亚语(例如 Seria nu a fost gasita! 表示未知系列);它可以包含 HTML,因此只引用其第一句话。请求中包含未知字段或错误类型时,返回 400,errors[].message 和 errors[].param 指明字段。401 表示电子邮件或令牌错误,403 表示用户对公司或系列没有权限。

限制:每个令牌每 10 秒最多 30 次调用;超出限制会阻止该令牌 10 分钟。头部 X-RateLimit-Remaining 和 X-RateLimit-Reset 显示剩余次数。

未涵盖:更新的 API V3(客户、产品、仓库、供应商和货物收据单列表)使用单独的 Bearer 令牌,并不属于此连接器。财政收据(bon fiscal)需要收银机,此处不发放。

第 2 步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

第 3 步 — 在 Muse 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。

  1. 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
  2. 粘贴 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
  3. Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
  4. 在聊天中,向 Muse 提出需要用到 SmartBill 的工具的请求。

你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。

可用工具

工具功能
smartbill_list_series列出在 SmartBill 中配置的文档系列:list 包含每个系列的 name、其 nextNumber 和 type(发票为 f,估算为 p 等)
smartbill_list_taxes列出在 SmartBill 中配置的增值税率:taxes 包含每个税率的 name(例如 Normala)和 percentage。将名称用作 taxName 和…
smartbill_list_stocks读取某日期的库存水平:list 每个仓库有一个条目(warehouseName、warehouseType 为 en gros 或 en detail)及其 products…
smartbill_create_invoice在 SmartBill 中创建发票。默认情况下,它保存为草稿(没有编号),用户在 SmartBill 中检查并最终确定;使用…
smartbill_create_invoice_from_estimate从现有估算(预开票)创建发票:客户和行从估算中复制。默认情况下,发票保存为草稿…
smartbill_get_invoice_payment_status检查发票是否已付款:invoiceTotalAmount(含增值税的总额)、paidAmount、unpaidAmount 和 paid(完全付款时为 true)。…
smartbill_get_invoice_pdf下载已开具的发票作为 PDF 文件。响应即为文件本身,作为附件交付;API 没有文档的 JSON 视图。…
smartbill_send_document_email通过电子邮件将已开具的发票或估算作为附件发送给客户,邮件主题和文本由…
smartbill_reverse_invoice为现有发票开具撤销(storno)发票:在同一系列上生成一个负金额的新财政文件。计入…
smartbill_cancel_invoice取消(anulare)已开具的发票。发票保持其编号并标记为已取消;可以通过…
smartbill_restore_invoice恢复已取消的发票,使其再次有效。默认关闭;在调用之前请确认用户
smartbill_delete_invoice永久删除发票。只能删除系列中的最后一张发票,且此操作无法撤销。默认关闭;请确认…
smartbill_create_estimate在 SmartBill 中创建估算(预开票)。默认情况下,它保存为草稿(没有编号);如果 is_draft 为 false,则立即开具…
smartbill_get_estimate_invoices检查估算(预开票)是否已开票:areInvoicesCreated 和 invoices 包含每张发票的 series 和 number…
smartbill_get_estimate_pdf下载估算(预开票)作为 PDF 文件。响应即为文件本身,作为附件交付。错误的系列或编号将…
smartbill_cancel_estimate取消估算(预开票)。它保持其编号,可以通过 smartbill_restore_estimate 恢复。默认关闭;请确认…
smartbill_restore_estimate恢复已取消的估算(预开票)。默认关闭;在调用之前请确认用户
smartbill_delete_estimate永久删除估算(预开票)。此操作无法撤销。默认关闭;在调用之前请确认用户
smartbill_register_payment在 SmartBill 中记录从客户收到的付款,可选地针对发票。类型决定创建的内容:Chitanta 开具…
smartbill_get_fiscal_receipt_text通过其 ID 读取财政收据(bon fiscal)的内容:message 包含财政打印机的收据文本,Base64 编码,…
smartbill_delete_receipt永久删除收据(chitanta)。只能删除系列中的最后一张收据。默认关闭;请确认用户…
smartbill_delete_payment删除记录的付款,该付款不是收据(卡、付款单、支票等)。通过其结算的发票识别(invoice_series…

示例提示

  • "在 SmartBill 中设置了哪些文档系列和增值税率?"
  • "在系列 FCT 中创建一张草稿发票,内容为 SC Exemplu SRL:10 小时咨询费用 200 莱伊加增值税。"
  • "发票 FCT 0142 是否已付款,还有多少未付款?"
  • "将预开票 PRF 0031 转换为发票并通过电子邮件发送给客户。"
  • "今天仓库 Depozit Central 的库存是多少?"

常见问题

凭据来自哪里? SmartBill Cloud,Contul meu,Integrari,API 部分:复制电子邮件、令牌和公司的 CIF。一个连接器只能用于一个公司;对于第二个公司,请再次安装。这是 V1 令牌,而不是 API V3 的 Bearer 令牌。

它涵盖了什么? 发票和估算(预开票)作为草稿或最终文档,从估算开具发票,付款状态,PDF,向客户发送文档,财政收据文本,文档系列,增值税率和每个仓库的库存。API V1 没有发票、客户或产品的列表或搜索:文档通过其系列和编号进行寻址。最终发票是财政文件,SmartBill 根据账户设置将其发送到 ANAF e-Factura。

哪些工具默认关闭? smartbill_reverse_invoice、smartbill_cancel_invoice、smartbill_restore_invoice、smartbill_delete_invoice、smartbill_cancel_estimate、smartbill_restore_estimate、smartbill_delete_estimate、smartbill_register_payment、smartbill_delete_receipt 和 smartbill_delete_payment。仅在 AI 应该使用它们时,才在连接器页面上启用它们。没有工具会收费或转移资金。

Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。

Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。

下一步

这份指南对你有帮助吗?

2 分钟将 SmartBill 连接到 Meta Muse

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 SmartBill,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。

相关指南

连接器

SmartBill MCP连接ChatGPT:发票与增值税

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

连接器

SmartBill MCP连接Claude:发票与库存

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

连接器

SmartBill MCP连接Microsoft Copilot

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

连接器

SmartBill MCP连接Cursor:发票与库存

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

连接器

SmartBill MCP连接Gemini CLI:预估单

SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。

连接器

SmartBill MCP 服务器:发票、估算与库存

SmartBill 云 API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预付款),从估算中创建发票,检查支付状态,下载 PDF,将文档通过电子邮件发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和支付登记功能已关闭。电子邮件和 API 令牌。