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

Siigo 与 Microsoft Copilot MCP 连接

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

HC作者:HelpCode 团队更新于 5 分钟阅读 在 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 连接到 Microsoft Copilot

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

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

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

第三步 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Siigo 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

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

可用工具

工具功能
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;一旦被接受,只能通过信用票据进行更正。

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

2 分钟将 Siigo 连接到 Microsoft Copilot

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

相关指南

连接器

Siigo 与 ChatGPT MCP 连接:销售发票

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

连接器

Siigo 与 Claude MCP 连接:发票和 DIAN

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

连接器

Siigo 与 Cursor 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 状态的销售发票、报价、贷项通知单、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。