# Configurações *Três serviços, três contas — e todas são suas.* > **A imobiliária começa com o pagamento em Demonstração** — Para você treinar o fluxo de cobrança na hora — cobranças simuladas, claramente marcadas como **modo de demonstração**. O botão **Testar** reprova de propósito: a cobrança de demonstração não é reconhecida por banco nenhum. Troque para o provedor real quando validar. > > E-mail e armazenamento começam **sem escolha**, de propósito: ali a demonstração seria armadilha (e-mail que parece enviado, disco que perde o arquivo). Você cadastra pessoas, imóveis e contratos desde o primeiro minuto; o que depende desses serviços avisa onde resolver quando você tentar. > **Configurações fica em abas** — Para não empilhar tudo numa coluna só, a tela se divide em **Serviços** (cobrança, e-mail e arquivos), **Identidade & marca**, **Modelos de documentos**, **Calendário**, **Apresentação** (o test-drive), **Cópia de segurança** e **Assinatura** (a mensalidade). > **Teste gratuito de 3 meses** — Toda conta nova começa com **3 meses grátis**, sem cartão — tempo de ver dois ou mais ciclos de aluguel rodando antes de decidir. O teste vale para **até 3 contratos ativos** (imóveis e pessoas você cadastra à vontade). Ao ativar o **4º contrato**, o Locarë avisa antes de salvar: confirmando, o teste termina ali e a 1ª mensalidade (faixa de entrada) é gerada, com alguns dias de prazo — nesse prazo tudo segue liberado, e um aviso no alto da tela mostra até quando pagar. Um aviso no alto da tela também mostra quantos dias faltam nas últimas semanas. Terminado o teste, é só assinar um plano (a partir de **R$59/mês**) para continuar. Enquanto não assina, a **consulta e a exportação continuam liberadas** — só **criar e editar** ficam à espera do plano, para que nenhum dado fique preso. > **Pagar a mensalidade no cartão, renovando sozinho** — Na aba **Assinatura**, o botão **Pagar com cartão (renova sozinho)** abre a **página segura do provedor** onde você cadastra o cartão — o número **nunca passa pelo Locarë**. A partir daí a mensalidade é cobrada **automaticamente todo mês**, sem boleto. Dá para cancelar quando quiser (volta ao boleto/Pix no mês seguinte; o que já foi cobrado não é estornado). > **Pagar com Pix aqui, sem sair do Locarë** — No topo da aba **Assinatura**, o quadro **Sua assinatura** resume o plano, a faixa, o valor do mês, o próximo vencimento e o último pagamento. Na mensalidade em aberto (e no pedido do plano anual), o botão **Pagar com Pix aqui** abre o **QR Code** e o **copia e cola**: abra o app do banco, escolha Pix → Pagar com QR Code e aponte a câmera. A janela percebe o pagamento sozinha, em poucos segundos, e mostra «Pagamento recebido». Prefere boleto ou cartão? O botão **Boleto ou cartão** abre a página de pagamento do provedor, onde você escolhe. Pediu o plano anual e desistiu antes de pagar? **Cancelar o pedido** cancela a cobrança e você segue no mensal. Cada mensalidade paga tem o botão **Recibo** (PDF), que também chega por e-mail quando o pagamento é confirmado — inclusive o mês pago com o saldo do plano anual. Um crédito que a Locarë lhe der aparece como **🎁 Crédito da Locarë**, com o motivo, e paga os próximos meses sozinho. ## O plano anual: 12 meses com 10% de desconto Na aba **Assinatura**, o cartão **Plano anual** mostra quanto ficam 12 meses pela sua faixa de hoje, com 10% de desconto (por exemplo, com 15 contratos: R$ 1.285,20 em vez de R$ 1.428,00). Clique em **Quero o plano anual**: abre a página de pagamento (boleto, Pix ou cartão). Quando o pagamento cai, o valor vira **saldo**. - **Todo mês, o saldo paga a mensalidade** — a faixa daquele mês, com os 10% de desconto. Nada de boleto enquanto houver saldo. - **A carteira diminuiu?** O mês custa menos e o saldo dura mais (é um crédito de uso, não se perde). **Cresceu?** O mês custa mais e o saldo acaba antes — não há cobrança de diferença no meio do caminho. - **O saldo acabou no meio de um mês?** Ele paga a parte que cobre, e o que faltar vem em boleto pelo preço cheio. Daí em diante, volta a mensalidade comum — ou você renova o anual (o botão aparece quando o saldo está no fim). - Tinha o cartão recorrente ligado? Ao pagar o anual ele é desligado sozinho, para não cobrar duas vezes. **O extrato do saldo.** Quem tem o anual vê, no alto da aba Assinatura, o quadro **Saldo do plano anual**: o saldo gerado, o usado até hoje, o restante («paga até tal mês») e, se o saldo não for cobrir um mês inteiro, o **previsto à parte**. Uma frase resume a previsão («no ritmo de hoje, ele paga até abr/27; em mai/27 cobre uma parte e R$ 155 vêm à parte»). No computador, um gráfico mostra o saldo caindo mês a mês (linha cheia = o que já aconteceu; tracejada = previsto pela faixa de hoje) e, embaixo, de onde veio o consumo de cada mês — a faixa da Gestão, a da Vitrine (V1, V2, V3), o que foi à parte e os meses que já voltaram ao mensal —, com as mudanças marcadas («subiu», «caiu», «+ Vitrine») e uma linha vermelha no mês em que o saldo acaba. Em **Mês a mês**, a mesma conta em lista (é o que aparece no celular). Quem está no mensal vê o quadro **Sua assinatura mês a mês**: a faixa do último mês, a próxima a pagar, o total pago e o que estiver em atraso, um gráfico dos últimos 12 meses (Gestão e Vitrine, com «subiu», «caiu» e «+ Vitrine» marcados e os meses atrasados em vermelho) e a conta de quanto o anual teria economizado nesses meses. O site, nos preços, mostra um exemplo com três cenários. **O resumo do mês por e-mail.** Todo mês em que o saldo do plano anual paga a assinatura, chega ao e-mail da imobiliária um resumo: a faixa e os contratos ativos do mês, o preço cheio, quanto saiu do saldo e quanto você economizou com o desconto, o saldo antes e depois, e por quantos meses ele ainda paga no ritmo de hoje. Se o saldo não cobriu o mês inteiro, o resumo diz quanto falta e onde está a fatura; quando o saldo acaba, avisa que a assinatura volta ao mensal. Quando o saldo pagou o mês inteiro, o recibo vai anexo. > **Cancelar o plano anual** — Pelo botão **Cancelar o anual**, que mostra a conta **antes** de você confirmar. **Em até 7 dias do pagamento** (o direito de arrependimento do Código de Defesa do Consumidor), a devolução é integral — e os meses que o saldo pagou voltam a ser cobrados como mensalidade comum. **Depois disso**, devolvemos o que sobrou, recalculando os meses já usados pelo preço cheio: você «devolve» só o desconto que ganhou. Exemplo: pagou R$ 637,20 (12 × R$ 59 − 10%) e usou 2 meses → volta R$ 637,20 − 2 × R$ 59 = **R$ 519,20**. A Locarë faz a devolução, e ela aparece na aba quando concluída. ## Boleto do meu banco: o Locarë só controla Prefere emitir os boletos no **seu próprio banco**? Em **Configurações → Serviços → Cobrança**, escolha **Boleto do meu banco** e clique em **Salvar**. Não há chave para colar nem webhook. Dá para usar junto com um provedor integrado: no contrato, o campo **Provedor de cobrança** escolhe quem emite as cobranças dele. Por exemplo, a carteira no Asaas e alguns contratos pelo boleto do seu banco. - **Todo mês** o Locarë gera as cobranças com o **valor e o vencimento certos**: aluguel, condomínio, IPTU, encargos, descontos e o primeiro aluguel proporcional, como em qualquer outro provedor. - Você emite o boleto no banco com esse valor e esse vencimento. Na cobrança, clique em **📎 Anexar boleto** e envie o PDF (ou uma foto). Cole também a **linha digitável**, se quiser que o inquilino possa copiá-la, e o **Pix copia e cola**, se o boleto tiver. - O inquilino recebe um e-mail com a composição, o total, o vencimento e o **boleto em PDF anexo**. No portal, ele baixa o boleto e copia a linha. - Quando o pagamento cair, em **Cobranças**, clique em **Registrar pagamento**. Informe a **data do pagamento** que está no extrato. O recibo sai na hora. - **Vários pagamentos de uma vez:** em **Cobranças**, clique em **🏦 Importar pagamentos do banco** e envie o **arquivo de retorno** da cobrança, que você baixa no internet banking da empresa (em *Cobrança → Arquivo de retorno*; termina em **.RET** ou **.TXT**). O Locarë mostra, boleto por boleto, de qual inquilino é e se está pronto para registrar; você confere e clica em **Registrar os marcados**. A data é a do pagamento no banco. Enviar o mesmo arquivo duas vezes não paga duas vezes. Extrato (OFX ou PDF) não serve: ele não diz qual boleto foi pago. Funciona com o retorno CNAB 400 da Unicred e com o CNAB 240 (padrão dos bancos). Se você anexou a **linha digitável** nas cobranças, o Locarë acha cada boleto pelo número dele; sem a linha, sugere pelo valor e pelo vencimento — mas esse pagamento vem **desmarcado**, para você conferir o nome no banco: dois inquilinos com o mesmo aluguel e o mesmo vencimento confundem esse reconhecimento. - **O Locarë aprende:** o pagamento que ele não reconhecer aparece com a lista **De quem é este pagamento?** — escolha o inquilino e registre. Ele guarda o **«Seu número»** daquele boleto (o campo que você preenche ao emitir no banco) e, no mês seguinte, reconhece sozinho. Dica: preencha o «Seu número» sempre com o mesmo código do inquilino, como o apartamento (ex.: *APTO 302*). Se você usar o mesmo texto para todos (ex.: *ALUGUEL*), ele não serve para reconhecer. O que o Locarë aprendeu aparece no primeiro passo da importação, com **Esquecer** para desfazer. - **Agenda dos arquivos:** no primeiro passo da importação, o calendário do mês mostra em **verde** os dias com arquivo conferido e em **amarelo** os dias úteis sem arquivo (pode ser só um dia sem movimento — o banco não gera arquivo). Como o banco numera cada arquivo em sequência, o Locarë avisa com certeza quando **faltou um** («Faltou o arquivo nº 42») e quando o arquivo **já foi conferido**. Arquivo sem pagamento novo também conta: clique em **Concluir — arquivo conferido**. - **Vários arquivos de uma vez:** o banco costuma gerar vários arquivos por dia (os que terminam em _01, _02, _03…), cada um com um lote de movimentos. Escolha todos de uma vez — ou o arquivo compactado (**.zip**) que o banco entrega para os meses antigos. O Locarë junta tudo numa prévia só, e o mesmo pagamento repetido em dois arquivos não paga duas vezes. Cada pagamento mostra quando **cai na conta**: pago por outro banco, o dinheiro entra no dia útil seguinte — é essa a data que aparece no extrato. - **Desfazer registro:** registrou um pagamento por engano, ou ele não apareceu no extrato? No card da cobrança paga, clique em **Desfazer registro** e informe o motivo. A cobrança volta a ficar em aberto, e o histórico guarda o que foi desfeito. Não dá para desfazer um pagamento parcial (que gerou cobrança de saldo) nem um cujo repasse já foi registrado como feito. - O dinheiro está na sua conta. A parte do proprietário você transfere pelo banco e registra na cobrança, em **Já repassei por fora**. Ele recebe o recibo de repasse por e-mail. > **Quando o aviso sai** — No cartão do provedor, em **Quando avisar o inquilino**: o padrão é **quando você anexar o boleto**, e o inquilino recebe um e-mail só, já com ele. A segunda opção avisa assim que a cobrança é gerada, sem o boleto. Se o **seu banco já manda o boleto** ao inquilino, escolha **Não enviar — o meu banco já manda o boleto**: o Locarë não envia o e-mail da cobrança (nem ao anexar); a cobrança e o boleto anexado ficam no portal do inquilino, e o recibo continua saindo quando você registrar o pagamento. Em **Em que conta o dinheiro cai**, se o boleto é do banco do **próprio proprietário**, escolha **Direto na conta do proprietário — não há repasse**: o Locarë não cria repasse a fazer nem lista a cobrança em «Repasses em atraso». Remarcar o vencimento retira o boleto anexado, porque ele tinha a data antiga: anexe o novo. O PDF fica no armazenamento de arquivos da imobiliária (Configurações → Serviços → Arquivos). > **O que você deixa de ter** — Sem integração, não há **baixa automática**, **split** nem **repasse automático por Pix**. Remarcar e cancelar mudam só o Locarë: o boleto já emitido no banco você ajusta lá. ## Mercado Pago: conectar em um clique Em **Configurações → Serviços → Cobrança**, escolha **Mercado Pago** e clique em **Conectar Mercado Pago**. Entre na sua conta do Mercado Pago, se ele pedir, e autorize o Locarë. Você volta com a conexão pronta e testada. - Não há Access Token para copiar nem URL de notificação para cadastrar no painel do Mercado Pago: o Locarë manda o endereço de notificação em cada cobrança. - Para validar antes de cobrar de verdade, marque **Conectar em modo de testes**. - O acesso vale 180 dias e se renova sozinho perto do vencimento. Se o cartão disser que a conexão expirou, clique em **Reconectar**. > **O que o Mercado Pago não faz** — Ele não divide o pagamento na origem (split): o aluguel inteiro cai na sua conta e o Locarë repassa a parte do proprietário por Pix (veja abaixo). Multa e juros de atraso são definidos no painel do Mercado Pago, não por cobrança. Para o dinheiro nem passar por você, use o Asaas. ### Repasse automático por Pix pelo Mercado Pago O proprietário **não precisa fazer nada** — só ter a chave Pix na ficha. Assim que o aluguel cai na sua conta do Mercado Pago, o Locarë manda a parte dele por Pix. O Mercado Pago pede uma liberação, uma vez só: 1. No cartão do Mercado Pago (Configurações → Serviços → Cobrança), em **Repasse automático por Pix**, clique em **Gerar a chave das transferências**. 2. Clique em **Copiar a mensagem para o Mercado Pago** e envie no atendimento deles (Ajuda → Fale conosco, ou o seu contato comercial). A mensagem já pede a liberação, cadastra a chave e pergunta a tarifa e o limite. 3. Quando eles confirmarem, marque **O Mercado Pago liberou as transferências da minha conta** e clique em **Salvar**. Até a liberação, o repasse aparece como «não saiu», com a explicação: faça pelo app do Mercado Pago e use **Já repassei por fora**; depois de liberado, use **Reenviar os que falharam**. O limite de Pix da conta vale também aqui (na pessoa física, R$ 50 mil por dia das 6h às 20h): o que passar fica pendente e sai sozinho no dia seguinte. Em modo de testes, o repasse funciona sem liberação. ## Asaas: a conta de cobrança e o webhook > **Guia passo a passo, com prints** — Da criação da conta ao webhook e ao repasse: [abrir o guia do Asaas](https://app.locareapp.com/ajuda/guia-asaas.md). Ele também está no cartão do Asaas, em Configurações → Serviços → Cobrança. A cobrança sai pelo **Asaas**, e a conta é **sua** — aberta pela imobiliária, no Asaas, direto com eles. O Locarë só orquestra: emite o boleto/Pix, recebe o aviso de pagamento e dá a baixa. O dinheiro nunca passa pela conta da plataforma. 1. No Asaas, vá em **Integrações → Chaves de API**, gere a chave **marcando «Permitir que esta chave execute operações de saque via API»** e copie. Sem essa permissão, a cobrança é recebida mas o **repasse nunca sai** — o dinheiro fica parado na conta Asaas. 2. No Locarë, em **Configurações → Serviços → Cobrança**, escolha **Asaas**, cole a chave e selecione o **ambiente**: `Sandbox` para treinar, `Produção` para cobrar de verdade. 3. Clique em **Testar** antes de sair. > **Sandbox e Produção são DUAS contas diferentes** — O ambiente de testes (`sandbox.asaas.com`) e o real (`asaas.com`) têm **chaves separadas e webhooks separados**. A chave de sandbox só emite no sandbox; a de produção, só na real. Use a chave do **mesmo ambiente** que você escolheu no Locarë — misturar as duas é o erro que faz a emissão falhar sem explicação óbvia. ### O webhook — a baixa automática Sem webhook, o Locarë emite a cobrança mas **nunca fica sabendo que ela foi paga**: a conta continua Aguardando para sempre. O webhook é o aviso que o Asaas manda quando o dinheiro entra — é ele que vira a situação para **Recebido** sozinha. > **O jeito rápido: o Locarë configura por você** — Depois de salvar a chave de API, clique em **Configurar o webhook no Asaas** (Configurações → Cobrança → Asaas). O Locarë cria — ou corrige — o webhook na sua conta: URL com a chave, token, **ativo**, envio **sequencial** e todos os eventos de pagamento. Não precisa abrir o painel do Asaas. E o **Testar conexão** agora confere tudo isso: se o webhook existe, se está ativo, se a fila foi **interrompida** pelo Asaas, se o envio é sequencial, se faltam eventos e se a conta tem **chave Pix** ativa (sem ela, o Asaas não gera o Pix das cobranças). Os passos manuais abaixo continuam valendo para quem preferir. 1. No Locarë, em **Configurações → Serviços → Cobrança**, a **URL do webhook** já vem **pronta e completa**: a chave de autenticação vai embutida no final dela (`?chave=…`) — o sistema gera tudo, não há o que inventar. Um único botão **Copiar** leva a URL inteira. Gerar nova rotaciona a chave — e a URL muda junto, então recopie no provedor. 2. No Asaas, vá em **Integrações → Webhooks → Adicionar**. 3. Em **URL do Webhook**, cole a URL copiada **inteira**, sem cortar o final — é ali que mora a chave, e é ela que prova que o aviso vem do seu Asaas. Não há mais token para colar à parte: o Asaas aceita a chave pela própria URL, e o campo Token de autenticação pode ficar em branco. 4. Marque os eventos de **Cobranças** (pagamento recebido e confirmado), deixe o webhook **ativo** e salve. > **O webhook mora na MESMA conta da chave** — Cadastrou a chave de sandbox no Locarë? Então o webhook tem de ser criado **na conta de sandbox**. Um webhook na conta de produção **não dispara** para um pagamento feito no sandbox — a conta é outra. É a causa mais comum de paguei e não deu baixa. > **Como saber que funcionou** — Pague uma cobrança de teste. Em segundos, a situação vira **Recebido** sozinha — na tela de Cobranças e no portal do inquilino, **sem recarregar** (as duas telas se atualizam a cada poucos segundos). No histórico de webhooks do Asaas, a entrega aparece como **200**. Se der **401**, a chave da URL está errada ou velha (recopie a URL inteira) — e o **Registro do sistema** mostra a linha «webhook recusado»; **404**, a URL foi colada cortada. O campo «Token de autenticação» do Asaas pode ficar em branco ou com o token do Locarë; para a baixa, basta a URL certa. Mas, em branco, o **Testar conexão** aponta «o webhook está sem o token de autenticação»: para o teste passar, clique em **Configurar o webhook no Asaas**, que preenche o token. ### O repasse por Pix sem token por SMS (validação de saque) Por segurança, o Asaas **segura** toda transferência feita pela API: o repasse fica **«aguardando autorização»** até alguém digitar o token no painel — e o proprietário não recebe. A solução oficial do Asaas é a **validação de saque**: a cada repasse, o Asaas pergunta ao Locarë «posso?», e o Locarë aprova **só as transferências que ele mesmo pediu** (valor e chave conferidos). Qualquer outra — inclusive alguém com a sua chave de API tentando sacar — é recusada. Cada decisão fica no Registro do sistema. 1. No Locarë, em **Configurações → Cobrança → Asaas**, logo abaixo da URL do webhook, fica a **🔐 URL de validação de saque** — clique em **Copiar**. 2. No Asaas: **Integrações → aba Segurança → «Validação de saque via Webhook» → Habilitar validação**. 3. Cole a URL **inteira**, informe o seu e-mail e deixe o **token em branco**. 4. Deixe **desmarcadas** as duas opções abaixo da URL («Validar também saques via interface» e «estornos Pix») — assim, o que você fizer à mão no app do Asaas continua pelo token de sempre. 5. Salve. Os repasses que já estavam parados precisam ser autorizados uma última vez no alerta «eventos críticos pendentes» do Asaas; os próximos saem sozinhos. ### Provar com dinheiro de verdade: o teste de repasse Em **Configurações → Cobrança → Asaas → 🧪 Testar o repasse com dinheiro de verdade**, informe um valor (mínimo R$ 5,00) e uma ou duas chaves Pix de **outras contas suas**, com o percentual de cada uma, e clique em **Gerar cobrança de teste**. Pague pelo QR Code ou pelo Pix copia e cola. A tela acompanha sozinha cada etapa: o pagamento recebido — e se foi **o webhook que avisou** —, e cada Pix **enviado** ou **recusado com a frase exata do Asaas**. Não precisa de saldo: o teste reparte o valor líquido (o que caiu depois da tarifa). Deu errado? Corrija e use **↻ Tentar os Pix de novo**, sem pagar outro teste. **🗑 Apagar** tira o teste da lista. Pix recusado também aparece no Registro e nos avisos do Painel. > **O que cada recusa quer dizer** — «não possui permissão para realizar saques» → a chave de API foi criada sem a permissão de saque; «aguardando AUTORIZAÇÃO» → falta a validação de saque; «Necessário informar uma chave Pix válida» → confira a chave; «Saque … já solicitado» → o Asaas bloqueia a MESMA transferência (mesmo valor e chave) repetida em pouco tempo — teste com outro valor. > **Chave Pix: o sistema reconhece o tipo** — Em todo campo de chave Pix (ficha da pessoa, chave da imobiliária, portal do proprietário, teste), aparece embaixo o tipo reconhecido — e-mail, CPF, CNPJ, celular, aleatória — ou um aviso. **Celular** pode ser digitado só com DDD e número: o Locarë completa com **+55** ao sair do campo. Ao sair do campo a chave também ganha a forma de sempre — CPF 000.000.000-00, CNPJ 00.000.000/0000-00, celular +55 (21) 99999-9999 — só para ler: o Pix sai com os números. > **Pix vazio? Cadastre uma chave Pix no Asaas** — O Pix copia-e-cola só é gerado se a conta Asaas tiver uma **chave Pix cadastrada**. Sem ela, o boleto sai normalmente, mas o campo do Pix fica em branco. ## Identidade da imobiliária O primeiro campo da aba é **Como você atua**: **Imobiliária** ou **Gestor(a) de imóveis**. Nem todo cliente é uma imobiliária, e quem administra imóveis por conta própria não precisa ler «imobiliária» em cada botão. A escolha muda a palavra em **todo o sistema** — telas, portal do inquilino e do proprietário, e-mails, documentos, planilhas e o feed do painel — com o artigo certo («fale com o gestor», «chave Pix do gestor»). O seu **nome** e os textos que você escreveu (a voz dos e-mails, os modelos de documento) ficam exatamente como estão. A troca fica registrada no Registro do sistema. A aba **Identidade & marca** guarda a **sua marca**: nome, endereço, telefone, **logotipo** e a localização no mapa. Ligando **Estampar a marca nos documentos**, o logo e os seus dados aparecem no **topo da minuta de locação e do PDF de vistoria**, como um papel timbrado. O sistema é a infraestrutura por baixo — invisível; o documento sai em nome da sua imobiliária. Assim que você envia o seu logotipo, ele **substitui a marca do sistema no canto superior** — tanto no painel quanto no **portal do cliente**, onde o inquilino passa a ver a sua marca em vez da nossa. Enquanto não houver logo próprio, fica a marca do sistema ali — que some no instante em que a sua entra. A Locarë continua presente, mas discreta: um selo pequeno no rodapé do menu e no topo do portal, ao lado do Sair. **Somos a infraestrutura por baixo; o nome que aparece é o seu.** Com a marca ligada, três opções dão o tom de **papel timbrado** aos documentos: **cabeçalho e rodapé em todas as páginas** (não só a primeira), o logotipo em **preto e branco**, e o logotipo como **marca d'água** — bem claro, atrás do texto de cada página. **Não exibir o nome do Locarë.** Os relatórios e documentos que você entrega ao cliente (prestação de contas ao proprietário, relatório de manutenção, prestação de contas do condomínio, recibo de repasse e vistoria) trazem no rodapé «Emitido em … pelo sistema Locarë». Ligando esta opção, na mesma aba, o rodapé sai só com a data e a hora (de Brasília) — o documento fica inteiro com o nome da sua imobiliária. No portal do cliente, some também o selo «Tecnologia Locarë» ao lado do Sair, e a aba do navegador passa a mostrar o nome da sua imobiliária. ## Gmail: o jeito mais simples de começar Se você não tem domínio próprio — o caso de muito gestor autônomo —, dá para enviar pela **sua própria conta Google**, sem domínio, sem DNS e **sem senha**. Em **Configurações → Serviços → E-mail**, escolha **Gmail (conta Google)** e clique em **Conectar com o Google**: você escolhe a conta e autoriza. O Locarë passa a mandar a cobrança **em seu nome, pela sua caixa** — o inquilino vê o seu e-mail no remetente. **Se a conexão com o Google expirar** (a autorização vale por um prazo, e o Google também a revoga se você trocar a senha ou remover o acesso), o Locarë **avisa em dois níveis**: a rotina da manhã sonda a conexão de cada imobiliária todo dia, e qualquer e-mail que falhe por esse motivo marca na hora. Nos dois casos aparece um **banner vermelho no painel** — «A conexão com o Google expirou» — com o botão **Reconectar agora**, e a trilha ganha um registro «google_expirado». Enquanto isso, os e-mails e o backup no Drive ficam parados (as cobranças esperam para sair, não se perdem). Basta clicar em **Conectar com o Google** de novo: o banner some sozinho e os envios retomam. > **O Locarë só recebe permissão de ENVIAR — nunca de ler** — A autorização do Google é apenas para *enviar e-mail no seu nome*. O Locarë não lê a sua caixa de entrada, não vê seus outros e-mails, nada disso. E você desfaz quando quiser: o botão **Desconectar** tira a conta do Locarë (para revogar também no Google, `myaccount.google.com → Segurança`). Depois de conectar, use **Testar envio** — ele manda uma mensagem real para a sua própria caixa, provando que funciona de verdade (não só que a conexão está de pé). O **Nome do remetente** é o que aparece na caixa do inquilino: use o nome da imobiliária. > **Quando o Gmail basta, e quando não** — O Gmail comum entrega cerca de **500 e-mails por dia** — sobra para a cobrança de aluguel. Operação grande, com muito envio, é caso de **Resend com domínio próprio** (abaixo). E, nesta fase inicial, conectar o Google pode exigir que a plataforma **libere a sua conta antes** — se o Conectar não passar, fale com o suporte. ## Aba Anúncio: o que cada botão significa Enquanto o imóvel não está na vitrine, a aba Anúncio mostra só **«Publicar na vitrine»** (e diz isso na própria barra). Depois de publicado, no lugar dele aparecem **«Atualizar anúncio»** e **«Tirar do ar»**. A barra de botões fica presa ao rodapé da ficha, visível mesmo em telas pequenas. Para publicar, a vitrine da imobiliária precisa estar ligada (aba Vitrine); desligada, o anúncio fica preparado e sobe quando você ligar. ## A foto de um imóvel apareceu no topo da vitrine O topo («capa com foto» e o modelo imersivo) só usa a **capa própria** da vitrine — enviada em Vitrine → Capa. Sem capa, o topo fica na cor do tema; nenhuma foto de anúncio é reaproveitada ali. O título do topo é o «Título da página» da aba Vitrine — se ele estiver com o nome de um imóvel, troque por uma frase da imobiliária. ## Onde está o «Salvar» da Vitrine? Não há: na aba Vitrine **tudo é salvo sozinho** conforme você digita, e a prévia ao lado acompanha. O rodapé fixo da aba mostra «Salvo automaticamente às HH:MM» e traz a única ação que depende de clique: **Publicar vitrine** (ou «Tirar do ar»). No cadastro do imóvel em rascunho, o rodapé fixo tem «Salvar cadastro». ## Marquei para a vitrine e o imóvel não aparece Imóvel em **rascunho** não entra na vitrine, mesmo com o anúncio preparado: a página pública só mostra cadastro concluído. Abra a ficha, complete o que falta e clique em **Salvar**; aí o anúncio aparece. A lista mostra «rascunho — fora da vitrine» no lugar do interruptor, e a aba Anúncio avisa antes de publicar. ## Corrigi um nome e ele continua errado em alguns lugares Há dois cadastros com nome: a **pessoa** (Pessoas — proprietário, inquilino, corretor) e o **acesso** (Acessos — o login de quem usa o sistema; é o nome do topo da tela e o autor no Registro). Corrigir um não muda o outro. Em Acessos, o botão **Nome** corrige o do login. Ao corrigir a pessoa, os repasses ainda não enviados passam a mostrar o nome novo; o que já saiu (recibo emitido, eventos antigos do Registro) guarda o nome da época — é história, não erro. ## Preciso trocar o e-mail com que entro no sistema O e-mail é o seu login. Para trocar, clique no **seu nome**, no alto da tela (*Minha conta*), e em **Trocar**, ao lado do e-mail. Digite o e-mail novo e a sua senha atual. O Locarë manda um link para o endereço **novo**: a troca só vale depois que você abrir esse e-mail e tocar em **Confirmar** (o link vale 24 horas). Até lá, nada muda — você continua entrando com o e-mail antigo, que também recebe um aviso. A senha não muda. Quem gerencia os acessos também pode pedir a troca para outra pessoa da equipe, em **Acessos → E-mail**; ela precisa confirmar no endereço novo do mesmo jeito. Mudou de ideia? Em *Minha conta*, **Cancelar a troca**. ## Cancelei um boleto — como emitir de novo? Em Cobranças, ao lado de «Ver N cancelada(s)», clique em **Reemitir canceladas…**. Aparece a lista das cobranças de aluguel canceladas com uma caixa de seleção em cada uma («Marcar todas» para todas). Ao confirmar, o Locarë gera de novo o aluguel daquele mês **para a mesma data** (se a data já passou, sai com vencimento hoje), com o mesmo valor, o repasse programado e o boleto novo enviado ao inquilino. A cancelada continua na história, e as duas ficam no Registro do sistema. Só entra o que **não teve nada**: cobrança cancelada, sem pagamento e sem repasse enviado. O que já aconteceu é recusado e o motivo aparece na tela. Cobrança avulsa e antecipação não passam por aqui — crie de novo. Antes desta opção, um mês cancelado não podia ser gerado de novo: «Gerar cobranças do mês» pulava o contrato como se a cobrança existisse. ## «Falta terminar a configuração» com tudo já funcionando A pendência «ainda não foi testado» some quando o provedor funciona de verdade: um boleto emitido, um arquivo guardado ou um e-mail de cobrança entregue valem como teste, e o cartão do serviço passa a dizer «Comprovado em uso». O botão «Testar conexão» continua lá para quem quiser conferir antes do primeiro uso. Um teste que falhou não é apagado por um acerto — reveja a configuração e teste de novo. ## Cadastrei o contrato depois do dia de vencimento do mês A rotina automática não emite cobrança cujo vencimento já passou (o provedor recusa boleto vencido). Para cobrar o mês corrente, clique em **Gerar cobranças do mês**: a cobrança sai com **vencimento hoje** e o Registro anota o ajuste. Se quiser outra data, use «Remarcar» na própria cobrança. ## Próximo vencimento de verdade — e trocar o dia O card do contrato mostra o dia combinado («dia 10») e, abaixo, **quando a próxima cobrança vence de fato**: a data, o dia da semana e, quando o dia cai em sábado, domingo ou feriado, o porquê do empurrão — «o dia 10/10 cai em sábado → dia útil», ou o nome do feriado. É a mesma regra do calendário (Configurações → Calendário); imobiliária que desligou o ajuste vê a data nominal. Para trocar o dia: menu **Cobrança → Dia do vencimento**, informe o novo dia (1 a 31). A troca é **definitiva**: o dia fica gravado no contrato e vale para todas as cobranças **ainda não geradas**, mês após mês; a cobrança já emitida deste mês continua com a data dela — para mudá-la, use «Remarcar» na própria cobrança. A troca fica no Registro do sistema e na trilha do contrato («de → para»). Na mesma janela fica **«Quando o aluguel é pago»**: *depois de usar* (o aluguel de agosto vence em setembro — o padrão) ou *antes de usar* (o de agosto vence em agosto). Ela decide o mês que cada boleto paga e, por ele, em qual boleto o reajuste entra (ver «Em qual boleto o reajuste entra», no capítulo Reajuste anual). Também vale só para as próximas cobranças. ## Alterar valor: corrigir no mesmo dia «Alterar valor» cria uma versão nova do contrato a partir de uma data. Se você criar duas na **mesma data**, a segunda corrige a primeira (errou o valor e percebeu na hora): não há recusa, e a troca de valores fica no Registro do sistema. Cobranças já geradas com o valor antigo não mudam; se precisar, cancele e gere de novo. ## O que é cada cobrança: o enquadramento legal Todo encargo e toda cobrança avulsa pedem agora **o que é esta cobrança**, numa lista: condomínio (ordinário ou extraordinário), consumo, IPTU, seguro contra incêndio, multa do contrato, taxa de elaboração do contrato, serviços ao inquilino (vistoria, segunda via de boleto, cópia de chave), reparo, reembolso, taxa de administração, intermediação ou taxa de cadastro, ou «Outra». Ao escolher, aparece a regra da Lei do Inquilinato (8.245/91) com o artigo, e o botão **?** abre o guia com todas. - **Do proprietário** (taxa de administração, intermediação, comissão, taxa de cadastro, condomínio extraordinário): o sistema **não deixa cobrar do inquilino**. Pode lançar como custo interno, descontado do repasse do proprietário. - **Só com cláusula no contrato** (IPTU, seguro contra incêndio, multa, taxa de elaboração do contrato combinada antes, serviços ao inquilino) ou **depende do caso** (reparo por dano ou falta de manutenção do inquilino, reembolso): você marca a confirmação, e ela fica no Registro do sistema. - **«Outra»**: passa, e fica registrado que não houve enquadramento. Se a descrição disser «taxa de cadastro», «comissão» ou «intermediação», o sistema recusa e pede a natureza certa. No contrato, a caução não pode passar de **3 aluguéis** e o reajuste não pode ser menor que **12 meses**. Multa de atraso acima de 10% ou juros acima de 1% ao mês não são recusados, mas o sistema avisa ao salvar. Os textos seguem a regra geral da lei, foram revisados por advogado e não substituem a orientação jurídica do seu caso. ## Encargo: quem paga Cada encargo do contrato tem um **«Quem paga»**. O padrão, *Inquilino*, soma o valor no boleto e avisa o inquilino, como sempre. A outra opção, *Proprietário — desconta do repasse*, é para custo que o proprietário assume, como um **seguro**: o valor **não entra** no boleto do inquilino nem aparece na composição da cobrança; sai do repasse do proprietário e vai ao destino (imobiliária ou terceiro). O inquilino não é avisado, porque a taxa não é dele; o Registro do sistema guarda o encargo interno e, a cada cobrança, quanto foi descontado do repasse. Um encargo já criado não muda de tipo: remova e crie de novo com a opção certa. **E a tarifa do boleto/Pix?** Não crie encargo para ela. A tarifa que o provedor (Asaas) cobra por cobrança recebida já sai **sozinha da parte da imobiliária** no repasse — o proprietário recebe a parte dele inteira, e o Registro do sistema mostra o desconto. Um encargo com a tarifa faria ela ser paga duas vezes. ## Desconto no aluguel por alguns meses Combinou um abatimento com o inquilino (obra, negociação de renovação, fidelização)? No contrato, menu **Cobrança → Desconto**: escolha se é *percentual do aluguel* ou *valor fixo*, por quantos meses, e o motivo (ele aparece na cobrança, no recibo e no portal do inquilino). O desconto vale a partir da **próxima cobrança gerada**; uma cobrança já emitida não muda. A cada emissão ele consome um mês e, no fim, o aluguel volta cheio sozinho. A taxa de administração incide sobre o aluguel já com desconto (a imobiliária divide o abatimento na proporção da taxa) e o proprietário recebe o resto; condomínio, IPTU e encargos não são descontados. Isso é o padrão, *«cada um na proporção da sua parte»*; o campo **«Quem absorve o desconto»** permite escolher *«só o proprietário»* (a taxa da imobiliária fica sobre o aluguel cheio) ou *«só a imobiliária»* (o repasse do proprietário não muda). O inquilino paga menos de qualquer jeito; aqui se decide de quem sai a diferença. O card do contrato mostra o desconto ativo, quantos meses restam e o total mensal já abatido, na hora. Dá para encerrar antes do prazo: as próximas saem sem ele. ## A trilha de cada contrato Entre a trilha de uma cobrança e o Registro do sistema inteiro há o nível que mais importa numa conversa com o proprietário ou o inquilino: o **contrato**. No card do contrato, o botão **«Trilha»** (ao lado de «Ver fluxo») abre tudo que aconteceu com ele e com cada cobrança dele, em ordem e com quem fez: versões de valor, encargos, descontos, cobranças geradas e pagas, repasses, e-mails. O **proprietário** tem o mesmo no portal dele, em «Histórico do contrato», só com o que lhe diz respeito (pagamentos, repasses, valores, descontos), sem o interno da imobiliária. ## Tudo fica no Registro do sistema Toda ação no Locarë deixa uma linha no **Registro do sistema** (o relógio ao lado do «?»): quem fez, quando e o que mudou. As mudanças que envolvem dinheiro dizem *de → para*: a chave Pix de uma pessoa (trocada por você na ficha ou pelo próprio cliente no portal) aparece mascarada, como «111…344 → 999…766»; a troca do dono de um imóvel, o contrato criado e cada nova versão de valores, os acessos criados, desligados ou com senha redefinida, os provedores configurados e os arquivos anexados. O que não tiver uma frase própria ainda assim é registrado, como «ação» com o método, a rota e os nomes dos campos enviados — nunca os valores. Se um dia alguém disser que o sistema mandou dinheiro para o lugar errado, a resposta está aqui. ## Recibo de repasse e «aguardando repasse» Todo repasse que sai — por Pix pelo sistema ou registrado à mão porque você transferiu por fora — gera um **recibo de repasse** em PDF, com o timbre da imobiliária: você o abre na cobrança (link «Recibo» ao lado do repasse enviado), o proprietário o baixa no portal dele, e ele ainda recebe um e-mail com o recibo anexo. Registrar um repasse feito por fora é o que faz esse recibo existir: dentro da cobrança, «Já repassei por fora» (todas as partes, com confirmação) ou, em «Repasse», pessoa a pessoa. Enquanto o repasse não sai, o sistema diz isso com todas as letras: na lista de Cobranças, ao lado de «Recebido», aparece **«aguardando repasse»** (ou «aguardando chave Pix», quando é a chave que falta, ou «repasse falhou»). No portal do proprietário a cobrança paga fica como **«Pago — aguardando repasse»**, com o total à parte, e só vira «Recebido» quando a parte dele sai de fato. A troca da chave Pix da imobiliária em Identidade também fica registrada no Registro do sistema. ## Repasse automático por Pix — inclusive a sua parte Quando a cobrança do aluguel é emitida, o sistema já programa os repasses por Pix a partir da repartição: a parte de cada **proprietário**, a do **corretor parceiro** e a **da própria imobiliária**. Elas saem sozinhas quando o dinheiro fica *disponível* na conta do gateway. Para a sua parte sair, cadastre a **chave Pix da imobiliária** em Configurações → Identidade; para a de cada pessoa, a chave Pix na ficha dela. Quem está sem chave não trava nada: o repasse fica **«aguardando chave Pix»** (pendência no painel) e sai sozinho quando a chave entra. Se o webhook do gateway falhar, a reconciliação diária confere a cobrança e dispara o repasse do mesmo jeito. **Atenção a quem é o beneficiário.** A pendência do painel diz o nome e onde cadastrar: *(pessoa — ficha em Pessoas)* ou *(a imobiliária — Configurações → Identidade)*. O gestor que também é dono de imóveis aparece duas vezes no sistema: como imobiliária (a taxa vai para a chave da Identidade) e como pessoa (o aluguel do dono vai para a chave da ficha dele em Pessoas). Cadastrar em um lugar não vale para o outro. Assim que a chave é salva, os repasses que esperavam por ela a recebem na hora e saem quando o pagamento cair. **Repasses em atraso.** Cobrança paga cujo repasse não saiu (emitida antes deste recurso, ou que ficou para trás) aparece no painel como «dinheiro parado no gateway» e no topo de Cobranças, com o total por beneficiário. Cada cobrança é uma **linha**, com o que falta a cada um (e o motivo, se um Pix falhou) e os botões dela: **Repassar** (manda por Pix, do saldo do provedor, só o que falta daquela) e **Já repassei por fora** (registra o que você já pagou no banco ou no painel do provedor — não transfere de novo, pede confirmação e manda o recibo). Marque as caixas e use **Repassar as marcadas**, ou **Repassar todas agora**. Cobrança apenas «confirmada» é conferida no gateway antes — se o saldo já caiu, sai; se não, espera. Tudo fica na trilha. **«Sua parte».** A parte da **própria imobiliária** (taxa, comissão) também fica no saldo do provedor até sair para a chave Pix da Identidade — por isso uma cobrança pode continuar na lista mesmo depois de você registrar o repasse do proprietário: o que sobrou é o **seu** dinheiro. A linha mostra «sua parte», com **Transferir para a minha conta** ou **Deixar no Asaas** (fica no saldo, sem saque, e sai da lista). Só entra na lista o que foi cobrado pelo Locarë e pago pelo gateway: dinheiro de cobrança feita fora do sistema sai pelo painel do próprio gateway. Atenção do lado do gateway: transferência Pix pela API exige a conta aprovada e a função liberada; num Asaas novo, teste com um valor pequeno primeiro. ## E-mail que ficou fora: a represa e a revisão Se o e-mail ficar fora por dias, as cobranças vão se acumulando sem aviso. Quando volta, a rotina **não despeja tudo de uma vez**: envia sozinha só o que vence no futuro ou venceu há até **3 dias**. O que venceu antes disso e nunca foi avisado fica **represado** — aparece no painel («cobranças antigas não foram avisadas por e-mail») e no topo de Cobranças, com a lista. Você confere se alguém já pagou por fora (dê a baixa nessas) e então **Enviar todas agora** ou **Descartar os avisos**; as duas decisões ficam na trilha com o seu nome. Foi o caso real de 10/09: o Gmail de uma imobiliária expirou por dias e, ao voltar, boletos antigos chegaram a inquilinos que já tinham pago por fora. ## O registro do sistema O relógio ao lado do «?» abre o **Registro do sistema**: tudo que a rotina fez sozinha (cobranças emitidas, e-mails enviados, falhas, trocas de provedor, backups) e tudo que alguém fez (baixas, perdões, reajustes, configurações), numa linha do tempo por dia, com filtros de período, origem (automático/feito por alguém), tipo e busca no texto. É a mesma trilha que cada cobrança já tinha, vista de cima: só cresce, nada é editado nem apagado. Muita coisa no Locarë é automática — aqui nada fica no escuro. ## Mais de um provedor de e-mail: a fila de tentativa Você pode configurar **mais de um** provedor de e-mail (SMTP próprio, Resend, Gmail) — cada um guarda as suas credenciais, e eles formam uma **fila**, mostrada em Serviços como «1º, 2º, 3º». O 1º envia; se ele falhar, o sistema tenta o próximo; se todos falharem, o e-mail sai «via Locarë» (abaixo). O provedor que falhou fica marcado em Serviços e no painel, para você consertar — os e-mails não pararam, mas o aviso é real. Use ▲ para subir um provedor na fila e × para tirá-lo. **O Gmail fica na fila mesmo sem ser o 1º**: é a conta dele que o backup no Drive usa, então você pode enviar pelo seu servidor e manter o backup no Google. ## Sem provedor de e-mail? As mensagens saem «via Locarë» Enquanto você não conecta um provedor próprio (Gmail, Resend ou SMTP), as cobranças, avisos e comunicações **não param**: saem pelo remetente *no-reply* do Locarë, com o **nome da sua imobiliária** no remetente e um rodapé fixo: «Mensagem automática enviada pelo Locarë em nome de … **Não responda a este e-mail** — para falar com a imobiliária: telefone/WhatsApp e e-mail do seu cadastro». Ninguém lê respostas a esse endereço, por isso o rodapé aponta os seus canais. Em Serviços, o cartão E-mail mostra o selo **«via Locarë (padrão)»**. > **Cota de 30 e-mails por mês** — O envio pelo Locarë serve para você começar: são **30 e-mails por mês**. A pendência em Configurações mostra quantos já saíram, e a partir de 80% ela avisa. Passou da cota, **só as cobranças continuam saindo**; lembretes de atraso, recibos de repasse e avisos de nova taxa esperam você conectar o seu e-mail. O link de primeiro acesso e a recuperação de senha não contam na cota. O jeito mais fácil de conectar é o **Gmail (conta Google)**, em um clique. ## E-mail: o domínio precisa ser verificado A chave de API sozinha não basta. O Resend só entrega para outras pessoas depois que um **domínio** da imobiliária estiver verificado no painel dele — e verificar exige mexer no DNS desse domínio. 1. No Resend, vá em **Domains** e adicione o domínio da imobiliária (por exemplo `suaimobiliaria.com.br`). 2. O Resend mostra alguns registros de DNS. Peça a quem cuida do domínio para incluí-los, ou inclua você se tiver acesso. 3. Espere o domínio aparecer como **verificado**. 4. No Locarë, em **Remetente**, escreva o **endereço inteiro** — por exemplo `cobranca@suaimobiliaria.com.br`, não só o domínio. 5. Em **Nome do remetente**, o nome da imobiliária: é o que o inquilino vê na caixa de entrada. > **Para testar antes de ter domínio verificado** — O Resend deixa enviar de `onboarding@resend.dev` sem verificar nada — mas **só para o e-mail do dono da conta**. Serve para conferir que a chave funciona; não serve para cobrar inquilino. ## Cloudinary: qual chave gerar > **Guia passo a passo, com prints** — Da criação da conta à chave e ao teste: [abrir o guia do Cloudinary](https://app.locareapp.com/ajuda/guia-cloudinary.md). Ele também está no cartão do Cloudinary, em Configurações → Serviços → Arquivos. O Cloudinary é uma das opções para guardar contratos, fotos e vistorias. A conta é da imobiliária — cada uma usa a sua, e a cota não é dividida com ninguém. ### O jeito mais fácil: Conectar Cloudinary Em **Configurações → Serviços → Arquivos**, escolha **Cloudinary**, digite o **Cloud name** (o nome no alto do menu do painel do Cloudinary) e clique em **Conectar Cloudinary**. Faça login no Cloudinary, se ele pedir, e clique em **Accept access**. Você volta ao Locarë com a conexão pronta e testada. Não há chave para gerar nem papel para escolher, e o Locarë não guarda nenhuma chave de API. > **Deixou de funcionar?** — A conexão se renova sozinha. Se o cartão disser que ela expirou, por exemplo porque o acesso foi revogado no Cloudinary, clique em **Reconectar**. Seus arquivos continuam na conta, intactos. ### Com chave de API Se preferir, abra **Prefiro usar API Key e API Secret** no mesmo cartão: 1. No painel do Cloudinary, vá em **Settings → API Keys** e clique em **Generate New API Key**. 2. Dê um nome que você reconheça depois, como `Locare`. 3. Em **Roles**, escolha **Master Admin**. 4. Copie o **Cloud name**, a **API Key** e o **API Secret** para a tela de Configurações → Serviços → Arquivos. 5. Clique em **Testar conexão** antes de sair. > **Media Library User não funciona** — É o papel que o Cloudinary oferece ao lado, e o nome parece o certo. Mas ele **não permite enviar nem apagar arquivos** — a chave é aceita, e falha no primeiro anexo. Chave nova também nasce **sem permissão nenhuma**: o papel precisa ser escolhido na hora de gerar. > > Se o seu plano oferecer **Tech Admin** ou **Media Library Admin**, prefira um deles: fazem o que o Locarë precisa com menos poder. No plano gratuito, só existe Master Admin. > **Master Admin é uma chave poderosa** — Ela alcança a conta inteira do Cloudinary, não só o que o Locarë guarda. Por isso: use uma chave **dedicada ao Locarë**, com nome próprio, e não a mesma de outro sistema. Assim, se um dia precisar revogar, você revoga só esta — sem derrubar mais nada. > **O botão Testar resolve a dúvida** — Ele não checa só a credencial: **grava um arquivo, lê de volta, compara e apaga**. Se o papel estiver curto, você descobre ali — e não no dia em que alguém anexar o primeiro contrato. O sistema não guarda dinheiro, não envia e-mail e não armazena arquivo por conta própria: ele usa serviços que **cada imobiliária contrata**, com as credenciais dela. É o primeiro trabalho de quem recebe um acesso novo, e o sistema leva você direto a esta tela no primeiro login. > **Nada disso impede o sistema de funcionar** — Você pode cadastrar pessoas, imóveis e contratos, e acompanhar tudo, **antes** de configurar qualquer serviço. O que falta são as funções que dependem deles — anexar arquivo, mandar e-mail, emitir boleto — e cada uma diz, no momento em que você tentar, o que resolver. > > Nenhuma delas trava a tela: a ficha do imóvel continua abrindo sem o cofre de arquivos, e a notificação continua sendo preparada sem o e-mail. | Serviço | Para quê | Opções | | --- | --- | --- | | **Pagamento** | receber o aluguel e dividir o valor | Asaas (recomendado, em produção), Mercado Pago (sem split; repasse por Pix depois da liberação), Boleto do meu banco — veja [Situação de cada provedor](https://app.locareapp.com/ajuda/provedores.md) | | **E-mail** | mandar a cobrança e a notificação | Gmail / conta Google (mais simples, sem domínio), Resend (com domínio próprio), servidor SMTP próprio | | **Arquivos** | guardar contrato, vistoria e foto | S3 / Cloudflare R2 (recomendado), Cloudinary, disco | > **Segredo não volta para a tela** — Chaves de API são cifradas antes de gravar e nunca são exibidas de novo — a tela mostra apenas "configurado". Deixar o campo em branco ao salvar **preserva** o que já estava lá. > > Nem quem administra a plataforma digita ou vê essas chaves: elas são cadastradas aqui, por você, e ficam cifradas no banco. ## Testar não é opcional Cada serviço tem um botão **Testar**, e ele faz o percurso inteiro — no armazenamento, por exemplo, grava um arquivo, lê de volta, compara e apaga. Testar só a credencial diria que a chave é válida e deixaria passar uma conta sem permissão de escrita, ou um plano estourado. > **Gravar não é guardar** — Se você escolher **disco** e o sistema estiver hospedado em contêiner, o teste *reprova de propósito*: a pasta aceita a escrita, mas os arquivos somem na próxima atualização do serviço. Um contrato digitalizado guardado ali está perdido antes de alguém precisar dele. > **O que falta acompanha você em todas as telas** — Enquanto houver serviço por configurar ou reprovado no teste, uma faixa aparece no topo de qualquer aba dizendo o que é — com um atalho para resolver. Ela some sozinha quando não há mais nada pendente. > > Antes, esse aviso vivia só aqui dentro: quem não sabia que precisava configurar nunca abria esta tela, e descobria pelo pior caminho — o inquilino não recebeu a cobrança, o documento sumiu. ## Duas coisas que atrasam, e por isso valem ser resolvidas cedo - **O e-mail exige domínio próprio.** Serviços como o Resend pedem verificação do domínio, com alguns registros de DNS. Sem domínio, não há como enviar cobrança em nome da imobiliária. - **A conta de pagamento leva dias.** Abrir subconta exige CNPJ e aprovação do provedor — por isso o sistema mostra o estado dela (*pendente* até ser *aprovada*) em vez de um sim ou não. ## Mais de um provedor de pagamento ao mesmo tempo O cartão de **Pagamento** aceita **vários provedores configurados juntos** — cada um com a própria chave de API e a própria URL de webhook. O primeiro configurado vira o **padrão**; os chips Provedores ativos mostram quem está ligado, e dali você troca o padrão ou remove um (remover é recusado enquanto houver contrato preso a ele). - **Por contrato:** ao criar um contrato (ou no diálogo de locação), aparece um seletor de provedor quando há dois ou mais configurados. Sem escolha, vale o padrão. - **A cobrança lembra quem a emitiu:** cada cobrança sai carimbada com o provedor, e toda operação posterior — cancelar, remarcar, registrar pagamento — fala com *ele*, mesmo que o padrão tenha mudado depois. - **O Provedor de cobrança aparece sempre no contrato** (diálogo Locação): com um provedor só, informa qual é; com dois ou mais, vira a escolha por contrato. É diferente da Forma de pagamento (cláusula da minuta) — essa é o texto legal do contrato, não o gateway. - **Webhook:** cada provedor tem a própria URL do webhook, com a chave dele embutida — copie a de cada um para o painel dele, e o sistema descobre de quem veio o aviso. ## Test-drive (modo de ensaio) **No primeiro acesso, o modo de ensaio já vem ligado** — o sistema monta o mundo de teste sozinho, para você cair direto na demonstração e ver tudo funcionando. Uma barra vermelha fixa no topo, em qualquer tela, traz os atalhos para ver os portais (inquilino, proprietário, corretor e, com o condomínio de exemplo, o síndico) e o botão **Encerrar o ensaio**. Ao encerrar, tudo é apagado e essa oferta automática **não volta** — se quiser rever depois, é só reativar na aba Apresentação. Em **Configurações → Apresentação** (aba separada, longe das configs de terceiros) existe o **modo de ensaio**: um mundo de mentira montado na sua própria carteira para você ver *tudo* funcionando antes de arriscar um dado real. Ao ativar, você escolhe a taxa de administração e a fração do corretor, e o sistema cria: dois imóveis com fachadas ilustradas (um alugado, um vago), um contrato ativo, um inquilino, um proprietário e um corretor — **os três com login no portal**, com senha fixa exibida na tela (persona de teste não tem segredo) — e duas cobranças: uma já paga (com recibo e o split das três partes) e uma em aberto, **pagável com um clique**. Vem também um **condomínio de exemplo**, o «Residencial Exemplo», com 4 unidades (a 101 é o apartamento alugado de teste), despesas, cotas do mês passado quase todas pagas e as deste mês em aberto, salão de festas e churrasqueira com reservas, mural, uma assembleia marcada e o **síndico de teste**, que também entra no portal (botões «Síndico» na barra vermelha e «Ver como o síndico»). E uma **garagem de exemplo**, o «Edifício Exemplo», com 8 vagas em duas entradas: a inquilina de teste com o carro dela, uma picape numa vaga média (o aviso vermelho), duas motos dividindo a vaga de moto, uma vaga liberando no fim do mês, outra reservada para o mês que vem, uma com dono próprio, uma indisponível (pilar) e o histórico na linha do tempo. Quem já estava com o ensaio ligado ganha o condomínio e a garagem de exemplo ao abrir o painel do ensaio. **Tudo que é de teste fica com moldura vermelha**, e as telas agregadas (Relatórios, Calendário, Consolidação) ganham fundo vermelho com a etiqueta de que os números incluem os dados de teste. Nada disso usa o seu gateway real, conta na sua mensalidade ou dispara e-mail. Os botões Ver como… abrem o portal *já logado* como cada persona; **Encerrar o ensaio** apaga tudo de uma vez e a carteira volta ao que era. O imóvel alugado do ensaio também vem com a **manutenção** e a **luz, água e gás** em uso, para você ver essas telas funcionando: quatro chamados (um **urgente** aberto pelo inquilino há dias, um **atrasado**, um **orçamento** esperando o proprietário aprovar no portal dele e um **resolvido** com custo), uma **manutenção programada** e a **UC** de luz e a matrícula de água com a **troca de titularidade** a fazer. A **Atenção** do Painel, a **📅 Agenda**, os **Relatórios** e a aba **Luz, água e gás** ganham conteúdo. Se a Manutenção ou a Luz, água e gás estiverem desligadas, o ensaio as liga para a demonstração e, ao encerrar, desliga de novo (a menos que você já tenha passado a usá-las de verdade). > **Teste e verdade não se misturam** — Os itens de teste (os imóveis e as pessoas «Exemplo») **não aparecem** na hora de criar um contrato de verdade, e o sistema recusa ligá-los a um cadastro real. Se algum cadastro de verdade já estiver usando um item de teste, o **Encerrar o ensaio** mostra a lista antes: ele **sai junto** com o teste. Se for de verdade, cancele e refaça-o com imóvel e pessoas de verdade antes de encerrar. ## Cópia de segurança A aba **Cópia de segurança** (entre Apresentação e Assinatura) reúne tudo do backup da sua carteira: **baixar a cópia** cifrada, a **senha de backup**, o **lembrete** no painel, o envio **automático ao Google Drive** e a **reposição**. É o mesmo conteúdo de antes — ele só mudou de endereço: morava na tela de **Acessos**, e backup é configuração da imobiliária, não gestão de contas. A aba aparece para quem tem a permissão de backup, e o funcionamento está descrito na [seção 20](https://app.locareapp.com/ajuda/backup.md). ## Modelos de documentos A aba **Modelos de documentos** reúne todos os textos que o sistema emite, para não ficarem espalhados pela configuração: a **Minuta de locação** (uma *residencial*, outra *comercial* e a da *vaga de garagem*), o **Termo de distrato** e a **Notificação extrajudicial**. Cada um abre no próprio editor, com um **selo** dizendo se está confirmado, sem confirmação, ou *editado após a confirmação*. Dentro de cada modelo: o texto — que já vem escrito e sóbrio —, a lista de **marcadores** disponíveis (`{multa}`, `{nome_locador}`…) e o registro da confirmação do advogado, com nome e OAB. > **Sem a confirmação do advogado, o documento não sai** — **Encerrar contrato** fica bloqueado sem o Termo de distrato confirmado, e a **notificação** não é enviada sem a dela. As minutas usam o mesmo selo — a prévia continua abrindo para você conferir, mas o texto é do advogado da imobiliária adaptar e confirmar. > > E **editar o texto derruba a confirmação** — é para derrubar mesmo: aprovar uma versão e emitir outra é pior que não ter aprovação nenhuma. O sistema distingue "nunca confirmado" de "confirmado e editado depois", e o segundo aparece com aviso mais forte, porque alguém já respondeu por um texto que não é mais esse. > **Marcador que o sistema não conhece impede a emissão** — Se você escrever `{mutla}` em vez de `{multa}` num modelo próprio, o sistema recusa em vez de deixar sair em branco. Num documento assinado, um campo vazio vale contra quem assinou. (Já um campo do cadastro que ainda falta — marcador certo, sem valor — apenas *some* do texto impresso; veja a prévia na [seção 5](https://app.locareapp.com/ajuda/contratos.md).) Cada confirmação é **independente**: o distrato, a notificação ([seção 13](https://app.locareapp.com/ajuda/notificacao.md)) e cada minuta são documentos com efeitos diferentes, e o advogado lê um de cada vez. --- Central de Ajuda Locarë · revisão de 23/10/2026 · versão para pessoas: https://app.locareapp.com/manual