Skip to main content

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 - Facturacion Electronica para Bolivia

​
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?

Emision en 2 segundos

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.

PDF, Ticket 80mm y XML automatico

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.

Email al cliente incluido

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.

Multi-empresa, sucursal y POS

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.

Contingencia automatica

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.

AI integrado con RAG

Asistente inteligente que consulta la normativa tributaria boliviana usando Retrieval-Augmented Generation. Resuelve errores SIAT, valida datos fiscales y responde consultas tecnicas al instante.

MCP Server — 14 herramientas

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.

Firma digital y CUF automatico

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.

​
Dile a tu AI: “factura esto”

CUCU
Integracion MCP con tu AI preferida
Conecta Claude, Cursor, Windsurf o VS Code directamente a facturacion electronica. Solo dile a tu AI: “Emite una factura a EMPRESA S.R.L. por Bs. 1,500” y listo. Tu AI ya entiende el SIAT — nosotros nos encargamos de las normativas.
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.
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.

Conecta tu AI al MCP Server

Pasale tu API Key a Claude, Cursor o VS Code. Tu AI factura en 2 minutos.

​
Empieza en 3 pasos

1

Activa tu plan y obtén tu API Key

Contrata tu plan en app.cucu.bo 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.
# Tu API Key sandbox se ve asi:
YOUR_API_KEY
2

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.
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
    }]
  }'
3

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.

​
Explora la documentacion

Quickstart

Tutorial completo para emitir tu primera factura en 5 minutos. Incluye ejemplos en curl, JavaScript y Python.

Referencia API

Documentacion completa de todos los endpoints REST. Schemas, codigos de error, paginacion y ejemplos de request/response.

MCP Server

Conecta tu AI directamente a facturacion. 14 herramientas MCP para emitir, anular y consultar facturas con lenguaje natural.

Precios

Planes flexibles desde startup hasta enterprise. Sandbox de desarrollo y MCP Server incluidos en todos los planes.

​
Factura electronica en minutos, no en meses

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.

Activar Plan →