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 Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Siigo con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
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 + Claude
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 Claude
La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde este guía muestreYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.
- En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
- Pulsa + Add y después Add custom connector.
- Escribe un nombre, por ejemplo
Siigo, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Continue, deja los ajustes detectados y vuelve a pulsar Continue. - Elige Sign in now, pulsa Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas a continuación aparecerán en tu chat: comienza a escribir indicaciones.
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
¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
¿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.
Próximos pasos
- Página de inicio del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?