Contrato Locação
Scanned@david-evaristo
npx machina-cli add skill @david-evaristo/contrato-locacao-broa --openclawSkill: Registro de Contrato de Locação (Google Forms)
📝 Descrição
Esta skill automatiza o registro de contratos de locação imobiliária. Ela envia os dados coletados pelo agente para um Google Form, que por sua vez dispara um Google Apps Script responsável por:
- Gerar um contrato em PDF baseado em um template do Google Docs.
- Calcular automaticamente a Permanência (em dias) e o Valor da Diária.
- Formatar valores monetários para o padrão brasileiro (R$).
- Enviar o PDF assinado via e-mail para o locatário e administradores.
🛠 Parâmetros de Entrada
O agente deve extrair os seguintes dados da conversa. Todos são obrigatórios, exceto onde indicado.
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
email | string | E-mail do locatário (destino do PDF). | exemplo@email.com |
telefone | string | Telefone com DDD (apenas números). | 16988035666 |
nome | string | Nome completo do locatário. | David Evaristo |
cpf | string | CPF (apenas números). | 40544335880 |
endereco | string | Nome da rua/avenida. | Rua Bichara Damha |
numero | string | Número do imóvel. | 360 |
bairro | string | Bairro do imóvel. | Sao Carlos 2 |
cidade | string | Cidade. | Sao Carlos |
estado | string | UF do estado (2 letras). | SP |
data_entrada | string | Início da locação (Formato: YYYY-MM-DD). | 2026-02-10 |
data_saida | string | Fim da locação (Formato: YYYY-MM-DD). | 2026-02-15 |
valor | string | Valor total da estadia. | 2000 |
caucao | string | Valor do depósito/caução (Opcional). | 200 |
complemento | string | Apto, bloco, etc. (Opcional). | Casa A |
🤖 Instruções para a IA (System Prompt)
- Formatação de Data: Sempre converta datas relativas ("próximo domingo") ou em formato brasileiro ("10/02/26") para o padrão
YYYY-MM-DD. - Validação: Não execute a skill se o e-mail ou CPF estiverem ausentes.
- Confirmação: Antes de enviar, apresente um resumo: "Confirmando: Contrato para David Evaristo, de 10/02 a 15/02, total R$ 2.000,00. Posso gerar?"
- Pós-execução: Informe ao usuário que o contrato chegará no e-mail em instantes.
⚙️ Fluxo de Dados
- O agente chama a função
fill_rental_form. - A função realiza um
POSTpara o endpoint/formResponsedo Google. - O Google aciona o gatilho
onFormSubmit. - O documento é gerado e o e-mail enviado.
Overview
Esta skill automatiza o registro de contratos de locação imobiliária enviando dados para um Google Form. Em seguida, um Apps Script gera um PDF a partir de um template no Google Docs, calcula a Permanência (dias) e o Valor da Diária, formata os valores em BRL e envia o PDF assinado ao locatário e aos administradores.
How This Skill Works
Os dados coletados (email, cpf, nome, endereço, datas, valor, caução, complemento) são enviados para o endpoint formResponse do Google Forms. O gatilho onFormSubmit aciona um Apps Script que gera o contrato em PDF pelo template, calcula a Permanência e o Valor da Diária, formata os valores em BRL e envia o PDF por e-mail aos destinatários.
When to Use It
- Quando um inquilino assina um contrato de locação e é preciso registrar o documento de forma padronizada.
- Ao criar contratos com dados padronizados (nome, CPF, endereço, datas) para reduzir erros.
- Para emitir automaticamente o PDF do contrato a partir de um template Google Docs.
- Quando é necessária a formatação de valores em BRL (R$) e envio do contrato por e-mail.
- Para registrar, armazenar e auditar contratos de locação usando o Google Forms como registro central.
Quick Start
- Step 1: Reúna os dados do inquilino (email, cpf, nome, endereco, data_entrada, data_saida, etc).
- Step 2: Envie os dados para o Google Forms via POST para /formResponse usando fill_rental_form.
- Step 3: Aguarde o email com o PDF do contrato e confirme os detalhes.
Best Practices
- Valide que os campos obrigatórios, especialmente email e CPF, estão presentes antes de enviar.
- Siga o formato de data YYYY-MM-DD e confirme a conversão de datas relativas.
- Teste com dados de exemplo para confirmar geração de PDF, cálculos de Permanência/Diária e envio de e-mail.
- Verifique os destinatários de e-mail (locatário e administradores) antes de cada envio.
- Assegure que o valor total e a caução estejam formatados em BRL (R$)
Example Use Cases
- Contrato de locação residencial em São Carlos, SP, com datas 2026-02-10 a 2026-02-15 e aluguel total de R$ 2.000,00.
- Locatário: David Evaristo, CPF 40544335880, email exemplo@email.com; caução de R$ 200,00.
- Imóvel: Rua Bichara Damha, nº 360, Bairro Sao Carlos 2, SP.
- PDF do contrato gerado a partir do template do Google Docs e enviado para o locatário e para a administração.
- Formato de moeda BRL utilizado pelo script para todos os valores.
