Para sistemas internos

El agente conector

El agente es un programa pequeño que instalas donde haga falta —tu ordenador, uno de la oficina, un servidor— para que BrucTicket entregue tus gastos a sistemas que la nube no puede tocar: el ERP de la empresa, una intranet, una carpeta compartida. También puede traer de ellos lo que la app necesita, como la lista de clientes o de tipos de gasto.

Las contraseñas y rutas de esos sistemas viven solo en la configuración del agente. La app nunca las ve, no las guarda y no las puede cambiar.

Cómo funciona

En la app, en Ajustes → Agentes y destinos → Conectar un agente, sale un código de emparejamiento (un solo uso, 15 minutos).
Lo escribes en la app de escritorio del agente (o, en un servidor, en la orden que se copia). Queda emparejado con tu cuenta.
El agente avisa de los conectores que tiene. En la app creas un destino con uno de ellos (por ejemplo, «carpeta de la gestoría») y decides si los gastos salen solos o con un botón.
El agente pregunta cada poco si hay gastos para él, los entrega y devuelve el resultado: enviado (con su referencia en tu sistema) o el motivo del error. Si se corta la red, reintenta solo.

El agente es quien llama a la app, nunca al revés: no hace falta abrir puertos ni exponer nada de tu red.

Instalarlo

Lo instala quien lleve los sistemas de la oficina, en un minuto. Si no es tu caso, pásale esta página.

App de escritorio para Windows y Linux

La forma más sencilla: se instala como cualquier otra aplicación, se queda en la bandeja del sistema y arranca sola al encender el ordenador. Al abrirla por primera vez te pide el código; desde ella activas los conectores, pruebas cada uno y ves lo último que ha hecho.

Si un sistema solo se usa desde la web con tu cuenta, la app tiene su propio navegador: entras una vez con la ventana a la vista (la contraseña y la verificación las pones tú) y después trabaja sola, sin ventana. Si la sesión caduca, te avisa.

Sistema	Formato	Descarga
Windows	Instalador (.exe)	Próximamente
Linux	AppImage (cualquier distribución)	Próximamente
Linux	Paquete .deb (Ubuntu, Debian…)	Próximamente

Windows 10 u 11 (usa Microsoft Edge, que ya viene instalado) o Linux de 64 bits con Chrome, Chromium o Edge.

En un servidor, con la línea de órdenes (para desarrolladores)

Necesita Node.js 20 o superior y no tiene más dependencias.

Con npx

npx bructicket-agent pair --server https://ticket.bruc.app --code ABCD-EFGH --name oficina
npx bructicket-agent run

Con Docker

docker build -t bructicket-agent .
docker run --rm -it -v bta-config:/config bructicket-agent pair --server https://ticket.bruc.app --code ABCD-EFGH --name docker
docker run -d --restart unless-stopped --name bructicket-agent -v bta-config:/config bructicket-agent

Como servicio o con cron

El paquete trae una unidad de systemd de ejemplo. Si prefieres cron, basta con una vuelta cada pocos minutos: */5 * * * * npx bructicket-agent once.

Mientras el paquete no esté publicado en npmPídenos la carpeta del agente y ejecútalo con node bin/bructicket-agent.mjs … en lugar de npx bructicket-agent ….

Órdenes

Orden	Qué hace
`pair`	Empareja el agente con tu cuenta y guarda la conexión.
`run`	Se queda trabajando: recoge los gastos, los entrega y devuelve el resultado.
`once`	Una sola vuelta (para cron).
`connectors`	Lista los conectores, si están listos y dónde se pone cada opción.
`test <destino>`	Prueba la conexión de un destino desde ese equipo.
`status`	Enseña la configuración (con la clave tapada) y si conecta con la app.
`set <conector> clave=valor`	Guarda opciones locales de un conector: contraseñas, rutas, modo.
`connect <conector>`	Abre el navegador del agente para iniciar sesión en un sistema web.
`extract <conector> <tipo> --send`	Trae de tu sistema clientes o categorías y los sube a la app para relacionarlos.

Conectores incluidos

Carpeta: deja cada gasto como un archivo con su justificante en una carpeta (por ejemplo, una carpeta sincronizada con la gestoría), ordenado por meses.
CSV: añade una fila por gasto a un CSV mensual, listo para importar en tu programa de contabilidad.
Webhook: envía cada gasto en JSON a la dirección que digas, firmado para que tu sistema compruebe que viene de tu agente. No duplica envíos.

Para un ERP o una intranet propia se escribe un conector a medida: es un archivo pequeño que sabe entregar el gasto en tu sistema y, si quieres, traer de él clientes y categorías. Se añade al agente desde una carpeta, sin reinstalar nada. Si lo necesitas, escríbenos a soporte@bruc.app.

Seguridad

Cada opción de un conector es de uno de tres tipos: en la app (como la carpeta o la dirección del webhook), local o secreta. Las locales y las secretas solo existen en el equipo del agente.
La configuración se guarda con permisos solo para el usuario que lo ejecuta, y la clave del agente solo se guarda en la app como huella.
El agente solo puede descargar los justificantes de los gastos que tiene asignados en ese momento.
Desde la app puedes desconectar un agente cuando quieras: su clave deja de valer al instante y él se detiene.
El registro del agente no muestra secretos: las claves salen tapadas.

¿Dudas? Mira el soporte o la política de privacidad.