Resumen
API de Siigo para Siigo Nube, el software colombiano de contabilidad y facturación electrónica: clientes y proveedores, productos, facturas de venta con su estado DIAN, cotizaciones, notas de crédito, recibos de caja y de pago, comprobantes contables, catálogos (tipos de documentos, impuestos, métodos de pago, centros de costo, usuarios, bodegas), balance de prueba y cuentas por pagar. Nombre de usuario y clave de acceso.
Configuración guiada
Conecta Siigo a Meta Muse en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Siigo con la configuración guiada y añade tu URL MCP a Meta Muse. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Siigo
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Siigo, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Siigo + Meta Muse
API de Siigo para Siigo Nube, el software colombiano de contabilidad y facturación electrónica: clientes y proveedores, productos, facturas de venta con su estado DIAN, cotizaciones, notas de crédito, recibos de caja y de pago, comprobantes contables, catálogos (tipos de documentos, impuestos, métodos de pago, centros de costo, usuarios, bodegas), balance de prueba y cuentas por pagar. Nombre de usuario y clave de acceso.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SIIGO_USERNAME, SIIGO_ACCESS_KEY
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 3 minutos.
- Inicia sesión en Siigo Nube como administrador y abre Alianzas en el menú de la izquierda, luego Mi Credencial API.
- Genera la credencial y copia el nombre de usuario en
SIIGO_USERNAMEy la clave de acceso enSIIGO_ACCESS_KEY.
El conector inicia sesión en POST /auth con ambos valores, recibe un token que dura 24 horas y lo renueva automáticamente. Cada llamada lleva el encabezado Partner-Id: AnythingMCP, que Siigo requiere para identificar la aplicación integradora.
Por dónde empezar: siigo_list_document_types (los tipos de factura de la empresa), siigo_list_users (vendedores), siigo_list_payment_types y siigo_list_taxes: sus ids son necesarios para crear documentos. siigo_list_invoices con un cliente o un rango de fechas responde a la mayoría de las preguntas de ventas.
Catálogos: 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. Rara vez cambian: léelos una vez por conversación.
Terceros y productos: siigo_list_customers (filtra por identification), siigo_get_customer, siigo_create_customer; siigo_list_products (filtra por code), siigo_get_product, siigo_create_product.
Facturas de venta: siigo_list_invoices, siigo_get_invoice, siigo_create_invoice, siigo_get_invoice_stamp_errors, siigo_send_invoice_email. siigo_create_invoice guarda la factura sin enviarla a la DIAN a menos que send_to_dian sea verdadero; una factura que la DIAN aceptó tiene un cufe y no puede ser anulada o eliminada, solo corregida con una nota de crédito. siigo_annul_invoice y siigo_delete_invoice se instalan desactivadas. La public_url de una factura es la vista imprimible para compartir; el conector no devuelve archivos PDF.
Otros documentos (solo lectura): siigo_list_quotations, siigo_get_quotation, siigo_list_credit_notes, siigo_get_credit_note, siigo_list_vouchers y siigo_get_voucher (recibos de caja: dinero recibido), siigo_list_payment_receipts (dinero pagado a proveedores), siigo_list_journals. El conector no crea recibos, notas de crédito o comprobantes contables y no mueve dinero.
Informes: siigo_generate_trial_balance y siigo_generate_trial_balance_by_third_party devuelven un enlace a un archivo de Excel, no cifras. siigo_list_accounts_payable devuelve las deudas abiertas de proveedores como JSON.
Paginación: las listas devuelven results, pagination (page, page_size, total_results) y _links. Pide la siguiente page mientras queden filas; page_size puede llegar hasta 100.
Formatos: las fechas son yyyy-MM-dd; los filtros de creado y actualizado también aceptan fechas y horas UTC. Los ids de documentos son GUIDs, los ids de catálogos son números. Un cliente se identifica en los documentos por identification y branch_office, un producto por code. Los montos son números en la moneda local (COP) a menos que el documento tenga una currency.
Errores son Status y Errors con Code, Message y Params: parameter_required y invalid_reference nombran el campo o el id que no existe, invalid_total_payments significa que los pagos no suman el total, already_exists un código o identificación duplicados, unauthorized una credencial incorrecta o bloqueada.
Límites: 100 llamadas por minuto por empresa (requests_limit). Siigo bloquea a un usuario de API cuyas llamadas fueron más del 80 % de errores durante 7 días, así que no adivines ids o códigos: léelos de los catálogos primero.
Paso 2 — Instalar el adaptador
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
Paso 3 — Agregar el conector en Muse
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.
- En Muse, abre Settings → Connectors y elige Add custom connector.
- Pega la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
- En un chat, pídele a Muse algo que necesite las herramientas de
Siigo.
También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
siigo_list_document_types | Lista los tipos de documentos (comprobantes) configurados en Siigo para un tipo de documento: id, código, nombre, descripción, si es electrónico… |
siigo_list_taxes | Lista los impuestos configurados en Siigo: id, nombre, tipo (IVA, Retefuente, ReteIVA, ReteICA, Impoconsumo, AdValorem, Autorretencion), porcentaje… |
siigo_list_payment_types | Lista los métodos de pago (formas de pago) utilizables en un tipo de documento: id, nombre, tipo (Cartera, Proveedor, CarteraProveedor), activo y… |
siigo_list_cost_centers | Lista los centros de costo (centros de costo): id, código, nombre y activo. Algunos tipos de documentos requieren uno en cada factura. Solo lectura |
siigo_list_users | Lista los usuarios de Siigo de la empresa: id, nombre de usuario, nombre, apellido, correo electrónico, identificación y activo. El id de un usuario es el… |
siigo_list_warehouses | Lista las bodegas (bodegas) utilizadas para inventario: id, nombre, activo y has_movements. Solo lectura |
siigo_list_account_groups | Lista las clasificaciones de inventario (grupos de inventario): id, nombre y activo. Un nuevo producto necesita el id de uno como account_group.… |
siigo_list_customers | Lista clientes y otros terceros (clientes, proveedores, terceros): id, tipo, tipo_persona, tipo_id, identificación, dígito de verificación… |
siigo_get_customer | Lee un tercero en su totalidad: identificación y tipo, nombres, responsabilidad de IVA y responsabilidades fiscales, dirección con país, estado… |
siigo_create_customer | Crea un tercero (cliente, proveedor u otro) en Siigo y devuélvelo con su id. Búscalo primero con siigo_list_customers por… |
siigo_list_products | Lista productos y servicios, los más nuevos primero: id, código, nombre, account_group, tipo (Producto, Servicio, BienConsumible), control_de_stock, activo… |
siigo_get_product | Lee un producto o servicio en su totalidad: código, nombre, clasificación, tipo, impuestos, precios, unidad, descripción, campos adicionales (código de barras, marca… |
siigo_create_product | Crea un producto o servicio en Siigo y devuélvelo con su id. El código debe ser único; account_group es el id de un inventario… |
siigo_list_invoices | Lista facturas de venta (facturas de venta): id, tipo de documento, número, nombre (como FV-2-22), fecha, cliente, centro_de_costo, total, saldo… |
siigo_get_invoice | Lee una factura de venta en su totalidad: número y nombre, fecha, cliente, vendedor, centro de costo, moneda, cada artículo con cantidad, precio, descuento… |
siigo_create_invoice | Crea una factura de venta en Siigo para un cliente existente y devuélvela con su id, número, total y public_url. Por defecto, la factura se… |
siigo_get_invoice_stamp_errors | Lee por qué la DIAN rechazó una factura electrónica: errors con el mensaje de cada rechazo. Úsalo cuando el estado del sello de una factura… |
siigo_send_invoice_email | Envía una factura de venta existente a hasta 5 direcciones. Devuelve status enviado cuando Siigo aceptó la solicitud. Confirma los destinatarios con el… |
siigo_annul_invoice | Anula (anular) una factura de venta. Siigo rechaza facturas ya enviadas o aceptadas por la DIAN (con un CUFE) y facturas con documentos relacionados… |
siigo_delete_invoice | Elimina una factura de venta de forma permanente. Siigo rechaza facturas enviadas o aceptadas por la DIAN y facturas con documentos relacionados. Esto no puede… |
siigo_list_quotations | Lista cotizaciones (cotizaciones): id, número, nombre (como C-1-22), fecha, cliente, total, vendedor, artículos y public_url. Filtra por nombre… |
siigo_get_quotation | Lee una cotización en su totalidad: número, nombre, fecha, cliente, vendedor, artículos con cantidades, precios e impuestos, total y public_url. Solo lectura |
siigo_list_credit_notes | Lista notas de crédito (notas crédito): id, tipo de documento, número, nombre, fecha, la factura que cada una corrige, cliente, total, sello DIAN, artículos… |
siigo_get_credit_note | Lee una nota de crédito en su totalidad: número, fecha, la factura que corrige, cliente, razón, artículos, pagos, total y el sello DIAN. Solo lectura |
siigo_list_vouchers | Lista recibos de caja (recibos de caja), el registro de dinero recibido de clientes: id, tipo de documento, número, nombre, fecha, tipo, cliente… |
siigo_get_voucher | Lee un recibo de caja (recibo de caja) en su totalidad: número, fecha, cliente, las facturas vencidas que paga con sus valores, método de pago, costo… |
siigo_list_payment_receipts | Lista recibos de pago (recibos de pago o egreso), el registro de dinero pagado a proveedores: id, tipo de documento, número, nombre, fecha, proveedor… |
siigo_list_journals | Lista comprobantes contables (comprobantes contables): id, tipo de documento, número, nombre, fecha y los ítems de débito y crédito con cuenta, tercero… |
siigo_generate_trial_balance | Genera el balance de prueba general (balance de prueba) de un año para un rango de meses y cuentas. Siigo construye un archivo de Excel y devuelve… |
siigo_generate_trial_balance_by_third_party | Genera el balance de prueba por tercero (balance de prueba por tercero) para un rango de meses y cuentas, para todos los terceros o uno.… |
siigo_list_accounts_payable | Lista cuentas por pagar (cuentas por pagar): una fila por cada monto vencido con due (prefijo, consecutivo, cotización, fecha, saldo en local… |
Ejemplos de indicaciones
- "Lista las facturas de venta al cliente NIT 900123456 de octubre con su estado DIAN."
- "¿Por qué fue rechazada la factura FV-1-2045 por la DIAN?"
- "Crea un borrador de factura para Comercial Andina: 3 unidades del producto CAF-500 al precio de lista."
- "¿Qué deudas de proveedores están abiertas en este momento?"
- "Genera el balance de prueba para septiembre."
Preguntas frecuentes
¿De dónde provienen las credenciales? Inicia sesión en Siigo Nube como administrador, abre Alianzas en el menú de la izquierda, luego Mi Credencial API, y genera la credencial: el nombre de usuario va en SIIGO_USERNAME, la clave de acceso en SIIGO_ACCESS_KEY. El conector inicia sesión con ambos y renueva su token de 24 horas automáticamente.
¿Qué cubre? Clientes y proveedores, productos, facturas de venta con su estado DIAN y errores de sello, envío de facturas por correo electrónico, cotizaciones, notas de crédito, recibos de caja y de pago, comprobantes contables, los catálogos que necesita un documento, el balance de prueba (como un enlace a un archivo de Excel) y cuentas por pagar. Las notas de crédito, recibos y comprobantes contables son solo de lectura, y ninguna herramienta mueve dinero.
¿Qué herramientas se instalan desactivadas? siigo_annul_invoice y siigo_delete_invoice. Actívalas en la página del conector solo si la IA debe usarlas. Una factura solo se envía a la DIAN cuando send_to_dian es verdadero; una vez aceptada, solo puede corregirse con una nota de crédito.
¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.
¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.
Próximos pasos
¿Te ha sido útil esta guía?