Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FACTURADOR_AFIP_DIRNoPath to the data directory where credentials, certificates, and invoices are stored. Defaults to ~/.facturador-afip.~/.facturador-afip
FACTURADOR_CONFIRMACIONNoOrdered 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_ARSNoOptional 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

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

Tools

Functions exposed to the LLM to take actions

NameDescription
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. buscar filtra por texto (nombre del cliente, archivo, fecha).

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. factura tiene el formato descripto en las instrucciones del servidor. punto_venta_homo sirve para esquivar el error de fechas de pruebas anteriores.

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.

  • nombre: nombre o razón social, como figura en ARCA.

  • alias: nombre del certificado, solo letras y números (ej. facturador1a2b3c).

  • condicion_iva: como va impresa en el PDF (ej. "Responsable Monotributo", "IVA Responsable Inscripto").

  • ingresos_brutos: número o "Exento". inicio_actividades: AAAA-MM-DD.

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: certificado con el texto que muestra WSASS (desde -----BEGIN CERTIFICATE-----). Producción: ruta al .crt descargado (ej. ~/Downloads/xxx.crt).

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

NameDescription
configurarGuía el alta en ARCA y la configuración del facturador, paso a paso.

Resources

Contextual data attached and managed by the client

NameDescription
Confirmar emisión

TDQS

B3.4/5.0

Scored across 21 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count3/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues