Pular para o conteúdo principal

Explicon

Explicon› Blog› Ainda cobra XML de um cliente por vez? Automatize os lembretes pelo Gmail

Ainda cobra XML de um cliente por vez? Automatize os lembretes pelo Gmail

Aprenda a configurar a cobrança automática de XML no Gmail com Google Planilhas e Apps Script. Envie lembretes aos clientes todo dia 1º e registre os envios.

Envelope com um arquivo XML e calendário marcando o dia 1º para a cobrança automática de XML pelo Gmail.

A cobrança automática de XML ajuda o escritório contábil a começar o fechamento fiscal sem redigir o mesmo e-mail para cada cliente. Neste passo a passo, você vai configurar o Gmail para solicitar, no dia 1º de cada mês, os arquivos XML das notas fiscais de venda do mês anterior. O roteiro também ensina a testar a mensagem no seu próprio e-mail e a conferir quais solicitações foram enviadas.

Como funciona a cobrança automática de XML?

A rotina usa três ferramentas. O Google Planilhas guarda o cadastro dos clientes. O Apps Script lê a lista, monta a mensagem e anota a data de envio. A conta Gmail do escritório é usada como remetente. O modelo cabe em uma conta Google gratuita, sujeito aos limites de envio do Apps Script, e dispensa n8n e inteligência artificial. Limites de uso do Apps Script

O prazo até o dia 5 é uma data de entrega combinada com os clientes neste exemplo. A equipe acompanha quem respondeu e confere se os arquivos recebidos cobrem o mês solicitado. A coluna Último envio indica o disparo do lembrete. Para acompanhar o recebimento dos XML, use o controle de documentos do escritório.

1. Monte o cadastro dos clientes

Crie uma planilha chamada Automação de XML – Contabilidade. Renomeie a primeira aba para CLIENTES e preencha a primeira linha com os títulos da tabela. Na segunda linha, use uma empresa fictícia e um endereço de e-mail do próprio escritório para o teste.

ABCDE
EmpresaResponsávelEmailAtivoÚltimo envio
Empresa TesteBrunoseuemail@gmail.comSIM

As letras da tabela são as referências das colunas, que já aparecem na planilha. Cadastre uma linha por empresa e um único endereço de e-mail por linha. Use SIM para incluir a empresa e NÃO para pausar os lembretes daquele cliente. Deixe a coluna Último envio vazia no cadastro. Depois, você pode formatá-la para exibir a data como dd/MM/aaaa.

2. Cole o código no Apps Script

Na planilha, vá a Extensões → Apps Script. Abra o arquivo Código.gs e, no projeto novo, substitua a função de exemplo pelo código abaixo. O projeto fica vinculado à planilha que você abriu. Guia do Google sobre scripts vinculados

No início do código, personalize EMAIL_TESTE e NOME_ESCRITORIO. A versão abaixo usa MailApp, o serviço do Apps Script voltado ao envio de e-mails. A anotação @OnlyCurrentDoc restringe o acesso à planilha vinculada. Documentação do MailApp · Permissões do Apps Script

/** @OnlyCurrentDoc */

const MODO_TESTE = true;
const EMAIL_TESTE = 'seuemail@gmail.com';
const NOME_ESCRITORIO = 'Seu Escritório Contábil';

