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, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Siigo con la configuración guiada y añade tu URL MCP a tu asistente de IA. 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
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
Configurar toma alrededor de 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 por sí mismo. 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 (filtrar por identification), siigo_get_customer, siigo_create_customer; siigo_list_products (filtrar 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 están instaladas apagadas. 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 ni 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.
Requisitos previos: SIIGO_USERNAME, SIIGO_ACCESS_KEY
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Siigo y pega las variables de entorno listadas bajo Requisitos previos.
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, BienConsumidor), control_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 ítem 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 es… |
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, ítems y public_url. Filtra por nombre… |
siigo_get_quotation | Lee una cotización en su totalidad: número, nombre, fecha, cliente, vendedor, ítems 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, ítems… |
siigo_get_credit_note | Lee una nota de crédito en su totalidad: número, fecha, la factura que corrige, cliente, razón, ítems, 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 pendientes 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 pendiente con due (prefijo, consecutivo, cotización, fecha, saldo en local… |
Ejemplos de solicitudes
- "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."
Próximos pasos
¿Te ha sido útil esta guía?