Skip to main content
Glama
Auditor DIAN

Auditor DIAN

by RafaGM1108

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AUDITOR_DIAN_HOMENoCarpeta donde viven las bases de datos de los clientes. Por defecto es `~/.auditor-dian/`.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Carga y consulta las facturas electrónicas DIAN que recibió cada cliente. Para cargar: crear_cliente (una vez) e ingerir_facturas con la ruta de un ZIP, XML o carpeta; si la carpeta trae facturas de varios clientes, o el usuario no dice dónde están, ingerir_por_cliente las reparte (sin ruta revisa Descargas). Para saber si un cliente ya está registrado: listar_clientes con buscar; historial_cliente dice qué meses tiene cargados. Si algo falla o una cifra no cuadra, diagnostico resume el estado para reportarlo. Las cifras ya vienen calculadas: cítelas tal cual con sus CUFE, sin sumarlas ni redondearlas. Los montos son texto decimal exacto en la moneda de cada documento. Fechas en formato AAAA-MM-DD; los rangos son inclusivos y por fecha de emisión. El usuario puede no tener conocimientos técnicos: pídale la carpeta por su nombre (por ejemplo 'facturas-enero, en Descargas'), no una ruta; pase el NIT o la cédula tal como lo escribió, el servidor lo interpreta; responda en lenguaje sencillo, sin mencionar herramientas, JSON ni códigos internos salvo que lo pida. Diga siempre al usuario: Cifras calculadas a partir de los documentos cargados. Requiere revisión del contador.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
listar_clientesA

Lista los clientes registrados en este equipo (NIT o cédula y nombre), o busca uno.

Úsela cuando el usuario pregunte, por ejemplo:

  • "¿Ya tengo registrada a Panadería La Espiga?"

  • "¿Qué clientes tengo?"

  • Antes de cualquier consulta en la que el usuario nombre al cliente por su razón social y no por su NIT, para obtener el NIT.

Para ver qué meses tiene cargados un cliente use historial_cliente.

historial_clienteA

Ficha de un cliente registrado: nombre, fecha de registro, cuántos documentos tiene por tipo y por mes de emisión, primera y última fecha de emisión, y cada día en que se cargaron facturas con sus archivos, documentos y errores.

Úsela cuando el usuario pregunte, por ejemplo:

  • "¿Qué tengo cargado de Panadería La Espiga?"

  • "¿Me faltan meses de este cliente?" / "¿Hasta qué fecha tengo facturas?"

  • "¿Cuándo cargué las facturas de marzo?"

No trae montos: para cifras use resumen_periodo.

buscar_documentosA

Busca facturas y notas que recibió el cliente, combinando filtros: proveedor, fechas, valor, tipo de documento, CUFE o medio de pago.

Úsela cuando el usuario pida documentos puntuales, por ejemplo:

  • "Muéstrame las facturas de Claro de este año"

  • "¿Qué facturas de más de 5 millones llegaron en marzo?"

  • "Busca la factura con este CUFE" / "¿Cuáles pagué con tarjeta de crédito?"

No la use para totales de IVA, compras o retenciones (use resumen_periodo): aquí no se suma. Devuelve hasta 200 documentos y cuántos coinciden en total; si son más, pida acotar.

resumen_periodoA

Totales del periodo con los CUFE que los respaldan: compras (total y por tipo de documento), IVA (total y por tarifa) y retenciones por tipo. Las notas crédito y de ajuste restan.

Úsela cuando el usuario pregunte cifras, por ejemplo:

  • "¿Cuánto IVA en compras hubo en el bimestre 1?"

  • "¿Qué retenciones traen las facturas del primer semestre?"

  • "¿Cuánto compró en 2025?"

Es el IVA que figura en los documentos, no una determinación de IVA descontable. Las retenciones de facturas y documentos soporte son autorretenciones que declara el emisor (Anexo FE 1.9, FAT01): no diga que se las practicaron al cliente ni que el cliente las practicó. Cite las cifras tal cual vienen, sin sumarlas ni redondearlas.

facturas_creditoA

Facturas recibidas con forma de pago a crédito en el periodo, con proveedor, valor y vencimiento.

Úsela cuando el usuario pregunte, por ejemplo:

  • "¿Qué facturas a crédito llegaron en marzo?"

  • "¿Qué le debo a proveedores?" (solo lo que dicen las facturas, no si ya se pagó)

Los eventos (acuse, aceptación, endoso) quedan "por verificar": este servidor no consulta a la DIAN.

duplicados_y_anulacionesA

Facturas del mismo proveedor y número con distinto CUFE (posibles duplicados) y facturas anuladas total o parcialmente por notas crédito (tolerancia de 2 pesos).

