Skip to main content
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?"}'

const response = await fetch('https://sandbox.cucu.bo/api/v1/ai/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    mensaje: 'Que requisitos necesito para emitir facturas electronicas en Bolivia?'
  })
});

import requests

response = requests.post(
    'https://sandbox.cucu.bo/api/v1/ai/chat',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'YOUR_API_KEY'
    },
    json={'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"]
  }
}