consultarPadron
Mismo contrato queGET /api/v3/padron/{tipo}/{numero}. Solo por número exacto.
Salida (JSON, el mismo de REST): para NIT, razón social oficial del Registro Nacional de Contribuyentes (
oficial: true) y estado (ACTIVO, VIGENTE…); para CI, el nombre más completo conocido; para un CI sin complemento con homónimos, candidatos para elegir. Error: texto con el motivo si el documento es inválido.
verificarFormatoNit
Salida (textos exactos):
NIT con formato valido: <nit> · NIT valido: Consumidor Final (Sin Nombre) (para 0) · NIT vacio o nulo · El NIT solo debe contener numeros. NIT ingresado: <nit> · Longitud de NIT invalida. Debe tener entre 7 y 15 digitos. Longitud actual: <n>.
consultarDatosNit
Consulta el portal público del SIAT.
Salida (texto):
NIT <nit>: con - Grupo, - Modalidad: <nombre> (codigo 1|2) (1 Electrónica en Línea, 2 Computarizada en Línea), - Fecha adecuacion, - Razon social (o no se pudo obtener del SIN, solicitarla al cliente). Si el portal no responde: Modalidad no disponible: <motivo>. Cargar la modalidad manualmente.
historialCliente
Salida (texto): razón social, email, teléfono y cantidad de facturas emitidas por tu empresa a ese NIT. Error:
Error obteniendo historial: <mensaje>.
buscarNormativa
Salida (texto): fragmentos relevantes de la normativa SIAT indexada (RAG) para el ambiente.
erroresComunesSiat
Sin parámetros. Salida (texto fijo): códigos99999 (CUFD expirado), 90009 (servicio no disponible: abrir evento y facturar offline), 1001 (NIT no válido), 1002 (actividad económica no registrada), 1003 (factura duplicada), 1004 (CUIS inválido o expirado), cada uno con su solución. Para el catálogo completo, Errores.
buscarContingencias
Salida (texto): eventos significativos finalizados de tu empresa que coinciden con la consulta (caídas, duración, POS afectados). Nunca incluye contingencias de otros tenants.
calcularMontoLiteral
Salida (texto): p. ej.
150.50 → Ciento Cincuenta 50/100 Bolivianos. crearFactura ya lo calcula (amountLiteral).