function enviarXMLClientes() {
  const emailValido = /^[^\s@,;<>]+@[^\s@,;<>]+\.[^\s@,;<>]+$/;
  const emailTeste = EMAIL_TESTE.trim();

  if (MODO_TESTE && (!emailValido.test(emailTeste) || emailTeste === 'seuemail@gmail.com')) {
    throw new Error('Informe seu próprio e-mail em EMAIL_TESTE.');
  }

  // Evita sobreposição entre o acionador e uma execução manual.
  const bloqueio = LockService.getScriptLock();
  bloqueio.waitLock(10000);

  try {
    const planilha = SpreadsheetApp.getActiveSpreadsheet();
    const aba = planilha.getSheetByName('CLIENTES');

    if (!aba) {
      throw new Error('Crie uma aba chamada CLIENTES na planilha.');
    }

    const ultimaLinha = aba.getLastRow();
    if (ultimaLinha < 2) {
      console.log('Nenhum cliente cadastrado.');
      return;
    }

    const agora = new Date();
    const fuso = Session.getScriptTimeZone();
    const mesAtual = Utilities.formatDate(agora, fuso, 'yyyy-MM');
    const [ano, mes] = mesAtual.split('-').map(Number);
    const mesAnterior = new Date(Date.UTC(ano, mes - 2, 1));
    const competencia = Utilities.formatDate(mesAnterior, 'UTC', 'MM/yyyy');
    const prazo = Utilities.formatDate(agora, fuso, "'05/'MM/yyyy");

    const clientes = aba.getRange(2, 1, ultimaLinha - 1, 5).getValues();
    let saldoDeEnvio = MailApp.getRemainingDailyQuota();
    let enviados = 0;
    let pendencias = 0;

    for (const [indice, cliente] of clientes.entries()) {
      const [empresa, responsavel, email, ativo, ultimoEnvio] = cliente;
      const linha = indice + 2;
      const nomeEmpresa = String(empresa).trim();

      if (!nomeEmpresa || String(ativo).trim().toUpperCase() !== 'SIM') {
        continue;
      }

      if (!MODO_TESTE && ultimoEnvio instanceof Date &&
          Utilities.formatDate(ultimoEnvio, fuso, 'yyyy-MM') === mesAtual) {
        continue;
      }

      if (!MODO_TESTE && ultimoEnvio !== '' && !(ultimoEnvio instanceof Date)) {
        console.error(`Linha ${linha}. Confira o registro em Último envio.`);
        pendencias++;
        continue;
      }

      const destinatario = MODO_TESTE ? emailTeste : String(email).trim();
      if (!emailValido.test(destinatario)) {
        console.error(`Linha ${linha}. Corrija o endereço de e-mail.`);
        pendencias++;
        continue;
      }

      if (saldoDeEnvio < 1) {
        console.error('Cota diária esgotada. Confira as linhas ainda sem envio.');
        pendencias++;
        break;
      }

      const nomeResponsavel = String(responsavel).trim();
      const saudacao = nomeResponsavel ? `Olá, ${nomeResponsavel}!` : 'Olá, tudo bem?';
      const prefixo = MODO_TESTE ? '[TESTE] ' : '';
      const assunto = `${prefixo}XML de vendas de ${competencia} — ${nomeEmpresa}`;
      const mensagem = [
        saudacao,
        `Estamos iniciando o fechamento fiscal de ${competencia}. Pode encaminhar os arquivos XML das notas fiscais de venda emitidas nesse mês?`,
        'Se a empresa usa mais de um emissor, inclua os arquivos de todos os sistemas.',
        `Pedimos o envio até ${prazo}, pelo canal combinado com o escritório.`,
        'Se você já encaminhou os arquivos, pode desconsiderar este lembrete.',
        `Atenciosamente,\n${NOME_ESCRITORIO}`
      ].join('\n\n');

      const registro = aba.getRange(linha, 5);

      try {
        if (!MODO_TESTE) {
          // Sinaliza uma tentativa antes de enviar para evitar reenvios no escuro.
          registro.setValue(`EM REVISÃO ${mesAtual}`);
          SpreadsheetApp.flush();
        }

        saldoDeEnvio--;
        MailApp.sendEmail(destinatario, assunto, mensagem);
        enviados++;

        if (!MODO_TESTE) {
          registro.setValue(agora);
          SpreadsheetApp.flush();
        }
      } catch (erro) {
        console.error(`Linha ${linha}. Falha no envio ou no registro: ${erro.message}`);
        pendencias++;
      }

      if (MODO_TESTE) {
        break;
      }
    }

    console.log(`Envios aceitos pelo serviço: ${enviados}. Ocorrências para revisar: ${pendencias}.`);
    if (pendencias > 0) {
      throw new Error('Há ocorrências para revisar. Abra Execuções para ver os detalhes.');
    }
    if (MODO_TESTE && enviados === 0) {
      console.log('Ative uma linha de teste com SIM e preencha o nome da empresa.');
    }
  } finally {
    bloqueio.releaseLock();
  }
}

O modo de teste usa a primeira empresa ativa para montar uma única mensagem. Em operação, o código envia um e-mail por empresa ativa e pula as linhas que já têm uma data de envio no mês corrente. O bloqueio evita que duas execuções do mesmo projeto processem a lista ao mesmo tempo. Documentação do Lock Service

3. Teste com o seu próprio endereço

  1. Mantenha MODO_TESTE = true e salve o código.
  2. Selecione a função enviarXMLClientes na barra do editor e clique em Executar.
  3. Na primeira execução, escolha a conta Google que será a remetente e revise as permissões apresentadas para o projeto que você criou. Se a organização bloquear o acesso, confirme com o administrador do Google Workspace.
  4. Confira a caixa de entrada do endereço definido em EMAIL_TESTE. Se necessário, consulte o spam e a seção Execuções do Apps Script.

O assunto começa com [TESTE]. Confira o nome da empresa, o mês solicitado, o prazo e a assinatura. A coluna Último envio deve continuar vazia. O registro de data começa no primeiro disparo real.

4. Agende o lembrete para o dia 1º

Abra Configurações do projeto no Apps Script e ajuste o fuso horário. Para um escritório no Ceará, use o fuso de Fortaleza (America/Fortaleza). Em outras regiões, escolha o fuso local do escritório. No Google Planilhas, confira o mesmo fuso em Arquivo → Configurações. Isso alinha a data registrada na planilha com a competência usada no e-mail. Fuso horário do projeto · Configurações do Google Planilhas

