摘要
SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。
引导式设置
2 分钟将 SmartBill 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 SmartBill,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
SmartBill 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → SmartBill,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
SmartBill + ChatGPT
SmartBill Cloud API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预开票),从估算创建发票,检查付款状态,下载 PDF,将文档发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和付款登记功能已关闭。电子邮件和 API 令牌。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
第 1 步 — 获取凭据
设置大约需要 2 分钟。
- 登录 SmartBill Cloud,打开 Contul meu, Integrari,部分 API (https://cloud.smartbill.ro/core/integrari/)。
- 将 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 步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
SmartBill。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
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 应该使用它们时,才在连接器页面上启用它们。没有工具会收费或转移资金。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?