Claves de acceso para tus sistemas

Las claves de acceso (también se las llama claves de API) conectan tus sistemas con Giftali sin que nadie inicie sesión: tu caja, tu tienda online o el programa con el que llevás tu comercio. Se manejan en Desarrolladores, dentro de Configuración.

Una cadena de cafeterías quiere que su sistema de caja consulte sus ventas en Giftali todas las noches. Su Administrador crea una clave llamada «Caja», la copia y se la pasa a quien programa el sistema. Desde ahí, la caja entra con esa clave, sin usuario ni contraseña de nadie.

Si no tenés un sistema propio que se conecte con Giftali, no necesitás claves: todo lo hacés desde el portal.

Quién puede crearlas

• Tu comercio tiene que tenerlas habilitadas. Giftali las habilita comercio por comercio. Mientras no estén habilitadas para el tuyo, Desarrolladores no aparece en el menú. Si las necesitás, escribinos.
• Solo el Administrador ve Desarrolladores y crea, renueva y elimina las claves. → Quién puede hacer qué

Para entrar, en el menú andá a Sistema → Desarrolladores, o a Sistema → Configuración y tocá Desarrolladores.

Crear una clave

1. En Desarrolladores, tocá Crear clave.
2. Ponele un nombre que diga qué sistema la usa (por ejemplo, «Caja del local Centro»). Usá una clave distinta para cada sistema: así, si tenés que cortar una, los demás siguen andando.
3. Tocá Crear.
4. Aparece Tu clave secreta. Tocá Copiar y pasásela a quien configura tu sistema. Después tocá Lo guardé.

La clave secreta se ve una sola vez

Después de cerrar ese aviso no la vas a poder ver de nuevo: en la lista queda solo el prefijo, el comienzo de la clave, para que la reconozcas. Si la perdiste, renovala. Tratala como una contraseña: no la mandes por chat ni la pegues en lugares públicos.

En la lista de claves ves, para cada una, el nombre, el prefijo, el último uso, cuándo vence y cuándo se creó. Las que creás desde el portal no vencen: dicen Sin vencimiento.

Qué puede hacer una clave

Una clave tiene permisos de dos tipos:

• Lectura: consultar, por ejemplo tus ventas, tus productos o tus códigos, pedir una planilla y validar un código antes de canjearlo.
• Escritura: además, canjear códigos y crear, cambiar y borrar.

Las claves que creás desde el portal tienen los dos.

Una clave nunca puede más que quien la creó. Funciona con el rol que esa persona tiene hoy en tu comercio, no con el que tenía cuando la creó: si le cambiás el rol, la clave pasa a poder lo mismo que el rol nuevo. → Cambiar el rol de alguien

Lo que una clave no puede hacer

Manejar las claves y tu equipo pide sesión iniciada: hay que entrar al portal con tu usuario. Con una clave no se puede crear, renovar ni eliminar claves, ni invitar a alguien, cambiarle el rol o sacarlo del equipo. Así, si una clave se filtra, no sirve para crear otra ni para sumar gente a tu cuenta.

Renovar una clave

Renová una clave cuando creas que se filtró o cuando la persona que la creó deja tu equipo.

1. En la fila de la clave, tocá el ícono de las dos flechas en círculo (Renovar).
2. Confirmá con Renovar. La clave actual deja de funcionar en ese momento.
3. Copiá la clave secreta nueva, como al crearla, y cambiala en tu sistema.

La clave nueva tiene el mismo nombre y los mismos permisos, y queda a nombre de quien la renueva: desde ahí funciona con tu rol.

Una clave Vencida no se renueva: eliminala y creá otra si la necesitás.

Eliminar una clave

En la fila de la clave, tocá el ícono del tacho (Eliminar) y confirmá. Deja de funcionar enseguida y no se puede recuperar.

Si Giftali deja de tener habilitadas las claves para tu comercio y te queda alguna sin vencer, igual podés ver y eliminar las que tenés. Lo que no podés es crear ni renovar. Si ya vencieron todas, Desarrolladores deja de aparecer: una clave vencida no deja entrar a ningún sistema.

Cuando alguien deja tu equipo

Si sacás a alguien del equipo, o si deja de tener acceso a tu comercio por otro camino (por ejemplo, porque se lo quitó Giftali), las claves que creó se revocan: dejan de funcionar y desaparecen de la lista. No vuelven aunque esa persona vuelva a tu comercio: si las necesitás, creá otras. → Sacar a alguien

La lista de claves no dice quién creó cada una. Antes de sacar a alguien que pudo haber creado claves que tus sistemas usan, renovalas vos: pasan a tu nombre y siguen andando cuando esa persona se vaya, y solo tenés que cambiar la clave en tu sistema.

Si una clave dice que no funciona

Si en una clave ves No funciona: quien la creó ya no tiene acceso a tu comercio., la persona que la creó ya no está en tu equipo y la clave no deja entrar a tu sistema. Puede pasar con claves más viejas, de antes de que se revocaran solas, o si el usuario de quien la creó ya no existe. Tenés dos opciones:

• Renovarla, si tu comercio tiene las claves habilitadas: pasa a tu nombre y vuelve a funcionar con la clave secreta nueva.
• Eliminarla, si ya no la usa ningún sistema.