ROKI Connect para Google Sheets
===============================

Cobrar la misma lista todos los meses sin crear los enlaces uno por uno.

Para colegios que cobran matriculas, clinicas que cobran saldos, gimnasios que cobran
mensualidades, y cualquiera que le pase la misma lista de gente a fin de mes.


COMO SE INSTALA
---------------

1. Abri una hoja de calculo nueva en Google Sheets.

2. Anda a Extensiones > Apps Script. Se abre el editor.

3. Borra lo que haya en el editor y pega todo el contenido de Codigo.gs.

4. Guarda con el disquete, ponele un nombre al proyecto, y volve a la hoja.

5. Recarga la hoja. Arriba, al lado de "Ayuda", aparece un menu nuevo: ROKI.

6. Menu ROKI > "1. Configurar mi llave". Pega tu llave secreta.
   Empieza con sk_test_ para probar y con sk_live_ para cobrar de verdad.

7. Menu ROKI > "2. Preparar esta hoja". Te arma las columnas.

La primera vez Google te va a pedir permiso para que el script conecte con ROKI y edite tu hoja.
Es tu propio script en tu propia cuenta: el permiso es para vos mismo.


COMO SE USA
-----------

Llena estas cuatro columnas:

    Nombre        Telefono       Concepto           Monto
    Ana Lopez     50499998888    Matricula marzo    1500
    Luis Perez    50488887777    Matricula marzo    1500

Menu ROKI > "Crear los enlaces". Cada fila queda con su enlace de pago y con el mensaje de
WhatsApp ya redactado, listo para copiar y mandar.

Menu ROKI > "Actualizar estados". Las filas pagadas se pintan de verde y se llena la fecha.

Menu ROKI > "Resumen del dia". Cuanto se cobro y cuanto falta.


LO QUE CONVIENE SABER
---------------------

Apretar "Crear los enlaces" dos veces no duplica nada. Las filas que ya tienen enlace se saltan, y
ademas se manda una llave de idempotencia armada con el mes: dentro del mismo mes, la misma fila
devuelve el mismo enlace.

Si tu lista es larga, puede que al terminar te diga que se detuvo antes de llegar al final. Google
no deja que un script corra mas de seis minutos seguidos, sea de quien sea. No perdiste nada:
apreta "Crear los enlaces" otra vez y sigue donde quedo, tantas veces como haga falta.

El mes que viene si crea enlaces nuevos, porque el periodo cambia. Borra la columna "Enlace de
pago" antes de volver a correrlo.

La llave secreta NO vive en una celda. Vive en las propiedades del script, dentro de tu cuenta de
Google. Por eso podes compartir la hoja con la secretaria sin compartir la llave.

Las llamadas salen de los servidores de Google, no de tu computadora. Si se cae el internet del
colegio mientras corre, igual termina.

Los enlaces vencen a los 30 dias.


LO QUE NO HACE, DICHO DE FRENTE
-------------------------------

NO cobra solo. Esto no es facturacion recurrente: el cliente sigue teniendo que abrir su enlace y
pagar. Lo que cambia es que mandar ciento veinte recordatorios pasa a ser dos clics, y saber quien
no ha pagado pasa a ser una columna en vez de leer el portal fila por fila.

Cobrar sin el cliente presente exige guardar su tarjeta, y ese modulo se habilita por comercio en
ROKI. Cuando este habilitado en tu cuenta, esto se puede convertir en cobro automatico de verdad.


REQUISITOS
----------

- Una cuenta de Google (gratuita alcanza).
- Tu llave secreta de ROKI.

Google limita las llamadas por dia en las cuentas gratuitas. Para listas de mas de mil filas
conviene partirlas en varias hojas.


SOPORTE
-------

https://connect.roki.la
