> ## 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.

# Utilidades SIAT

> Las 6 herramientas MCP de soporte para operaciones fiscales, validación y diagnóstico SIAT.

## Utilidades SIAT

Herramientas de soporte para operaciones fiscales y diagnóstico.

<CardGroup cols={2}>
  <Card title="verificarFormatoNit" icon="check-double" href="#verificarformatonit">
    Valida formato NIT según algoritmo del SIN. Detecta errores
    de digitación antes de emitir factura.
  </Card>

  <Card title="historialCliente" icon="clock-rotate-left" href="#historialcliente">
    Historial de facturación de un cliente por NIT. Razón social,
    email, teléfono y cantidad de facturas emitidas.
  </Card>

  <Card title="buscarNormativa" icon="book-open" href="#buscarnormativa">
    Búsqueda semántica (RAG) en normativa tributaria SIAT.
    Responde preguntas sobre regulaciones y requisitos fiscales.
  </Card>

  <Card title="erroresComunesSiat" icon="circle-exclamation" href="#errorescomunessiat">
    Lista errores frecuentes del SIAT con códigos, descripciones
    y soluciones recomendadas.
  </Card>

  <Card title="buscarContingencias" icon="tower-broadcast" href="#buscarcontingencias">
    Búsqueda RAG en historial de contingencias. Caídas SIAT,
    duración, patrones y puntos de venta afectados.
  </Card>

  <Card title="calcularMontoLiteral" icon="spell-check" href="#calcularmontoLiteral">
    Convierte un monto numérico a texto literal en bolivianos.
    Requerido por normativa SIAT en cada factura.
  </Card>
</CardGroup>

***

<h2 id="verificarformatonit\">
  verificarFormatoNit \\
</h2>

Valida el formato de un NIT boliviano. Los NITs válidos tienen 7-15 dígitos. El NIT 0 es válido (consumidor final).

| Parámetro | Tipo   | Requerido | Descripción                  |
| --------- | ------ | --------- | ---------------------------- |
| `nit`     | String | Sí        | NIT a validar (solo dígitos) |

**Requiere autenticación:** No

**Ejemplo de uso con AI:**

> "Verifica si el NIT 1023456789 es válido"

***

<h2 id="historialcliente\">
  historialCliente \\
</h2>

Obtiene el historial de facturación de un cliente por NIT. Muestra razón social, email, teléfono y cantidad de facturas emitidas.

| Parámetro | Tipo   | Requerido | Descripción     |
| --------- | ------ | --------- | --------------- |
| `nit`     | String | Sí        | NIT del cliente |

**Requiere autenticación:** Sí

**Ejemplo de uso con AI:**

> "¿Cuál es el historial de facturación del cliente con NIT 99001?"

***

<h2 id="buscarnormativa\">
  buscarNormativa \\
</h2>

Búsqueda semántica (RAG) en la normativa oficial del SIAT sobre facturación electrónica boliviana.

| Parámetro  | Tipo   | Requerido | Descripción                    |
| ---------- | ------ | --------- | ------------------------------ |
| `consulta` | String | Sí        | Pregunta o término de búsqueda |

**Requiere autenticación:** No

**Ejemplo de uso con AI:**

> "¿Cómo funciona el CUFD según la normativa?"

***

<h2 id="errorescomunessiat\">
  erroresComunesSiat \\
</h2>

Lista los errores más comunes del SIAT con sus códigos, descripciones y soluciones recomendadas.

| Parámetro   | Tipo | Requerido | Descripción            |
| ----------- | ---- | --------- | ---------------------- |
| *(ninguno)* | -    | -         | No requiere parámetros |

**Requiere autenticación:** No

**Ejemplo de uso con AI:**

> "¿Cuáles son los errores más comunes del SIAT?"

***

<h2 id="buscarcontingencias\">
  buscarContingencias \\
</h2>

Búsqueda semántica (RAG) en el historial de contingencias y eventos significativos. Encuentra caídas del SIAT, puntos de venta con problemas, duración y patrones.

| Parámetro  | Tipo   | Requerido | Descripción                  |
| ---------- | ------ | --------- | ---------------------------- |
| `consulta` | String | Sí        | Pregunta sobre contingencias |

**Requiere autenticación:** No

**Ejemplo de uso con AI:**

> "¿Cuántas caídas del SIAT hubo este mes?"

***

<h2 id="calcularmontoLiteral\">
  calcularMontoLiteral \\
</h2>

Convierte un monto numérico a su representación en texto literal (requerido por el SIAT en cada factura).

| Parámetro | Tipo   | Requerido | Descripción                |
| --------- | ------ | --------- | -------------------------- |
| `monto`   | double | Sí        | Monto numérico a convertir |

**Requiere autenticación:** No

**Retorno ejemplo:** `"Quinientos 50/100 Bolivianos"`

**Ejemplo de uso con AI:**

> "Convierte 1500.75 a texto literal"

***

## NIT — Formato y validación

El NIT (Número de Identificación Tributaria) boliviano tiene estas reglas:

* **Longitud:** 7 a 15 dígitos (solo números)
* **NIT 0:** Válido — representa "consumidor final" (Sin nombre)
* **Validación:** Usa `verificarFormatoNit` antes de emitir para evitar rechazos del SIAT
* **Documento tipo 5:** En `clientDocumentType`, el valor `5` = NIT
* Los NITs se validan contra el algoritmo oficial del SIN (módulo 11)