> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.

# CUCU API

> API de facturacion electronica para Bolivia. Emite, anula y gestiona facturas validas ante el SIN con una sola llamada.

<img className="block dark:hidden" src="https://mintcdn.com/cucuapillc/70V8m_Sy2no-Hi37/images/hero-light.svg?fit=max&auto=format&n=70V8m_Sy2no-Hi37&q=85&s=81477e84ddcaf7039995fa55de814af9" alt="CUCU API - Facturacion Electronica para Bolivia" width="1893" height="1078" data-path="images/hero-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/cucuapillc/70V8m_Sy2no-Hi37/images/hero-dark.svg?fit=max&auto=format&n=70V8m_Sy2no-Hi37&q=85&s=4094afdde0db975beeb35c52ec52553e" alt="CUCU API - Facturacion Electronica para Bolivia" width="1893" height="1078" data-path="images/hero-dark.svg" />

## La API de facturacion electronica mas moderna de Bolivia

CUCU API es la infraestructura que conecta tu sistema con el **Servicio de Impuestos Nacionales (SIN)** a traves del SIAT. En lugar de meses implementando SOAP, firma digital y contingencia, integra facturacion electronica boliviana con una sola llamada REST o directamente desde tu AI con MCP.

Diseñada para desarrolladores, equipos de producto y empresas que necesitan **facturar rapido, sin errores y sin depender de software legacy**. Multi-tenant desde el nucleo: gestiona decenas de empresas, sucursales y puntos de venta desde una sola integracion.

***

## Por que CUCU?

<CardGroup cols={2}>
  <Card title="Emision en 2 segundos" icon="bolt">
    Crea y emite facturas electronicas validadas por el SIAT en tiempo real.
    Tu cliente recibe su factura antes de terminar de leer el recibo. Sin colas,
    sin esperas, sin procesamiento batch.
  </Card>

  <Card title="PDF, Ticket 80mm y XML automatico" icon="file-pdf">
    Cada factura genera automaticamente su PDF A4, ticket termico de 80mm
    para impresoras POS, y el XML normado por el SIN. Todo listo para
    descargar o enviar al instante.
  </Card>

  <Card title="Email al cliente incluido" icon="envelope">
    No necesitas configurar SMTP ni servicios de email. CUCU envia
    automaticamente la factura al correo del cliente con PDF adjunto
    y branding personalizado de tu empresa.
  </Card>

  <Card title="Multi-empresa, sucursal y POS" icon="building">
    Arquitectura multi-tenant real. Una sola API Key puede gestionar
    multiples empresas, cada una con sus sucursales, puntos de venta,
    certificados digitales y configuracion SIAT independiente.
  </Card>

  <Card title="Contingencia automatica" icon="shield-check">
    Cuando el SIAT no responde, CUCU activa automaticamente el modo
    contingencia. Tus facturas se emiten sin interrupcion y se sincronizan
    cuando el servicio se restablece. Cero downtime para tu negocio.
  </Card>

  <Card title="AI integrado con RAG" icon="robot">
    Asistente inteligente que consulta la normativa tributaria boliviana
    usando Retrieval-Augmented Generation. Resuelve errores SIAT, valida
    datos fiscales y responde consultas tecnicas al instante.
  </Card>

  <Card title="MCP Server — 14 herramientas" icon="plug" color="#10b981">
    **NUEVO** — Conecta Claude, Cursor, VS Code o cualquier AI directamente a
    facturacion electronica via Model Context Protocol. Emite facturas con
    lenguaje natural. El futuro de la integracion ya esta aqui.
  </Card>

  <Card title="Firma digital y CUF automatico" icon="lock">
    La firma digital PKCS#12, generacion del Codigo Unico de Facturacion (CUF)
    y toda la criptografia requerida por el SIN se manejan internamente.
    Tu solo envias los datos de la venta.
  </Card>
</CardGroup>

***

## Dile a tu AI: "factura esto"

<div style={{display: 'flex', alignItems: 'center', gap: '16px', marginBottom: '16px'}}>
  <img src="https://mintcdn.com/cucuapillc/FvAy0RdzAZcvUeU_/logo/cucu-fly-small.gif?s=da4ae28d6a263cf353317b47a4c04636" alt="CUCU" style={{width: '80px'}} width="128" height="128" data-path="logo/cucu-fly-small.gif" />

  <div>
    <strong style={{fontSize: '1.1em'}}>Integracion MCP con tu AI preferida</strong><br />
    Conecta Claude, Cursor, Windsurf o VS Code directamente a facturacion electronica.
    Solo dile a tu AI: <em>"Emite una factura a EMPRESA S.R.L. por Bs. 1,500"</em> y listo.
    Tu AI ya entiende el SIAT — nosotros nos encargamos de las normativas.
  </div>