Depois de validar a mensagem, retire a linha fictícia, revise os e-mails reais, altere para MODO_TESTE = false e salve. No menu lateral do Apps Script, abra Acionadores pelo ícone de relógio e clique em Adicionar acionador.

CampoSelecione
Função a ser executadaenviarXMLClientes
Origem do eventoBaseado em tempo
Tipo de acionadorMensal
Dia do mês1
Horário08h às 09h

Salve um único acionador usando a conta que o escritório quer como remetente. O Google executa a tarefa na conta que criou o acionador, dentro da faixa escolhida. Guia de acionadores instaláveis do Google

Atenção. Com MODO_TESTE = false, clicar em Executar dispara os e-mails na hora para as empresas elegíveis. Para aguardar o agendamento, basta salvar o código e o acionador.

Exemplo prático de um fechamento mensal

Em 1º de janeiro de 2027, o escritório fictício solicita à Loja Horizonte os XML das vendas de dezembro de 2026. O e-mail chega com o assunto XML de vendas de 12/2026 — Loja Horizonte e pede os documentos até 05/01/2027. A equipe confere o registro do disparo no dia 1º, acompanha as respostas entre os dias 2 e 4 e verifica as pendências no dia 5.

Se a equipe executar a rotina novamente em janeiro, a linha da Loja Horizonte será pulada quando a data do primeiro envio já estiver registrada. Se a empresa estiver com NÃO na coluna Ativo, ela fica fora do lote.

O que o contador precisa fazer?

  1. Definir a conta remetente, o canal de recebimento e o prazo interno para os clientes.
  2. Validar os contatos e manter uma linha por empresa. Restrinja a edição da planilha à equipe responsável.
  3. Testar com uma empresa fictícia e conferir o mês, a assinatura e a chegada do e-mail.
  4. Ativar o envio real e criar o acionador mensal na conta escolhida.
  5. Conferir o primeiro disparo em Execuções e comparar os registros da planilha com as respostas dos clientes.
  6. Resolver as linhas pendentes antes de repetir um envio e conferir quais documentos ainda faltam no dia 5.

Perguntas frequentes

Preciso manter o computador ligado?

O acionador roda nos servidores do Google, mesmo com o navegador fechado e o computador desligado. Guia de acionadores instaláveis do Google

Quantos clientes posso incluir usando uma conta gratuita?

O Google informa uma cota de 100 destinatários de e-mail por dia para contas pessoais no Apps Script. O código consulta o saldo antes do lote, que pode ser menor se a conta já tiver feito outros envios por script. Se a cota acabar, confira as linhas restantes e só faça uma nova execução depois de verificar o saldo e se o prazo da mensagem ainda faz sentido. Cotas do Apps Script

O que fazer se aparecer “EM REVISÃO” na planilha?

O marcador indica que a tentativa começou, mas a rotina não conseguiu confirmar e registrar a data. Abra Execuções para ver a linha e o erro. Se confirmar que a mensagem foi enviada, preencha a coluna com a data do envio. Se confirmar que a mensagem não saiu, corrija a causa, limpe a célula e avalie rodar de novo ainda no mesmo mês. Enquanto o marcador estiver na célula, a linha fica fora dos próximos disparos. Como consultar falhas em acionadores

Posso mudar o prazo ou pedir outros documentos?

Sim. O dia de envio é definido no acionador. O prazo do cliente aparece na variável prazo, onde '05/' representa o dia 5. Você pode ajustar as variáveis assunto e mensagem para solicitar extratos, relatórios ou outros arquivos. Sempre confira uma mensagem de teste depois da alteração.

Comece pelo próximo fechamento

Faça o primeiro teste com um cadastro fictício e confira o e-mail como se você fosse o cliente. Quando o acionador assumir o lembrete mensal, a equipe pode concentrar o acompanhamento nas empresas que ainda têm documentos pendentes.

Quer organizar outros lembretes e solicitações recorrentes do escritório? Veja mais exemplos de automação na contabilidade na Explicon.

Veja também

Fontes e referências

Leia também

Ver todos os conteúdos →
Contabilidade na Prática

Perdão do MEI em 2027: qual parte do DAS entra e como fica a aposentadoria?

Entenda o perdão do MEI em 2027, quais parcelas do DAS atrasado entram na medida, como fica o parcelamento e o que…

Ler artigo →
Contabilidade na Prática

Honorários contábeis com IA: seu preço paga o trabalho do escritório?

Analise seus honorários contábeis com IA: copie um prompt para organizar horas, custos e margem por cliente e identificar pontos de atenção…

Ler artigo →
Contabilidade na Prática

Perdão de dívidas do MEI: quem tem direito e como manter o benefício em 2027

Entenda quem tem direito ao perdão de dívidas do MEI em 2027, quais débitos entram no benefício e os cuidados para evitar…

Ler artigo →

Transforme informação tributária em decisão prática.

Use a Central da Reforma Tributária da Explicon para acompanhar mudanças, consultar ferramentas e encontrar os próximos conteúdos.

Voltar para a Central