摘要
SmartBill 云 API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预付款),从估算中创建发票,检查支付状态,下载 PDF,将文档通过电子邮件发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和支付登记功能已关闭。电子邮件和 API 令牌。
引导式设置
2 分钟将 SmartBill 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 SmartBill,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
SmartBill 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → SmartBill,粘贴你的凭证,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
SmartBill
SmartBill 云 API 用于罗马尼亚开票:以草稿或最终文档的形式开具发票和估算(预付款),从估算中创建发票,检查支付状态,下载 PDF,将文档通过电子邮件发送给客户,并按仓库读取文档系列、增值税率和库存。撤销、取消、删除和支付登记功能已关闭。电子邮件和 API 令牌。
设置
设置大约需要 2 分钟。
- 登录 SmartBill 云并打开 Contul meu, Integrari,部分 API (https://cloud.smartbill.ro/core/integrari/)。
- 将 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 转换为发票并通过电子邮件发送给客户。"
- "今天中央仓库的库存是多少?"
下一步
这份指南对你有帮助吗?