</div>

Con el MCP Server de CUCU, tu AI tiene acceso a **14 herramientas** que cubren todo el ciclo de facturacion: emision, anulacion, notas de credito/debito, consulta, verificacion de NIT y mas. **Quedate tranquilo con las actualizaciones normativas del SIAT** — CUCU mantiene la certificacion al dia para que tu no tengas que preocuparte.

<Warning>
  **Implementar SIAT directo es mas complejo de lo que parece.** WSDL cambiantes, firma digital PKCS#12, rotacion de CUFD cada 24h, contingencia offline, 15 tipos de documento sector, normativas que cambian sin previo aviso. Un error = multa del SIN. Con CUCU + MCP, tu AI factura en segundos y nosotros mantenemos la certificacion.
</Warning>

<Card title="Conecta tu AI al MCP Server" icon="plug" href="/mcp/setup">
  Pasale tu API Key a Claude, Cursor o VS Code. Tu AI factura en 2 minutos.
</Card>

***

## Empieza en 3 pasos

<Steps>
  <Step title="Activa tu plan y obtén tu API Key">
    Contrata tu plan en [app.cucu.bo](https://app.cucu.bo/signup) y recibe tu API Key
    al instante. El sandbox conecta con el SIAT piloto del SIN — no necesitas
    NIT real ni certificado digital para desarrollar.

    ```bash theme={"system"}
    # Tu API Key sandbox se ve asi:
    YOUR_API_KEY
    ```
  </Step>

  <Step title="Emite tu primera factura">
    Una sola llamada POST con los datos de la venta. CUCU se encarga de la firma
    digital, el CUF, la validacion SIAT, la generacion del PDF y el envio por email.

    ```bash theme={"system"}
    curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
      -H "X-API-Key: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "pointOfSaleId": "TU_PUNTO_DE_VENTA_UUID",
        "clientDocumentType": 5,
        "clientDocumentNumber": "1234567",
        "clientBusinessName": "EMPRESA TEST S.R.L.",
        "paymentMethodCode": 1,
        "details": [{
          "activityEconomic": "620100",
          "codeProductSin": "83141",
          "description": "Servicio de consultoria",
          "quantity": 1,
          "unitMeasure": 58,
          "priceUnit": 500.00
        }]
      }'
    ```
  </Step>

  <Step title="Pasa a produccion">
    Cuando estes listo, sube tu certificado digital (.pfx), configura tu NIT real
    y cambia a tu API Key de produccion (`sk_live_...`). Mismo codigo, mismo
    endpoint, facturas reales validadas por el SIN.
  </Step>
</Steps>

***

## Explora la documentacion

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Tutorial completo para emitir tu primera factura en 5 minutos.
    Incluye ejemplos en curl, JavaScript y Python.
  </Card>

  <Card title="Referencia API" icon="code" href="/api/overview">
    Documentacion completa de todos los endpoints REST. Schemas,
    codigos de error, paginacion y ejemplos de request/response.
  </Card>

  <Card title="MCP Server" icon="plug" href="/mcp/setup">
    Conecta tu AI directamente a facturacion. 14 herramientas MCP
    para emitir, anular y consultar facturas con lenguaje natural.
  </Card>

  <Card title="Precios" icon="credit-card" href="/pricing">
    Planes flexibles desde startup hasta enterprise. Sandbox
    de desarrollo y MCP Server incluidos en todos los planes.
  </Card>
</CardGroup>

***

<div className="gradient-card" style={{marginTop: '32px', padding: '32px', textAlign: 'center', borderRadius: '12px'}}>
  <h3 style={{marginTop: 0}}>Factura electronica en minutos, no en meses</h3>

  <p style={{maxWidth: '500px', margin: '0 auto 16px'}}>
    Activa tu plan, conecta tu AI via MCP y emite tu primera factura hoy.
    Tu AI ya entiende CUCU — pasale tu API Key y listo.
  </p>

  <a href="https://app.cucu.bo/signup" style={{fontWeight: 'bold'}}>
    Activar Plan →
  </a>
</div>