# CUCU API

- [Información General](https://docs.cucu.bo/api/informacion-general.md): Facturación electrónica en Bolivia, URL base, autenticación, formato de respuesta y paginación.
- [Content-Type](https://docs.cucu.bo/api/content-type.md): Todas las peticiones con body deben incluir Content-Type: application/json.
- [Versionado](https://docs.cucu.bo/api/versionado.md): La API usa versionado en la URL. Cambios breaking se introducen en una nueva versión.
- [Crear Factura](https://docs.cucu.bo/api/create-invoice.md): Crea y emite una factura electronica validada por el SIAT.
- [Listar Facturas](https://docs.cucu.bo/api/list-invoices.md): Obtiene una lista paginada de facturas del tenant autenticado.
- [Buscar Facturas](https://docs.cucu.bo/api/search-invoices.md): Busca facturas con filtros avanzados: estado, fechas, cliente, numero de factura.
- [Obtener Factura](https://docs.cucu.bo/api/get-invoice.md): Obtiene los detalles completos de una factura por ID o por CUF.
- [Anular Factura](https://docs.cucu.bo/api/cancel-invoice.md): Anula por servicio web una factura emitida, dentro de plazo.
- [Anulación Administrativa (fuera de plazo)](https://docs.cucu.bo/api/cancel-administrative.md): Registra una anulación fuera de plazo aprobada por Resolución Administrativa del SIN (RND 102600000025).
- [Crear Nota Credito/Debito](https://docs.cucu.bo/api/credit-note.md): Emite una nota de credito o debito contra una factura original validada.
- [Anular Nota Credito/Debito](https://docs.cucu.bo/api/cancel-note.md): Anula una nota de credito o debito emitida. Operacion irreversible.
- [Revertir Anulacion](https://docs.cucu.bo/api/revert-cancel.md): Revierte la anulacion de una factura, devolviendola de CANCELLED a VALIDATED.
- [Estado de Factura](https://docs.cucu.bo/api/invoice-status.md): Verifica el estado actual de una factura ante el SIAT.
- [Crear Facturas en Lote](https://docs.cucu.bo/api/batch-invoices.md): Crea multiples facturas en una sola llamada. Maximo 20 facturas por request.
- [Reenviar Email](https://docs.cucu.bo/api/resend-email.md): Reenvia la factura por email al cliente.
- [Dashboard](https://docs.cucu.bo/api/dashboard.md): Resumen ejecutivo de facturacion: totales, montos, estados, tendencia mensual.
- [Compra Venta](https://docs.cucu.bo/api/sectors/sale.md): Factura estandar de compra-venta. Sector 1.
- [Alquiler de Inmuebles](https://docs.cucu.bo/api/sectors/rent.md): Recibo de alquiler de bienes inmuebles propios. Sector 2.
- [Bonificaciones](https://docs.cucu.bo/api/sectors/bonificaciones.md): Factura de bonificaciones y entregas promocionales. Sector 35.
- [Nota Credito-Debito](https://docs.cucu.bo/api/sectors/note-credit-debit.md): Documento de ajuste fiscal para devoluciones parciales o totales sobre facturas emitidas. Sectores 24, 47 (Descuento) y 48 (ICE).
- [Exportacion](https://docs.cucu.bo/api/sectors/export.md): Factura comercial de exportacion de bienes. Sector 3.
- [Exportacion de Servicios](https://docs.cucu.bo/api/sectors/export-services.md): Factura de exportacion de servicios. Sector 28.
- [Exportacion de Minerales](https://docs.cucu.bo/api/sectors/export-minerals.md): Factura comercial de exportacion de minerales. Sector 20.
- [Venta Interna de Minerales](https://docs.cucu.bo/api/sectors/minerals.md): Factura de venta de minerales en el territorio nacional. Sector 21.
- [Zona Franca](https://docs.cucu.bo/api/sectors/free-zone.md): Factura para operaciones en zonas francas. Sector 5.
- [Tasa Cero](https://docs.cucu.bo/api/sectors/duty-free.md): Factura con tasa IVA cero para sectores exentos. Sector 8.
- [Sector Educativo](https://docs.cucu.bo/api/sectors/education.md): Factura para instituciones educativas. Sector 11.
- [Servicios de Salud](https://docs.cucu.bo/api/sectors/health-service.md): Factura para servicios medicos y de salud. Sector 10.
- [Servicios Basicos](https://docs.cucu.bo/api/sectors/basic-service.md): Factura para empresas de agua, luz, gas y servicios basicos. Sector 13.
- [Aerolineas](https://docs.cucu.bo/api/sectors/airline.md): Factura para empresas de transporte aereo. Sector 13.
- [Alojamiento](https://docs.cucu.bo/api/sectors/hotel.md): Factura para hoteles, hostales y servicios de alojamiento. Sector 16.
- [Hospitales y Clinicas](https://docs.cucu.bo/api/sectors/hospital.md): Factura para hospitales, clinicas y centros medicos especializados. Sector 17.
- [Juegos de Azar](https://docs.cucu.bo/api/sectors/games-luck.md): Factura para casinos, loterias y juegos de azar. Sector 16.
- [Telecomunicaciones](https://docs.cucu.bo/api/sectors/telecom.md): Factura para empresas de telecomunicaciones. Sector 22.
- [Entidades Financieras](https://docs.cucu.bo/api/sectors/financial.md): Factura para bancos, cooperativas y entidades financieras. Sector 15.
- [Moneda Extranjera](https://docs.cucu.bo/api/sectors/currency-exchange.md): Factura de compra y venta de moneda extranjera. Sector 9.
- [Seguros](https://docs.cucu.bo/api/sectors/insurance.md): Factura para companias de seguros. Sector 34.
- [Webhooks](https://docs.cucu.bo/api/webhooks.md): Recibe notificaciones en tiempo real de eventos de facturación: validación, rechazo, contingencia y estado de conexión con el SIAT. Firma HMAC-SHA256 con el estándar Standard Webhooks.
- [Contingencia](https://docs.cucu.bo/api/events.md): Gestiona eventos de contingencia cuando el SIAT no esta disponible.
- [Emision Masiva](https://docs.cucu.bo/api/massive-emission.md): Acumula facturas en un lote y enviálas juntas al SIAT en paquetes comprimidos.
- [Sucursales y Puntos de Venta](https://docs.cucu.bo/api/onboarding.md): Gestiona tus propias sucursales y puntos de venta (self-service) con tu API Key, sin depender del equipo CUCU.
- [Codigos SIAT](https://docs.cucu.bo/api/codes.md): Verificacion de NIT y gestion de CUFD.
- [Subir certificado digital](https://docs.cucu.bo/api/upload-certificate.md): Sube el certificado .crt y la llave privada .pem de tu empresa para firmar facturas electronicas.
- [Catalogos](https://docs.cucu.bo/api/catalogs.md): Sincroniza y consulta catalogos del SIAT (actividades, productos, leyendas, etc.).
- [Acceso Publico](https://docs.cucu.bo/api/public-access.md): Descarga publica de facturas (PDF A4, ticket, ticket SIAT, chititicket, XML, ZIP) sin autenticacion.
- [AI](https://docs.cucu.bo/api/ai.md): Asistente AI para facturacion: chat, validacion de datos y resolucion de errores SIAT.
- [Storage](https://docs.cucu.bo/api/storage.md): Gestion de almacenamiento S3 y carga de logos.
- [MCP Server](https://docs.cucu.bo/mcp/overview.md): Conecta tu agente AI a la facturación electrónica de Bolivia: 45 herramientas via Streamable HTTP con tu API Key.
- [Como funciona](https://docs.cucu.bo/mcp/como-funciona.md): Lo que pasa por el cable cuando le pides una factura a tu AI: el tools/call real y su respuesta.
- [Arquitectura](https://docs.cucu.bo/mcp/arquitectura.md): Como se conectan los clientes MCP con el CUCU MCP Server y la infraestructura subyacente.
- [Quickstart MCP](https://docs.cucu.bo/mcp/quickstart.md): Conecta tu editor o AI al MCP Server de CUCU en 2 minutos. Paso a paso para Claude Desktop, Cursor, Windsurf, VS Code y Claude Code.
- [MCP Avanzado](https://docs.cucu.bo/mcp/advanced.md): Produccion, dual environments, autenticacion, protocolos de transporte, clientes custom y troubleshooting.
- [Facturación](https://docs.cucu.bo/mcp/herramientas-facturacion.md): Las 10 herramientas MCP para el ciclo completo de facturación electrónica boliviana.
- [Contingencia y Eventos](https://docs.cucu.bo/mcp/herramientas-eventos.md): Las 7 herramientas MCP para gestionar eventos significativos (contingencia) y la emisión offline.
- [Emisión Masiva](https://docs.cucu.bo/mcp/herramientas-masiva.md): Las 4 herramientas MCP para emitir por lote con la modalidad masiva del SIAT (código 3).
- [Administración](https://docs.cucu.bo/mcp/herramientas-admin.md): Las 9 herramientas MCP de administración: tenants, API keys, sectores, CAFC y POS.
- [Utilidades SIAT](https://docs.cucu.bo/mcp/herramientas-utilidades.md): Las 7 herramientas MCP de soporte para operaciones fiscales, validación y diagnóstico SIAT.
- [Webhooks](https://docs.cucu.bo/mcp/herramientas-webhooks.md): Las 8 herramientas MCP para gestionar webhooks de facturación: registro, consulta, rotación de secreto y auditoría de entregas.
- [Endpoints](https://docs.cucu.bo/mcp/endpoints.md): URLs de conexion del MCP Server de CUCU para sandbox y produccion.
- [Clientes compatibles](https://docs.cucu.bo/mcp/clientes.md): Todos los clientes MCP compatibles con el servidor de CUCU: Claude Desktop, Cursor, Windsurf, VS Code y mas.
- [Siguiente paso](https://docs.cucu.bo/mcp/siguiente-paso.md): Conecta tu editor, explora las herramientas o configura produccion.
- [CUCU Cobros QR](https://docs.cucu.bo/payments/cobros-qr/introduccion.md): Cobra por QR desde tu sistema, en el acto y en bolivianos
- [Modalidades de Procesamiento](https://docs.cucu.bo/payments/cobros-qr/modalidades.md): CUCU Pay (pasarela centralizada) y CUCU Direct (flujo B2B cuenta a cuenta).
- [Autenticación](https://docs.cucu.bo/payments/cobros-qr/autenticacion.md): Tu API key en el header X-Api-Key.
- [Idempotencia](https://docs.cucu.bo/payments/cobros-qr/idempotencia.md): Header Idempotency-Key con ventana de 24 h para evitar cobros duplicados en reintentos.
- [POST /qr — Crear QR de cobro](https://docs.cucu.bo/payments/cobros-qr/crear-transaccion-qr.md): Genera un QR de cobro escaneable desde cualquier banca móvil de Bolivia.
- [GET /qr/{qrId} — Consultar estado](https://docs.cucu.bo/payments/cobros-qr/consultar-estado.md): Estado actual de un QR y el detalle de los pagos recibidos.
- [Webhooks](https://docs.cucu.bo/payments/cobros-qr/webhooks.md): Te avisamos cuando te pagan. Firma Standard Webhooks, 6 reintentos.
- [Referencia de campos](https://docs.cucu.bo/payments/cobros-qr/referencia-campos.md): Campos del request y de la respuesta al crear un QR.
- [Estados del ciclo de vida](https://docs.cucu.bo/payments/cobros-qr/estados.md): Ciclo de vida completo de una transacción QR: PENDING → PAID / REJECTED / EXPIRED / CANCELLED / ERROR.
- [Guía de expiración flexible](https://docs.cucu.bo/payments/cobros-qr/guia-expiracion.md): El campo expiration acepta duración relativa (30m, 7d, 1y) o fecha absoluta ISO 8601.
- [Manejo de errores](https://docs.cucu.bo/payments/cobros-qr/manejo-errores.md): Estructura de errores, códigos HTTP y reintentos seguros.
- [Buenas prácticas de integración](https://docs.cucu.bo/payments/cobros-qr/buenas-practicas.md): Flujo recomendado, imagen del QR, conciliación y ambientes.
- [CUCU Crypto Checkout](https://docs.cucu.bo/payments/crypto/introduccion.md): Acepta pagos en criptomonedas con liquidación automática en bolivianos
- [Modalidades de Pago](https://docs.cucu.bo/payments/crypto/modalidades.md): CUCU Pay (pasarela centralizada) y CUCU Direct B2B con Binance.
- [Criptomonedas Soportadas](https://docs.cucu.bo/payments/crypto/criptomonedas.md): USDT y USDC como activos prioritarios, más suite multicripto global y denominación en moneda fiat.
- [Autenticación](https://docs.cucu.bo/payments/crypto/autenticacion.md): API Key en el header X-API-Key para endpoints de merchant. El endpoint de tipo de cambio es público.
- [POST /charges — Crear Cobro](https://docs.cucu.bo/payments/crypto/crear-cobro.md): Genera un cobro crypto. Devuelve la URL de pago y el QR listo para mostrar.
- [GET /charges/{id} — Consultar Cobro](https://docs.cucu.bo/payments/crypto/consultar-cobro.md): Retorna el estado actual de un cobro.
- [POST /charges/{id}/cancel — Cancelar Cobro](https://docs.cucu.bo/payments/crypto/cancelar-cobro.md): Cancela un cobro en estado created o pending. Un cobro ya pagado (completed) no puede cancelarse.
- [GET /exchange-rate — Tipo de Cambio](https://docs.cucu.bo/payments/crypto/tipo-cambio.md): Endpoint público. Snapshot SELL + BUY del mercado P2P para un par fiat/crypto. Sin autenticación.
- [Webhooks de Merchant](https://docs.cucu.bo/payments/crypto/webhooks-merchant.md): Registra, prueba y elimina la URL de tu servidor para recibir eventos en tiempo real.
- [Health Check](https://docs.cucu.bo/payments/crypto/health-check.md): Verifica el estado de tu integración y si tienes webhook registrado.
- [Webhooks Salientes](https://docs.cucu.bo/payments/crypto/webhooks.md): Eventos en tiempo real con firma Standard Webhooks (HMAC-SHA256). Política de 6 reintentos con backoff.
- [Estados de un Cobro](https://docs.cucu.bo/payments/crypto/estados.md): Ciclo de vida completo: created → pending → completed / expired / cancelled / failed.
- [Guía de Integración Rápida](https://docs.cucu.bo/payments/crypto/guia-integracion.md): Tres pasos para salir a producción: configuración inicial, flujo de pago e implementación del receptor de webhooks.
- [Referencia de Errores](https://docs.cucu.bo/payments/crypto/errores.md): Códigos HTTP, errores de validación comunes y formato de respuesta de error.
- [Tipo de cambio (BCB)](https://docs.cucu.bo/bcb-api.md): TC oficial, UFV, oro, monedas, SOFR, DEG e inflación del BCB. REST + MCP, sin API key.
- [Novedades](https://docs.cucu.bo/bcb/novedades.md): Cambios de la API de tipo de cambio BCB.
- [Uso justo](https://docs.cucu.bo/bcb/uso-justo.md): Límites, caché recomendada y qué pasa si se abusa de la API gratuita.
- [TC oficial](https://docs.cucu.bo/bcb/oficial.md): Tipo de cambio oficial flexible del dólar (USD/BOB).
- [TC del dólar](https://docs.cucu.bo/bcb/usd.md): TC del dólar: oficial + alias de compatibilidad.
- [Monedas](https://docs.cucu.bo/bcb/monedas.md): Monedas internacionales que publica el BCB, en bolivianos.
- [UFV](https://docs.cucu.bo/bcb/ufv.md): Unidad de Fomento a la Vivienda del día.
- [Oro y plata](https://docs.cucu.bo/bcb/oro.md): Cotización de oro y plata (USD por onza troy fina).
- [SOFR](https://docs.cucu.bo/bcb/sofr.md): Tasa SOFR (Secured Overnight Financing Rate).
- [DEG / SDR](https://docs.cucu.bo/bcb/sdr.md): Derecho Especial de Giro (DEG/SDR) en USD.
- [Inflación](https://docs.cucu.bo/bcb/inflacion.md): IPC, variación mensual y a 12 meses.
- [OMA](https://docs.cucu.bo/bcb/oma.md): Tasas de las Operaciones de Mercado Abierto del BCB.
- [TRe](https://docs.cucu.bo/bcb/tre.md): Tasa de Referencia (TRe) del mes por denominación.
- [Todos los indicadores](https://docs.cucu.bo/bcb/todos.md): Todos los indicadores del BCB en un objeto.
- [Histórico](https://docs.cucu.bo/bcb/historico.md): Lo que el BCB publicó para cada fecha, con su procedencia: `?fecha=` y rangos.
- [Servidor MCP](https://docs.cucu.bo/bcb/mcp.md): Integra el tipo de cambio del BCB en Claude, Cursor o VS Code vía Model Context Protocol.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.