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

# Diagnóstico de rechazos

> GET /api/v3/invoices/{id}/diagnosis: por qué el SIN rechazó una factura o nota y qué hacer, con acción tipada.

Por qué el SIN rechazó un documento y qué hacer. Tool MCP gemela: `diagnosticarRechazo`.

El mismo bloque `diagnosis` ya viene, sin pedirlo, en la factura o nota `REJECTED` (incluida la respuesta
[`422 SIAT_REJECTED`](https://docs.cucu.bo/errors#siat_rejected)), en los webhooks `invoice.rejected` y `contingency.package_rejected`, y en
`rejectedInvoices` de la emisión masiva. Ese bloque inline usa el catálogo curado y el mensaje del SIN; este endpoint
suma la normativa relacionada y, si está habilitada, una propuesta de IA para códigos fuera del catálogo.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://sandbox.cucu.bo/api/v3/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/diagnosis \
  -H "X-API-Key: YOUR_API_KEY"
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "success": true,
  "data": {
    "code": 1014,
    "cause": "El total enviado no coincide con el que calcula el SIN. El \"esperado X enviado Y\" del mensaje es la fórmula que aplica el SIN para ese sector.",
    "autoHandled": false,
    "fix": { "action": "FIX_AND_RETRY", "instructions": "Recalcular el total con el esperado del SIN (campo expected) y emitir de nuevo." },
    "expected": { "field": "details", "expected": "100.00", "sent": "99.99" },
    "confidence": "MEDIUM",
    "source": "CATALOG",
    "references": ["SIN, Sistema de Facturación (SIAT): lista de mensajes de servicios (sincronizarListaMensajesServicios), código 1014"]
  },
  "timestamp": "2026-11-18T12:00:00.000-04:00"
}
```

| Campo | Descripción |
| - | - |
| `code` | Código del SIN diagnosticado |
| `cause` | Causa en lenguaje llano |
| `autoHandled` | `true`: el motor ya lo resuelve solo (reintento, contingencia, reconciliación) |
| `fix.action` | `NONE`, `WAIT`, `RETRY`, `FIX_AND_RETRY`, `CALL_TOOL`, `CONFIGURE`, `ADMIN_PROCEDURE`, `CONTACT_SUPPORT`, `REVIEW` |
| `fix.tool` / `fix.args` | Con `CALL_TOOL`: la tool MCP y sus argumentos ya resueltos |
| `fix.instructions` | La acción en prosa |
| `expected` | Lo que el SIN dijo que esperaba (`expected`, `sent`), si su mensaje lo trae. `field` es el campo de tu pedido (`clientDocumentNumber`, `details[].priceUnit`); en totales, `details` (los calcula el motor desde las líneas); sin correspondencia, se omite |
| `confidence` | `HIGH`, `MEDIUM`, `LOW` |
| `source` | `CATALOG` (curado), `RULE` (regla sobre el mensaje), `RAG` (normativa), `LLM` (propuesta sin revisar: `fix.action` siempre `REVIEW`) |
| `references` | Sólo fuentes públicas: links `https`, normativa (RND, Ley, D.S.) y siempre el catálogo de mensajes del SIN con el código |

La IA no calcula montos, CUF ni XML: `expected` es lo que escribió el SIN.

## Errores

| HTTP | `error.code` | Causa |
| - | - | - |
| `404` | [`NOT_FOUND`](https://docs.cucu.bo/errors#not_found) | La factura no existe o es de otro tenant |
| `409` | [`CONFLICT`](https://docs.cucu.bo/errors#conflict) | La factura no está `REJECTED` (ej. `PROCESSING`, `VALIDATED`, `OFFLINE_PENDING`): no hay rechazo que diagnosticar |


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