Diagnóstico de rechazos
curl --request GET \
--url https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosisimport requests
url = "https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyDiagnóstico de rechazos
GET /api/v3/invoices//diagnosis: por qué el SIN rechazó una factura o nota y qué hacer, con acción tipada.
GET
/
api
/
v3
/
invoices
/
{id}
/
diagnosis
Diagnóstico de rechazos
curl --request GET \
--url https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosisimport requests
url = "https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.cucu.bo/api/v3/invoices/{id}/diagnosis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyPor qué el SIN rechazó un documento y qué hacer. Tool MCP gemela:
La IA no calcula montos, CUF ni XML:
diagnosticarRechazo.
El mismo bloque diagnosis ya viene, sin pedirlo, en la factura o nota REJECTED (incluida la respuesta
422 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.
curl https://sandbox.cucu.bo/api/v3/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/diagnosis \
-H "X-API-Key: YOUR_API_KEY"
{
"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 |
expected es lo que escribió el SIN.