Siigo MCP Server

--- name: siigo-expert description: Siigo API, Colombian electronic invoicing, DIAN compliance, customer/product data. Use when working on invoices, credit notes, tax responsibilities, or CUFE validation. --- # Siigo Expert (Product Manager) Research-First skill for Siigo business logic, DIAN compliance, and user workflows. ## When to Use Invoke this skill when working on: - Colombian electronic invoicing requirements - DIAN compliance and document types - Customer/product data modeling - Invoice workflows and validations - API integration patterns ## Key Resources ### Siigo API Documentation - [Apiary Reference](https://siigoapi.docs.apiary.io/) - Complete API reference - [Developer Portal](https://developers.siigo.com/docs/siigoapi/) - Guides and tutorials - [Customer Portal](https://siigonube.portaldeclientes.siigo.com/informacion-siigo-api/) - Account setup ### Authentication - Base URL: `https://api.siigo.com/v1/` - Auth endpoint: `https://services.siigo.com/alliances/api/siigoapi-users/v1/sign-in` - Token validity: 24 hours - Required headers: `Authorization: Bearer {token}`, `Partner-Id: {id}` ## Colombian Invoicing (DIAN) ### Document Types - **FV** (Factura de Venta) - Sales invoice - **NC** (Nota Crédito) - Credit note - **ND** (Nota Débito) - Debit note - **RC** (Recibo de Caja) - Cash receipt - **FC** (Factura de Compra) - Purchase invoice - **CC** (Comprobante Contable) - Accounting voucher ### Electronic Invoicing - CUFE: Código Único de Factura Electrónica (unique invoice code) - XML format: UBL V2.1 standard - Stamp endpoint sends document to DIAN - Stamped documents cannot be modified (create credit note instead) ### Customer Types - **Person** (Persona Natural): Individual, uses cédula - **Company** (Empresa): Legal entity, uses NIT ### Identification Types - 13: Cédula de ciudadanía - 31: NIT (Número de Identificación Tributaria) - 22: Cédula de extranjería - 42: Documento de identificación extranjero ### Tax Responsibilities - R-99-PN: No responsable de IVA (persona natural) - O-13: Gran contribuyente - O-15: Autorretenedor - O-23: Agente de retención IVA ## Common Workflows ### Create Invoice Flow 1. Get document types (`get_document_types(type="FV")`) 2. Get or create customer 3. Get or create products with taxes 4. Create invoice with items and payments 5. Stamp invoice to DIAN (`stamp_invoice`) 6. Send PDF via email (`send_invoice_email`) ### Credit Note Flow 1. Get original invoice 2. Get document types (`get_document_types(type="NC")`) 3. Create credit note referencing original invoice 4. Stamp to DIAN ### API Pagination - Default: 25 items per page - Max: 100 items per page - Use `page` and `page_size` parameters - Response includes `_links` for navigation ### Rate Limits - 100 requests per minute (production) - Token refresh before expiry (24h validity) ## Prompt When invoked, research the specific Siigo/DIAN question using the Apiary docs, then provide: 1. Business context and requirements 2. API endpoints and parameters needed 3. Example workflow or data structure 4. Links to relevant documentation sections