Aplicaciones conectadas y desarrolladores

Deja que otra app que usas —por ejemplo, tu programa de contabilidad— trabaje con tus gastos de AI Budget, mira exactamente qué puede hacer y córtale el acceso con un toque. Los desarrolladores pueden crear estas apps sobre la API de AI Budget.

Qué significa conectar una app

Algunos productos pueden trabajar con tus datos de AI Budget desde sus propias pantallas: una app de contabilidad puede recoger tus gastos y tickets, o añadir gastos por ti. Para permitirlo, conectas la app a una o varias de tus cuentas de AI Budget.

La app nunca ve tu contraseña. Cuando pulsas su botón «Conectar AI Budget», te lleva a una página de AI Budget donde inicias sesión como siempre y ves:

• el nombre de la app, su web y quién la ha creado;
• Verificada por AI Budget (una app que hemos revisado, como la nuestra) o No verificada por AI Budget;
• la lista de permisos que pide la app;
• Cuentas que se conectarán: una casilla por cada cuenta. Marca cada cuenta que la app puede usar; Permitir sigue desactivado hasta que marques al menos una. Si solo se puede conectar una cuenta, ya viene marcada. Las cuentas que solo puedes ver o que usan cifrado completo aparecen en gris con el motivo, y una cuenta con cifrado de texto se marca como solo lectura.

Pulsa Permitir para conectarla o Denegar para volver a la app sin conectar nada. Permite solo apps de confianza.

Conectar la app otra vez. Si la app ya está conectada, la pantalla se abre con las cuentas que ya tiene marcadas, junto con cualquier otra cuenta que aún se pueda conectar. Lo que marques es la lista completa: marca una cuenta nueva para añadirla o desmarca una para cortar el acceso de la app a ella. El acceso a las cuentas que dejas marcadas sigue funcionando sin interrupción.

Cuando una app tiene varias cuentas, nos indica en cada petición a cuál se refiere; tú no tienes que hacer nada.

Qué permite cada permiso

• Ver tus gastos: importes, fechas, categorías, artículos y etiquetas: la app puede leer los gastos de la cuenta conectada, incluidos los artículos de un ticket y los cambios y eliminaciones posteriores.
• Añadir, modificar y eliminar gastos: la app puede escribir en esa cuenta. Los gastos que añade muestran Añadido a través de y el nombre de la app en la pantalla del gasto.
• Descargar las fotos de tus tickets: la app puede descargar la imagen o el PDF del ticket adjunto a un gasto.
• Ver tus categorías de gastos: la app puede leer tu lista de categorías para clasificar bien los gastos nuevos.
• Ver y añadir tus ingresos — la app puede leer los ingresos de la cuenta conectada y, con el permiso de escritura, añadir, modificar y eliminar ingresos. Los ingresos que añade muestran Añadido a través de y el nombre de la app. Los ingresos creados por una transferencia entre tus cuentas son de solo lectura.
• Ver y gestionar tus presupuestos — la app puede leer tus presupuestos con el avance del periodo actual y, con el permiso de escritura, crearlos, modificarlos y eliminarlos.
• Ver los totales de tus ingresos y gastos — la app puede leer resúmenes: totales por categoría y por mes. Recibe esos totales, no los movimientos individuales, y las cifras se convierten a tu moneda de visualización.

Toda app conectada ve además el nombre, el tipo y la moneda de las cuentas que marcaste, y tu nombre. Nunca recibe tu dirección de correo y no puede ver ninguna cuenta que no hayas marcado.

Ver y desconectar apps

Abre Ajustes → Aplicaciones conectadas. Cada app es una fila con las cuentas a las que está conectada, quién la conectó y cuándo, cuándo se usó por última vez y sus permisos.

Para cortar una sola cuenta, pulsa Quitar cuenta junto a ella y confirma. La app pierde esa cuenta al instante (su siguiente petición para ella se rechaza) y sus otras cuentas siguen funcionando. Si quitas la última cuenta, la app queda desconectada por completo.

Para cortar toda la app, pulsa Desconectar y confirma. Pierde el acceso a todas sus cuentas a la vez. Los gastos que ya añadió se quedan en tus cuentas. Para volver a usarla, conéctala de nuevo desde la app.

Cada vez que se conecta una app o recibe cuentas nuevas, enviamos un correo a la persona que lo hizo, con la lista de las cuentas añadidas. Si recibes uno y no reconoces la app, desconéctala enseguida.

Si no ves Aplicaciones conectadas en Ajustes, la conexión de apps todavía no está disponible.

Cuentas compartidas

Solo un propietario o un editor de una cuenta puede conectarle una app; quien solo puede ver la cuenta la verá desactivada.

Una app conectada a una cuenta compartida ve los gastos de todos sus miembros, no solo los de quien la conectó. Por eso todos los propietarios y editores de esa cuenta ven la app en Aplicaciones conectadas, con quién la conectó, y pueden quitarla de esa cuenta.

De una conexión solo ves las cuentas que tú mismo posees o editas, nunca las demás cuentas que eligió quien la conectó. Si pulsas Desconectar, la app pierde solo esas cuentas tuyas; sigue conectada para quien la configuró, y solo esa persona puede desconectarla por completo. Cuando un editor conecta una app, los propietarios de las cuentas conectadas también reciben un correo, con únicamente sus propias cuentas.

Si la persona que conectó la app pasa después a solo lectura o sale de una cuenta, la app deja de funcionar para esa cuenta; sus otras cuentas no se ven afectadas. Una cuenta eliminada se quita de la app automáticamente.

Cuentas cifradas

• Una cuenta con cifrado completo (también los importes) no se puede conectar: la app no podría leer nada.
• Una cuenta con cifrado de texto se puede conectar solo en lectura: la app ve importes, fechas y categorías, pero las descripciones, notas, comercios, nombres de artículos, etiquetas y demás texto cifrado quedan ocultos, y no puede añadir ni modificar gastos.

Qué cubre cada nivel se explica en Cifrado de extremo a extremo.

Para desarrolladores

Puedes crear tu propia app sobre la API de AI Budget, gratis. Abre Ajustes → Desarrolladores y pulsa Crear app: ponle un nombre, una web y las direcciones de redirección que usará, y elige App de servidor o App móvil o de navegador. El Client ID lo recibes al momento; una app de servidor recibe además un client secret que se muestra una sola vez: cópialo enseguida.

La referencia completa de la API y una guía paso a paso (en inglés, polaco y ruso) están en api.ai-budget.pl/public/docs, también enlazadas desde Documentación de la API en la pantalla de desarrolladores. Puedes registrar hasta 10 apps.