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

Siigo 与 Cursor MCP 连接:发票和税项

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

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

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

Siigo

Siigo

Siigo API for Siigo Nube, the Colombian accounting and electronic invoicing software: customers and suppliers, products, sales invoices with their DIAN status, quotations, credit notes, cash and payment receipts, journal vouchers, catalogs (document types, taxes, payment methods, cost centers, users, warehouses), trial balance and accounts payable. Username and access key.

个工具

31

区域

INTL

类别

会计

身份验证

Sign-in token

所需环境变量

SIIGO_USERNAMESIIGO_ACCESS_KEY
在 Cloud 上一键安装

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

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

摘要

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

引导式设置

2 分钟将 Siigo 连接到 Cursor

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

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

试试这样问

Siigo 的示例提示

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

Siigo · 通过 MCP 实时
分享
Opus 4.7

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

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

Siigo + Cursor

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

前提条件

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

SIIGO_USERNAME, SIIGO_ACCESS_KEY

第一步 — 获取凭据

设置大约需要 3 分钟。

  1. 以管理员身份登录 Siigo Nube,打开左侧菜单中的 Alianzas,然后选择 Mi Credencial API。
  2. 生成凭据并将 username 复制到 SIIGO_USERNAME,将 access key 复制到 SIIGO_ACCESS_KEY。

连接器在 POST /auth 时使用这两个值进行登录,接收一个有效期为 24 小时的令牌,并自动续期。每次调用都携带头部 Partner-Id: AnythingMCP,这是 Siigo 用于识别集成应用程序所需的。

从哪里开始:siigo_list_document_types(公司的发票类型)、siigo_list_users(销售人员)、siigo_list_payment_types 和 siigo_list_taxes:它们的 ID 是创建文档所需的。siigo_list_invoices 结合客户或日期范围可以回答大多数销售问题。

目录:siigo_list_document_types、siigo_list_taxes、siigo_list_payment_types、siigo_list_cost_centers、siigo_list_users、siigo_list_warehouses、siigo_list_account_groups。它们很少更改:每次对话中读取一次即可。

第三方和产品:siigo_list_customers(按 identification 过滤)、siigo_get_customer、siigo_create_customer;siigo_list_products(按 code 过滤)、siigo_get_product、siigo_create_product。

销售发票:siigo_list_invoices、siigo_get_invoice、siigo_create_invoice、siigo_get_invoice_stamp_errors、siigo_send_invoice_email。siigo_create_invoice 保存发票但不发送给 DIAN,除非 send_to_dian 为 true;DIAN 接受的发票有 cufe,不能被作废或删除,只能通过信用票据进行更正。siigo_annul_invoice 和 siigo_delete_invoice 默认关闭。发票的 public_url 是可共享的可打印视图;连接器不返回 PDF 文件。

其他文档(只读):siigo_list_quotations、siigo_get_quotation、siigo_list_credit_notes、siigo_get_credit_note、siigo_list_vouchers 和 siigo_get_voucher(现金收据:收到的钱)、siigo_list_payment_receipts(支付给供应商的钱)、siigo_list_journals。连接器不创建收据、信用票据或日记凭证,也不转移资金。

报告:siigo_generate_trial_balance 和 siigo_generate_trial_balance_by_third_party 返回一个 Excel 文件的链接,而不是数字。siigo_list_accounts_payable 返回以 JSON 格式表示的未付款项。

分页:列表返回 results、pagination(page、page_size、total_results)和 _links。在行数仍然存在时请求下一 page;page_size 最大为 100。

格式:日期格式为 yyyy-MM-dd;创建和更新过滤器也接受 UTC 日期时间。文档 ID 为 GUID,目录 ID 为数字。客户在文档中通过 identification 和 branch_office 进行识别,产品通过 code 进行识别。金额为本地货币(COP)的数字,除非文档具有 currency。

错误为 Status 和 Errors,包含 Code、Message 和 Params:parameter_required 和 invalid_reference 指明不存在的字段或 ID,invalid_total_payments 意味着付款总额与总额不符,already_exists 表示重复的代码或识别,unauthorized 表示凭据错误或被阻止。

限制:每家公司每分钟最多 100 次调用(requests_limit)。Siigo 会阻止在 7 天内调用错误超过 80% 的 API 用户,因此不要猜测 ID 或代码:首先从目录中读取它们。

第二步 — 安装适配器

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

第三步 — 在 Cursor 中添加连接器

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

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 Cursor。
  3. 打开 Cursor → Settings → MCP,确认 anythingmcp 已列出并处于已连接状态。
  4. 开始对话 — 智能体现在可以调用 Siigo 的工具。

可用工具

