eazy-payment-k0ntroI

Introdução

Um pequeno conjunto de scripts que irá ajudar você a gerenciar seus débitos e recibos de forma bem prática! Para ver uma prévia assista o video aqui.

Quem pode usar?

Qualquer pessoa que forneça serviço para outras pessoas, e precisa de uma praticidade para controlar os débitos e gerar recibos para seus clientes. Se você é um psicólogo, professor de guitarra ou alguma ocupação que se encaixe nesse cenário, este programa pode te ajudar, com CUSTO ZERO!!!

O que eu preciso?

• Uma conta gmail.
• Conhecer um pouco de planilhas.

Como ele funciona?

Ele é totalmente orientado ao seu Google Calendar, ou seja, você precisa criar eventos no seu calendário para cada pessoa que você presta um serviço. Uma rotina é executada diariamente, para recuperar os eventos do calendário e adicionar eles na planilha.

Quais permissões o script vai precisar?

Recurso	Descrição
Google Calendar	O script precisa ler seu Google Calendar, para saber quais pessoas você atendeu e/ou realizou algum serviço.
Google Drive	O script precisa ler e escrever em seu Google Drive, para conseguir usar um modelo de recibo, fazer uma copia, substituir com as informações da pessoa, e assim gerar uma versão em PDF.

Como posso fazer para já sair usando?

Existem duas abordagens:

1. Fazer uma cópia deste documento e seguir as instruções na sessão de personalização, é obrigatório este passo, mesmo se você fez uma copia do documento.
2. Configurar tudo do zero.

Os passos seguintes, mostram como configurar tudo do zero!

1. Vá até https://drive.google.com/ e crie um novo documento conforme imagem a seguir.
2. Dê um nome bonito para o seu documento :)
3. Vá no menu Extensões e clique em Apps Script.
4. O Google irá abrir uma tela, dê um nome para o seu projeto de scripts.
5. Apague todo o conteúdo do arquivo Code.gs.
6. Copie TODO o nosso Code.gs e cole no seu Code.gs.
7. Adicione um novo arquivo no seu projeto de scripts, com o nome Actions.
8. Copie TODO o nosso Actions.gs e cole no arquivo que você acabou de criar.
9. Clique no icone de salvar (icone de um pequeno disquete) e pronto você está pronto para sair usando!!! As próximas sessões vão te ajudar a configurar sua planilha.

Configuração do seu Google Spreadsheet

Os valores apresentados a seguir são apenas de exemplo e não representam valores reais. Você deve mudar conforme sua necessidade.

Planilha de parâmetros obrigatória

Você precisa criar uma planilha com o nome de parameters. Nesta planilha, você irá colocar todas as suas informações. Abaixo segue um exemplo, ela precisa ter os mesmos nomes da coluna da esquerda (CHAVE), os valores da coluna da direita (VALOR) você muda conforme sua necessidade.

CHAVE	VALOR
MY_NAME	David Gilmour
MY_PERSONAL_INFO_1	https://www.davidgilmour.com/
MY_PERSONAL_INFO_2	https://www.instagram.com/davidgilmour/
MY_PERSONAL_INFO_3	Bandstores.co.uk, 1 Brook Street, Whetstone
MY_PERSONAL_INFO_4	Leicester LE8 6LA, United Kingdom
GOOGLE_SHEET_MAIN	contas-receber
GOOGLE_SHEET_NAME_PEOPLE	cadastro-cliente
GOOGLE_CALENDAR_ID	[email protected]
GOOGLE_DOCS_RECEPIT_TEMPLATE_ID	910283iujasdho9123kl123098
GOOGLE_DATE_FORMAT	dd/MM/yyyy
GOOGLE_DATE_REGION	America/Sao_Paulo
DIFF_DAYS	1
DEBIT_MESSAGE	Olá {{name}}, temos {{n}} sessão(ões) em aberto:<br/><br/>{{formatted_days}}<br/> Totalizando R$ {{total_value}}.<br/>😘 Me paga logo por favor!!!
MONTHS	['Janeiro', 'Fevereiro', 'Março', 'Abril', 'Maio', 'Junho', 'Julho', 'Agosto', 'Setembro', 'Outubro', 'Novembro', 'Dezembro']

Planilha principal

Essa é a planilha principal, você pode criar ela com qualquer nome, mas precisa definir o nome correto na planilha de parameters, na chave GOOGLE_SHEET_MAIN. Esta planilha pode ter qualquer quantidade de colunas. Porém, ela DEVE no mínimo ter as seguintes colunas nas ordens EXATAS:

Nome	Data Início	Data Fim	Valor	Data Pagamento	Forma Pagamento	Status do Pagamento
Ana	08/01/2021 19:00:00	08/01/2021 20:00:00	R$210,00	03/02/2021	depósito	OK

Nota: Você pode até renomear as colunas, pois o código vai olhar pela posição de cada coluna, por isso é importante manter a ordem!

Planilha com o registro das pessoas

Essa é a planilha auxiliar, mas importante para o bom funcionamento do script. Nesta planilha, o programa irá fazer uma relação dos eventos do Google Calendar, com as pessoas que você atende e/ou fornece algum serviço. Esta planilha pode ser criada da seguinte forma:

Nome	Valor	Telefone
Ana	R$210,00	19996988871
Joãozinho	R$50,00	19996988872
Pedrinho	R$25,31	19996988873

Ou seja, pense nessa planilha como o cadastro das pessoas que você atende e o preço de cada um.

Configuração no Google Calendar

Aqui a mágica acontece! Você precisa criar um evento no seu Google Calendar, usando apenas o nome da pessoa. Por exemplo:

Pronto, a rotina que irá rodar diariamente vai:

• Verificar que você tem um evento com o nome Ana, e se existir no seu registro de pessoas, irá adicionar uma entrada na planilha principal junto com o valor.

Personalização

Para que o programa consiga alimentar de forma automática a sua planilha principal, você deve configurar um recurso da seguinte forma: Cliquei no ícone de relógio que fica do lado esquerdo no Google Script Editor e logo em seguida clique no botão azul do lado inferior direito.

Define o gatilho da seguinte forma:

É obrigatório a seleção da função getCalendarEvents, pois conforme sugestão da imagem, essa função irá alimentar sua planilha principal todo dia as 12h AM, clique no botão salvar. Uma tela perguntando por autorização será exibida, você deve aceitar conforme imagem:

TODOs

Lista de items a serem implementados.