摘要
Siigo Nube 的 Siigo API,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、贷项通知单、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。
引导式设置
2 分钟将 Siigo 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Siigo,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Siigo 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Siigo,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Siigo
Siigo API 为 Siigo Nube,哥伦比亚的会计和电子发票软件:客户和供应商、产品、带有 DIAN 状态的销售发票、报价、贷项通知单、现金和付款收据、日记凭证、目录(文档类型、税收、付款方式、成本中心、用户、仓库)、试算表和应付账款。用户名和访问密钥。
设置
设置大约需要 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 或代码:先从目录中读取它们。
先决条件:SIIGO_USERNAME、SIIGO_ACCESS_KEY
本地安装连接器
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,选择 Siigo 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
siigo_list_document_types | 列出 Siigo 中为一种文档配置的文档类型(comprobantes):ID、代码、名称、描述、是否为电子文档… |
siigo_list_taxes | 列出 Siigo 中配置的税收:ID、名称、类型(IVA、Retefuente、ReteIVA、ReteICA、Impoconsumo、AdValorem、Autorretencion)、百分比… |
siigo_list_payment_types | 列出可用于一种文档的付款方式(formas de pago):ID、名称、类型(Cartera、Proveedor、CarteraProveedor)、是否激活… |
siigo_list_cost_centers | 列出成本中心(centros de costo):ID、代码、名称和是否激活。一些文档类型在每张发票上都需要一个。只读 |
siigo_list_users | 列出公司的 Siigo 用户:ID、用户名、名、姓、电子邮件、识别和是否激活。用户的 id 是… |
siigo_list_warehouses | 列出用于库存的仓库(bodegas):ID、名称、是否激活和是否有移动。只读 |
siigo_list_account_groups | 列出库存分类(grupos de inventario):ID、名称和是否激活。新产品需要一个作为 account_group 的 ID。… |
siigo_list_customers | 列出客户和其他第三方(clientes、proveedores、terceros):ID、类型、个人类型、ID 类型、识别、校验位… |
siigo_get_customer | 完整读取一个第三方:识别和类型、名称、增值税责任和财政责任、地址及国家、州… |
siigo_create_customer | 在 Siigo 中创建一个第三方(客户、供应商或其他),并返回其 ID。首先通过 siigo_list_customers 查找… |
siigo_list_products | 列出产品和服务,最新的在前:ID、代码、名称、account_group、类型(Product、Service、ConsumerGood)、库存控制、是否激活… |
siigo_get_product | 完整读取一个产品或服务:代码、名称、分类、类型、税收、价格、单位、描述、附加字段(条形码、品牌… |
siigo_create_product | 在 Siigo 中创建一个产品或服务,并返回其 ID。代码必须唯一;account_group 是库存的 ID… |
siigo_list_invoices | 列出销售发票(facturas de venta):ID、文档类型、编号、名称(如 FV-2-22)、日期、客户、成本中心、总额、余额… |
siigo_get_invoice | 完整读取一张销售发票:编号和名称、日期、客户、销售人员、成本中心、货币、每个项目的数量、价格、折扣… |
siigo_create_invoice | 为现有客户在 Siigo 中创建一张销售发票,并返回其 ID、编号、总额和 public_url。默认情况下,发票是… |
siigo_get_invoice_stamp_errors | 读取 DIAN 拒绝电子发票的原因:errors 包含每个拒绝的消息。当发票的印章状态… |
siigo_send_invoice_email | 将现有销售发票发送到最多 5 个地址。当 Siigo 接受请求时返回 status 发送。通过… 确认收件人 |
siigo_annul_invoice | 作废(anular)一张销售发票。Siigo 拒绝已发送给或被 DIAN 接受的发票(带有 CUFE)和与之相关的发票… |
siigo_delete_invoice | 永久删除一张销售发票。Siigo 拒绝已发送给或被 DIAN 接受的发票和与之相关的文档。此操作无法… |
siigo_list_quotations | 列出报价(cotizaciones):ID、编号、名称(如 C-1-22)、日期、客户、总额、销售人员、项目和 public_url。按名称过滤… |
siigo_get_quotation | 完整读取一份报价:编号、名称、日期、客户、销售人员、项目及其数量、价格和税收、总额和 public_url。只读 |
siigo_list_credit_notes | 列出贷项通知单(notas credito):ID、文档类型、编号、名称、日期、每张更正的发票、客户、总额、DIAN 印章、项目… |
siigo_get_credit_note | 完整读取一张贷项通知单:编号、日期、更正的发票、客户、原因、项目、付款、总额和 DIAN 印章。只读 |
siigo_list_vouchers | 列出现金收据(recibos de caja),记录从客户那里收到的钱:ID、文档类型、编号、名称、日期、类型、客户… |
siigo_get_voucher | 完整读取一张现金收据(recibo de caja):编号、日期、客户、支付的到期发票及其金额、付款方式、成本… |
siigo_list_payment_receipts | 列出付款收据(recibos de pago 或 egreso),记录支付给供应商的钱:ID、文档类型、编号、名称、日期、供应商… |
siigo_list_journals | 列出日记凭证(comprobantes contables):ID、文档类型、编号、名称、日期,以及借方和贷方项目的账户、第三方… |
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,按列表价格。"
- "当前有哪些供应商款项未支付?"
- "生成九月份的试算表。"
下一步
这份指南对你有帮助吗?