工具功能
siigo_list_document_types列出 Siigo 中为一种文档配置的文档类型(comprobantes):id、code、name、description、是否为电子文档…
siigo_list_taxes列出 Siigo 中配置的税收:id、name、type(IVA、Retefuente、ReteIVA、ReteICA、Impoconsumo、AdValorem、Autorretencion)、百分比…
siigo_list_payment_types列出可用于一种文档的付款方式(formas de pago):id、name、type(Cartera、Proveedor、CarteraProveedor)、active 和…
siigo_list_cost_centers列出成本中心(centros de costo):id、code、name 和 active。某些文档类型在每张发票上都需要一个。只读
siigo_list_users列出公司的 Siigo 用户:id、username、first_name、last_name、email、identification 和 active。用户的 id 是…
siigo_list_warehouses列出用于库存的仓库(bodegas):id、name、active 和 has_movements。只读
siigo_list_account_groups列出库存分类(grupos de inventario):id、name 和 active。新产品需要一个作为 account_group 的 ID。…
siigo_list_customers列出客户和其他第三方(clientes、proveedores、terceros):id、type、person_type、id_type、identification、check_digit…
siigo_get_customer完整读取一个第三方:identification 和 type、名称、增值税责任和税务责任、地址(包括国家、州…
siigo_create_customer在 Siigo 中创建一个第三方(客户、供应商或其他)并返回其 ID。首先通过 siigo_list_customers 查找…
siigo_list_products列出产品和服务,最新的在前:id、code、name、account_group、type(Product、Service、ConsumerGood)、stock_control、active…
siigo_get_product完整读取一个产品或服务:code、name、classification、type、taxes、prices、unit、description、附加字段(条形码、品牌…
siigo_create_product在 Siigo 中创建一个产品或服务并返回其 ID。代码必须是唯一的;account_group 是库存的 ID…
siigo_list_invoices列出销售发票(facturas de venta):id、document type、number、name(例如 FV-2-22)、date、customer、cost_center、total、balance…
siigo_get_invoice完整读取一张销售发票:number 和 name、date、customer、seller、cost center、currency、每个项目的数量、价格、折扣…
siigo_create_invoice为现有客户在 Siigo 中创建一张销售发票并返回其 ID、number、total 和 public_url。默认情况下,发票…
siigo_get_invoice_stamp_errors读取 DIAN 拒绝电子发票的原因:errors 包含每个拒绝的消息。当发票的印章状态…
siigo_send_invoice_email将现有销售发票发送到最多 5 个地址。当 Siigo 接受请求时返回 status 发送。通过… 确认收件人。
siigo_annul_invoice作废(anular)一张销售发票。Siigo 拒绝已发送给 DIAN 或被 DIAN 接受的发票(带有 CUFE)和与之相关的发票…
siigo_delete_invoice永久删除一张销售发票。Siigo 拒绝已发送给 DIAN 或被 DIAN 接受的发票和与之相关的文档。这不能…
siigo_list_quotations列出报价(cotizaciones):id、number、name(例如 C-1-22)、date、customer、total、seller、items 和 public_url。按名称过滤…
siigo_get_quotation完整读取一份报价:number、name、date、customer、seller、items 及其数量、价格和税收、total 和 public_url。只读
siigo_list_credit_notes列出信用票据(notas credito):id、document type、number、name、date、每张更正的发票、customer、total、DIAN 印章、items…
siigo_get_credit_note完整读取一张信用票据:number、date、其更正的发票、customer、reason、items、payments、total 和 DIAN 印章。只读
siigo_list_vouchers列出现金收据(recibos de caja),记录从客户收到的钱:id、document type、number、name、date、type、customer…
siigo_get_voucher完整读取一张现金收据(recibo de caja):number、date、customer、它支付的到期发票及其金额、付款方式、cost…
siigo_list_payment_receipts列出付款收据(recibos de pago 或 egreso),记录支付给供应商的钱:id、document type、number、name、date、supplier…
siigo_list_journals列出日记凭证(comprobantes contables):id、document type、number、name、date 以及借方和贷方项目的账户、第三方…
siigo_generate_trial_balance生成一年的总试算表(balance de prueba),针对一系列月份和账户。Siigo 构建一个 Excel 文件并返回…
siigo_generate_trial_balance_by_third_party生成按第三方的试算表(balance de prueba por tercero),针对一系列月份和账户,针对所有第三方或一个…
siigo_list_accounts_payable列出应付账款(cuentas por pagar):每个未付款项一行,包含 due(前缀、连续、报价、日期、本地余额…

示例提示

  • "列出客户 NIT 900123456 从十月的销售发票及其 DIAN 状态。"
  • "为什么发票 FV-1-2045 被 DIAN 拒绝?"
  • "为 Comercial Andina 创建一张发票草稿:3 个产品 CAF-500,按列表价格。"
  • "目前哪些供应商的应付款项是开放的?"
  • "生成九月份的试算表。"

常见问题

凭据来自哪里? 以管理员身份登录 Siigo Nube,打开左侧菜单中的 Alianzas,然后选择 Mi Credencial API,生成凭据:用户名放入 SIIGO_USERNAME,访问密钥放入 SIIGO_ACCESS_KEY。连接器使用这两个凭据登录并自动续期其 24 小时令牌。

它涵盖了什么? 客户和供应商、产品、带有 DIAN 状态和印章错误的销售发票、通过电子邮件发送发票、报价、信用票据、现金和付款收据、日记凭证、文档所需的目录、试算表(作为 Excel 文件的链接)和应付账款。信用票据、收据和日记凭证为只读,且没有工具转移资金。

哪些工具默认关闭? siigo_annul_invoice 和 siigo_delete_invoice。仅在 AI 应该使用它们时,在连接器页面上打开它们。发票仅在 send_to_dian 为 true 时发送给 DIAN;一旦被接受,只能通过信用票据进行更正。

Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

这份指南对你有帮助吗?

2 分钟将 Siigo 连接到 Cursor

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

相关指南

连接器

Siigo 与 ChatGPT MCP 连接:销售发票

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

连接器

Siigo 与 Claude MCP 连接:发票和 DIAN

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

连接器

Siigo 与 Microsoft Copilot MCP 连接

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

连接器

Siigo 与 Gemini CLI MCP 连接:发票

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

连接器

Siigo 与 Meta Muse MCP 连接:销售发票

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。

连接器

Siigo MCP 服务器:发票、客户与产品

Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、贷项通知单、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。