Úsela cuando el usuario pregunte, por ejemplo:

  • "¿Hay facturas repetidas?"

  • "¿Qué facturas me anularon con nota crédito?"

  • Antes de cerrar un periodo, para revisar que no se cuente dos veces una compra.

exportar_informeA

Guarda un informe del periodo en un Excel nuevo, con una hoja de resumen y otra de detalle con los CUFE.

Úsela cuando el usuario pida, por ejemplo:

  • "Exporta las retenciones del primer semestre a Excel"

  • "Pásame a un Excel las compras por proveedor de 2025, en el escritorio"

Nunca sobrescribe: si el archivo ya existe, proponga otro nombre. Devuelve dónde quedó.

crear_clienteA

Registra un cliente nuevo en este equipo para poder cargar y consultar sus facturas.

Úsela cuando el usuario diga, por ejemplo:

  • "Crea el cliente 900.000.009-9, Mi Cliente SAS"

  • "Sí, créalos" después de que ingerir_por_cliente informe compradores sin cliente: use el NIT y el nombre que esa herramienta devolvió.

Si el cliente ya existe no cambia nada y devuelve su historial (creado: false). Si otro cliente tiene el mismo nombre con otro NIT, lo avisa: puede ser un NIT mal escrito y conviene confirmarlo con el usuario.

ingerir_facturasA

Carga en un cliente las facturas electrónicas de un ZIP o XML (como llegan por correo) o de una carpeta completa.

Úsela cuando el usuario diga a qué cliente van, por ejemplo:

  • "Carga las facturas de la carpeta 'facturas enero' para Mi Cliente SAS"

Si no dice de qué cliente son, o la carpeta trae facturas de varios clientes, use ingerir_por_cliente. Solo agrega: lo ya cargado se salta y nada se duplica. Devuelve cuántos archivos y documentos entraron y los errores de lectura.

ingerir_por_clienteA

Carga facturas de varios clientes a la vez: cada archivo va al cliente que aparece como comprador en la factura.

Úsela cuando el usuario diga, por ejemplo:

  • "Carga mis facturas" / "Ya descargué las facturas, cárgalas" (sin ruta)

  • "Reparte por cliente las facturas de la carpeta 'correo noviembre'"

Solo carga en clientes ya registrados. clientes_no_creados trae el NIT y el nombre de los compradores sin registrar: muéstreselos al usuario, pregunte si los crea (crear_cliente) y vuelva a llamar; lo ya cargado no se duplica. sin_asignar lista archivos que no son facturas legibles o traen varios compradores, con el motivo.

diagnosticoA

Estado de la instalación para reportar un problema: versión, carpeta de datos, plugins y, por cliente, documentos, archivos cargados, última carga y advertencias de lectura (las últimas 20). No incluye montos ni contenido de las facturas, así que se puede compartir.

Úsela cuando el usuario diga, por ejemplo:

  • "Algo no funciona" / "No me cargó una factura" / "Una cifra no me cuadra"

  • "Dame el diagnóstico de Auditor DIAN"

Explique en palabras sencillas lo que encuentre y, si hay que reportarlo, entréguele el resultado completo para que lo copie.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 11 tools

Disambiguation4/5

Descriptions actively cross-reference each other (listar_clientes → historial_cliente → resumen_periodo; ingerir_facturas ↔ ingerir_por_cliente), making boundaries unusually clear. Minor residual overlap: facturas_credito partly duplicates buscar_documentos' payment-method/CUFE filtering, and buscar_documentos vs resumen_periodo could still be confused by an inattentive agent, though both are explicitly disclaimed.

Naming Consistency3/5

Half the tools use a verb_noun pattern (listar_clientes, buscar_documentos, crear_cliente, ingerir_facturas, exportar_informe) while the other half are bare nouns (historial_cliente, resumen_periodo, diagnostico, facturas_credito, duplicados_y_anulaciones). All names are readable and domain-meaningful, but the convention is genuinely mixed rather than uniform.

Tool Count5/5

Eleven tools for a Colombian e-invoicing audit domain is well within the 3-15 sweet spot, and each maps to a distinct user intent (list, inspect, search, total, diagnose, credit, dedupe, export, create client, ingest two ways). No obvious filler or redundant tool.

Completeness4/5

Covers the full read/ingest/export lifecycle including client creation, batch ingestion with unregistered-buyer resolution, period totals, and duplicate/annulment checking. Notable gap: there is no way to delete, re-load, or correct an already-ingested document or client — a real dead end when ingestion goes wrong — and no single-document detail view beyond search results.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues