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 integra inteligencia artificial para ayudarte con la facturacion electronica boliviana. Usa RAG (Retrieval Augmented Generation) sobre normativa SIAT oficial.

​
Chat

POST /api/v1/ai/chat Pregunta cualquier cosa sobre facturacion electronica boliviana. El AI consulta normativa oficial del SIN.
ParametroUbicacionTipoReqDescripcion
X-API-KeyHeaderstringSiTu API Key
mensajeBodystringSiTu pregunta sobre facturacion
curl -X POST https://sandbox.cucu.bo/api/v1/ai/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"mensaje": "Que requisitos necesito para emitir facturas electronicas en Bolivia?"}'

{
  "success": true,
  "data": "Para emitir facturas electronicas en Bolivia necesitas: 1) NIT activo...",
  "timestamp": "2026-02-11T12:00:00"
}

​
Validar datos de factura

POST /api/v1/ai/validate Valida los datos de una factura antes de emitirla. El AI verifica formato de NIT, coherencia de montos, codigos validos, etc.
ParametroUbicacionTipoReqDescripcion
X-API-KeyHeaderstringSiTu API Key
nitBodystringSiNIT del cliente
razonSocialBodystringSiRazon social del cliente
tipoDocumentoBodyintegerSiTipo de documento
montoTotalBodynumberSiMonto total
metodoPagoBodyintegerSiMetodo de pago
detalleBodystringSiDescripcion del detalle
curl -X POST https://sandbox.cucu.bo/api/v1/ai/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "nit": "1023456789",
    "razonSocial": "EMPRESA DEMO S.R.L.",
    "tipoDocumento": 5,
    "montoTotal": 500.00,
    "metodoPago": 1,
    "detalle": "Servicio de desarrollo de software"
  }'

​
Resolver error SIAT

POST /api/v1/ai/resolve-error Proporciona un codigo de error SIAT y obtiene una explicacion detallada con pasos para resolverlo.
ParametroUbicacionTipoReqDescripcion
X-API-KeyHeaderstringSiTu API Key
codigoErrorBodyintegerSiCodigo de error SIAT
mensajeErrorBodystringSiMensaje de error devuelto por SIAT
contextoBodystringSiContexto adicional (que estabas intentando hacer)
curl -X POST https://sandbox.cucu.bo/api/v1/ai/resolve-error \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "codigoError": 980,
    "mensajeError": "CUFD no vigente",
    "contexto": "Intentando emitir factura de venta"
  }'

​
Buscar normativa

GET /api/v1/ai/normativas/search?q=como funciona el CUFD Busqueda semantica en la normativa oficial del SIN sobre facturacion electronica.
ParametroUbicacionTipoReqDescripcion
X-API-KeyHeaderstringSiTu API Key
qQuerystringSiConsulta de busqueda

​
Estado del servicio AI

GET /api/v1/ai/status Verifica la disponibilidad del servicio AI y las colecciones de vectores.
ParametroUbicacionTipoReqDescripcion
X-API-KeyHeaderstringSiTu API Key
{
  "success": true,
  "data": {
    "qdrantAvailable": true,
    "collections": ["normativas", "contingencias"]
  }
}