摘要
Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、信用票据、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。
引导式设置
2 分钟将 Siigo 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Siigo,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Siigo 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
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 分钟。
- 以管理员身份登录 Siigo Nube,打开左侧菜单中的 Alianzas,然后选择 Mi Credencial API。
- 生成凭据并将 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" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
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。
下一步
这份指南对你有帮助吗?