Skip to main content

​
Facturar desde tu agente de IA

Facturear se usa también desde el chat. Lo conectás una vez a Claude, ChatGPT, Cursor o cualquier agente compatible con MCP (Model Context Protocol) y después le pedís cosas como:
  • “Dame de alta el CUIT 20-12345678-9 y configuralo en ARCA”
  • “Haceme una factura C de $85.000 a Juan Pérez, DNI 30123456, por el servicio de septiembre”
  • “¿Cuántas facturas emití este mes y cuánto me queda del plan?”
No hace falta tener cuenta de antemano: si no tenés, la creás en el mismo paso en que conectás el agente.
URL del conector: https://www.facture.ar/api/mcp

​
La forma rápida: pegale esto a tu agente

Copiá este mensaje y pegalo en el chat de tu agente (también está, con el botón Copiar mensaje, en Configuración → Agentes IA dentro del panel):
Un agente con terminal (Claude Code, Codex CLI, Cursor) lee facture.ar/llms.txt y se conecta solo. Claude y ChatGPT no pueden agregar conectores desde el chat, pero te dicen exactamente qué tocar en su app. Si preferís hacerlo a mano, los pasos están abajo.

​
Cómo funciona el login

No le das tu contraseña ni tu API Key al agente. La conexión usa OAuth, el mismo mecanismo que “Iniciar sesión con Google”:
1

Agregás Facturear como conector

Pegás la URL del conector en tu agente (los pasos para cada uno están abajo).
2

El agente te manda a Facturear

Se abre facture.ar en tu navegador. Entrás con Google o con un link a tu email. Si no tenías cuenta, se crea en ese momento, con el plan Free.
3

Aprobás el acceso

Facturear te muestra qué agente pide acceso y qué va a poder hacer. Tocás Permitir y volvés al chat.
Podés ver y desconectar los agentes conectados cuando quieras desde Configuración → Agentes IA en el panel.

​
Conectarlo, paso a paso

Funciona en claude.ai, Claude Desktop y Cowork, en cualquier plan (el plan gratuito admite un conector personalizado).
1

Abrí los conectores

Andá a Personalizar → Conectores (Customize → Connectors).
2

Agregá uno personalizado

Tocá + y elegí Agregar conector personalizado (Add custom connector).
3

Pegá la URL

Nombre: Facturear. URL: https://www.facture.ar/api/mcp. No completes Client ID ni Client Secret: no hacen falta.
4

Conectá

Tocá Conectar, iniciá sesión en Facturear y aprobá el acceso.
En planes Team o Enterprise, primero un Owner agrega el conector en Configuración de la organización → Conectores, y después cada persona lo conecta con su cuenta.

​
Tu clave fiscal nunca pasa por el chat

Para configurar un CUIT, Facturear hace por vos los trámites en ARCA (certificados, autorización del web service y punto de venta) y para eso necesita tu clave fiscal. Esa clave no se escribe en el chat:
  1. Le pedís al agente que configure tu CUIT.
  2. El agente te da un link de un solo uso a una página de Facturear.
  3. Escribís la clave ahí. Va directo a Facturear, cifrada; el agente y el modelo de IA nunca la ven.
  4. El agente sigue el progreso y te avisa cuando el CUIT está listo para facturar.
El link vence a los 30 minutos y sirve una sola vez. Si usás un agente en la terminal, también te puede dar un comando que pide la clave sin mostrarla en pantalla y la envía directo a Facturear.
Si por error escribiste tu clave fiscal en un chat, cambiala desde el sitio de ARCA. Facturear nunca te la va a pedir por chat.

​
Qué puede hacer el agente

create_invoice, list_invoices y propose_invoice reciben environment (homologation o production). Con login OAuth el agente lo tiene que indicar en cada llamada; con una API Key lo fija la key y no puede pedir el otro entorno. create_invoice acepta además idempotency_key: el agente manda un UUID nuevo por factura y, si la llamada falla por red o timeout, la repite con la misma clave; Facturear devuelve la emisión original en vez de emitir otra. propose_invoice cumple la misma función con externalId. Ver Reintentar sin duplicar facturas.
Probá primero en homologación: el agente emite facturas de prueba, sin valor fiscal. En producción, el agente te confirma importe, receptor y tipo de comprobante antes de emitir.

​
Preguntas frecuentes

En Claude no: el plan gratuito admite un conector personalizado. En ChatGPT sí: los conectores propios requieren Plus, Pro, Business, Enterprise o Edu, con el modo desarrollador activado.
Tus CUITs, tu plan y uso, y tus facturas. Nunca tu clave fiscal ni las claves privadas de tus certificados.
Desde el panel, en Configuración → Agentes IA, tocá Desconectar en Agentes conectados. El agente pierde el acceso en su próxima llamada. También podés quitarlo desde la configuración de conectores de tu agente.
Revisá que la URL sea exactamente https://www.facture.ar/api/mcp (con www) y que no hayas cargado un Client ID o Client Secret. Si sigue fallando, escribinos desde el chat de soporte del panel.