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.

​
Request Body

​
mensaje
string
required
Tu pregunta sobre facturacion.
curl -X POST https://sandbox.cucu.bo/api/v1/ai/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8" \
  -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.

​
Request Body

​
nit
string
required
NIT del cliente.
​
razonSocial
string
required
Razon social del cliente.
​
tipoDocumento
integer
required
Tipo de documento.
​
montoTotal
number
required
Monto total.
​
metodoPago
integer
required
Metodo de pago.
​
detalle
string
required
Descripcion del detalle.
curl -X POST https://sandbox.cucu.bo/api/v1/ai/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8" \
  -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.

​
Request Body

​
codigoError
integer
required
Codigo de error SIAT.
​
mensajeError
string
required
Mensaje de error devuelto por SIAT.
​
contexto
string
required
Contexto 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: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8" \
  -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.
​
q
string
required
Consulta de busqueda.

​
Estado del servicio AI

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