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

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

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

引导式设置

2 分钟将 SmartBill 连接到 Claude、ChatGPT 或 Copilot

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

无需信用卡 · 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

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

设置

设置大约需要 2 分钟。

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

调用使用 HTTP 基本身份验证,电子邮件作为用户名,令牌作为密码。连接器将公司的 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 必须是第 1 区到第 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)需要收银机,并且在此处不予开具。

先决条件:SMARTBILL_EMAIL,SMARTBILL_API_TOKEN,SMARTBILL_CIF

本地安装连接器

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

打开 http://localhost:3000/connectors/store,选择 SmartBill 并粘贴在先决条件下列出的环境变量。

可用工具

工具功能
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删除记录的付款,该付款不是收据(卡、支付命令、CEC 等)。通过其结算的发票识别(invoice_series…

示例提示

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

下一步

这份指南对你有帮助吗?

2 分钟将 SmartBill 连接到 Claude、ChatGPT 或 Copilot

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

相关指南

连接器

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连接Meta Muse:发票与库存

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