facturador-afip
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FACTURADOR_AFIP_DIR | No | Path to the data directory where credentials, certificates, and invoices are stored. Defaults to ~/.facturador-afip. | ~/.facturador-afip |
| FACTURADOR_CONFIRMACION | No | Ordered list of confirmation methods for invoice emission. Available values: apps, elicitation, permiso, dialogo. Default order: apps,elicitation,permiso,dialogo. | apps,elicitation,permiso,dialogo |
| FACTURADOR_TOTAL_MAXIMO_ARS | No | Optional maximum total amount per invoice in Argentine pesos. If set, emission is blocked above this amount. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| emitir_en_produccionA | EMITE UN COMPROBANTE FISCAL REAL en ARCA producción. No se puede deshacer: solo se anula con una nota de crédito. Llamala únicamente si el usuario aprobó de forma expresa la emisión de ESTE borrador en este momento, con numero, receptor y total exactamente como los devolvió preparar_emision: si no coinciden con los reales, no se emite. Antes de enviar, una persona confirma (tarjeta en el chat, formulario, permiso o diálogo del sistema); si no confirma, no se emite nada. |
| confirmar_emisionB | Solo para la tarjeta de confirmación: emite el borrador con el token de un solo uso y el número tipeado. |
| estado_confirmacionC | Solo para la tarjeta: si la confirmación sigue pendiente (con el resumen y un token para esta apertura), o si se canceló, venció o ya se emitió. |
| cancelar_emisionA | Solo para la tarjeta: cancela la confirmación pendiente. No toca ARCA. |
| estado_configuracionA | Muestra la configuración: carpeta de datos, CUIT, certificados (y cuándo vencen), perfil y cómo se va a pedir la confirmación de emisión. Usala primero si algo falla o si el usuario está configurando. |
| ver_perfilA | Devuelve perfil.json: nombre, puntos de venta de producción, condición frente al IVA, cliente por defecto, formato y reglas de fechas. |
| probar_conexionA | Prueba de solo lectura: estado del servicio, login y puntos de venta. wsfe: A, B y C; wsfex: Factura E. |
| ultimo_comprobanteB | Último número autorizado por ARCA para un tipo de comprobante y punto de venta (por defecto, el del perfil en producción o el primero activo). |
| buscar_codigoA | Busca en las tablas de ARCA: código de país destino, CUIT genérico del país del cliente (uno para personas jurídicas y otro para físicas) o código de moneda. Consulta homologación, que tiene las mismas tablas. |
| listar_comprobantesA | Comprobantes guardados en la carpeta de datos, del más nuevo al más viejo. |
| ver_comprobanteA | JSON completo de un comprobante guardado (campo "factura": los datos originales, para reutilizarlos o para armar una nota de crédito). |
| generar_pdfA | Regenera el PDF de un comprobante guardado, con el diseño de "Comprobantes en línea". No toca ARCA. |
| validar_en_homologacionA | Valida la factura emitiéndola en homologación (sin valor fiscal) y, si ARCA la aprueba sin observaciones,
crea un borrador listo para producción. Llamala solo después de que el usuario confirmó los datos.
|
| preparar_emisionA | Arma la emisión en producción de un borrador SIN emitir: devuelve el número de comprobante, el receptor, el total y la cotización reales, para mostrárselos al usuario antes de pedirle la aprobación. Solo lee de ARCA. |
| listar_borradoresA | Borradores validados en homologación y su estado: validado, emitiendo o emitido. |
| descartar_borradorA | Borra un borrador que no se va a emitir. No afecta nada en ARCA. |
| guia_alta_arcaA | Guía paso a paso del alta en ARCA y tabla de errores. Sin sección, la guía completa. Secciones: introduccion, paso1 (clave y CSR), homologacion (WSASS), produccion_certificado, produccion_autorizacion (Administrador de Relaciones), punto_de_venta, lista_de_control, verificar_y_errores, renovacion. |
| iniciar_configuracionA | Paso 1 del alta: crea la carpeta de datos, guarda el CUIT y los datos del emisor, y genera en esta computadora la clave privada y el pedido de certificado (CSR) de cada entorno. Devuelve los CSR (son públicos) para llevarlos a ARCA; la clave privada nunca se devuelve. Nunca pisa una clave existente. Se puede volver a llamar con el mismo CUIT para completar datos del emisor.
|
| ver_csrA | El CSR de un entorno (texto, ruta del archivo y alias): el de homologación se pega en WSASS; el de producción se sube como archivo en Administración de Certificados Digitales. Es público. |
| guardar_certificadoA | Guarda el certificado que dio ARCA, después de verificar que sea un certificado (no el CSR), del entorno
correcto y que corresponda a la clave de esta carpeta. Homologación: |
| guardar_perfilA | Actualiza perfil.json con los campos que se pasen (el resto queda como está). Campos: nombre (cómo dirigirse a la persona), condicion_iva_emisor ("monotributo" o "responsable_inscripto"), punto_venta_prod (Factura E), punto_venta_prod_comunes (A, B y C; null si no tiene), drive_folder_id, formato {un_solo_item, descripcion, idioma (1 español, 2 inglés), forma_pago}, fechas {emision: "ultimo_dia_mes_trabajado" | "hoy", pago: "primer_dia_habil_mes_siguiente" | "igual_emision"}, cliente_por_defecto {alias, pais_destino, cliente {nombre, cuit_pais, id_impositivo, domicilio}, moneda, notas}. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| configurar | Guía el alta en ARCA y la configuración del facturador, paso a paso. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Confirmar emisión |
TDQS
Scored across 21 tools
Most tools map to a distinct resource/action, and the descriptions carefully fence off the confirmation-card tools. However, estado_configuracion and ver_perfil overlap on profile/config data, and both emitir_en_produccion and confirmar_emision trigger emission, so an agent could misselect without reading closely.
The set overwhelmingly follows a Spanish snake_case verb_noun pattern (ver_perfil, guardar_certificado, listar_borradores). A few noun-led exceptions (estado_confirmacion, estado_configuracion, ultimo_comprobante, guia_alta_arca) are noticeable but do not make the scheme unpredictable.
21 tools is within the 16–25 range that feels heavy for an agent surface. Most tools earn their place given the complex AFIP setup/emission workflow, but three confirmation-card-only tools (confirmar_emision, estado_confirmacion, cancelar_emision) are implementation details that could probably be folded into fewer tools.
The server covers the full lifecycle: onboarding/certificates, profile/config, homologation validation, production emission, saved comprobantes, PDF generation, and draft management. The main gap is that cancellation is only mentioned as a credit-note workflow rather than exposed as a first-class tool, though existing tools can likely support it via the factura object.