# Siigo MCP Integration

> Integración con la plataforma contable Siigo. Crear facturas, gestionar productos y clientes, procesar pagos y generar reportes de ventas.

## Overview

| Property | Value |
|----------|-------|
| Category | Facturación & Contabilidad |
| Type | MCP |
| Tools | 11 |
| URL | https://jelou.ai/es/marketplace/siigo |

## Available Tools (11)

### Crear Factura

Crea una factura electrónica con detalles de productos y datos del cliente. Devuelve el número de factura, el estado y la URL del PDF.

### Crear Proforma

Crea una cotización/proforma (documento no fiscal). Devuelve el ID de cotización, número, total, líneas con impuestos/descuentos y URL pública para compartir con los clientes. Las cotizaciones pueden convertirse en facturas posteriormente.

### Obtener historial del cliente

Devuelve todas las facturas asociadas a un cliente específico. Proporciona un historial completo de facturas que incluye: ID de factura, número, fecha, artículos, totales, saldo (monto pendiente), pagos, estado del sello y si está anulada. Útil para '¿Qué facturas tiene el cliente X?' o 'Mostrar facturas pendientes para el cliente Y'. Filtrar por rango de fechas para obtener transacciones de un periodo específico.

### Obtener estado de inventario

Obtiene el estado de inventario/stock para un producto específico. Devuelve la identificación del producto (id, código, nombre), la cantidad total disponible en todos los almacenes y un desglose detallado por almacén (nombre del almacén y cantidad por ubicación). Útil para responder a '¿Cuántas unidades del producto X están disponibles?' o '¿Qué almacén tiene stock del producto Y?'

### Obtener Estado de la Factura

Obtiene los detalles completos de la factura por ID. Devuelve los datos de la factura, incluyendo: estado, número, fecha, información del cliente, líneas de factura con impuestos y descuentos, pagos, retenciones, totales, saldo, estado del timbrado electrónico (CUFE/CUDE), estado del correo electrónico y todos los metadatos. Esencial para rastrear el ciclo de vida de la factura y el estado del timbrado electrónico DIAN.

### Listar Clientes

Lista los clientes registrados en Siigo. Devuelve datos completos del cliente, incluyendo: identificación, nombre (array), nombre comercial, tipo (Cliente/Proveedor/Otro), tipo de persona (Persona/Empresa), datos de contacto (dirección, teléfonos, correos electrónicos), estado activo, información de IVA y metadatos. Filtrar por número de identificación (NIT/RFC/documento) o listar todo de forma paginada. Útil para 'Encontrar cliente por documento' o 'Listar todos los clientes'.

### Listar tipos de documentos

Lista los tipos de documentos disponibles del catálogo de Siigo. Estos IDs son obligatorios al crear facturas, cotizaciones, notas de crédito, etc. Devuelve el ID del tipo de documento, su nombre y su estado activo. Utilice esta herramienta para descubrir qué valores de document_id están disponibles en su cuenta de Siigo antes de crear facturas o cotizaciones.

### Listar Métodos de Pago

Lista los métodos de pago disponibles del catálogo de Siigo. Devuelve métodos de pago con ID, nombre, tipo (Cartera/Proveedor/CarteraProveedor), estado activo y indicador de fecha de vencimiento. Útil para encontrar los IDs de métodos de pago al registrar pagos (p. ej., 'Efectivo', 'Tarjeta', 'Transferencia'). También se puede filtrar opcionalmente por tipo de documento.

### Listar Productos

Lista productos y servicios del catálogo de Siigo con detalles exhaustivos. Devuelve resultados paginados con información de los productos que incluye: ID, código, nombre, tipo, precios por moneda, impuestos, niveles de inventario por almacén, clasificación de cuentas, estado activo, código de barras y metadatos. Soporta filtrado por código, tipo, rangos de fechas y más.

### Listar Usuarios

Lista de usuarios de Siigo. Estos usuarios pueden asignarse como vendedores al crear facturas o cotizaciones. Devuelve el ID de usuario, nombre, correo electrónico, nombre de usuario y estado activo. Utilice esta herramienta para descubrir los IDs de vendedor disponibles antes de crear facturas o cotizaciones. Utilice paginación para conjuntos de resultados grandes.

### Registrar pago

Crea un recibo de caja (voucher) para registrar los pagos de los clientes. Soporta pago de deuda (DebtPayment), pago anticipado (AdvancePayment) o recibo detallado (Detailed). Puede aplicar el pago a una o varias facturas. Devuelve los detalles del voucher con ID, número y confirmación de pago.

## Supported Channels

This integration works with:
- WhatsApp Business API
- Facebook Messenger
- Instagram Direct Messages
- Web Chat Widget

## AI Assistants Compatible

- ChatGPT (via MCP)
- Claude (via MCP)
- Gemini (via MCP)
- Custom AI Agents

## Quick Start

1. Sign up at https://apps.jelou.ai/signup
2. Navigate to Marketplace and add Siigo
3. Authenticate your Siigo account
4. Configure your messaging channels (WhatsApp, Facebook, etc.)
5. Copy the MCP server URL to your AI assistant

## Example Use Cases

- Automate customer inquiries using Siigo data
- Send notifications via WhatsApp when Siigo events occur
- Query Siigo data directly from ChatGPT or Claude
- Build AI agents that interact with Siigo

## Resources

- [All Integrations](https://jelou.ai/es/marketplace)
- [Full Documentation](https://jelou.ai/llms-full.txt)
- [API Docs](https://docs.jelou.ai)
- [Help Center](https://help.jelou.ai)