
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.
| A | B | C | D | E |
|---|---|---|---|---|
| Empresa | Responsável | Ativo | Último envio | |
| Empresa Teste | Bruno | seuemail@gmail.com | SIM |
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
- Mantenha
MODO_TESTE = truee salve o código. - Selecione a função
enviarXMLClientesna barra do editor e clique em Executar. - 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.
- 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.
| Campo | Selecione |
|---|---|
| Função a ser executada | enviarXMLClientes |
| Origem do evento | Baseado em tempo |
| Tipo de acionador | Mensal |
| Dia do mês | 1 |
| Horário | 08h à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?
- Definir a conta remetente, o canal de recebimento e o prazo interno para os clientes.
- Validar os contatos e manter uma linha por empresa. Restrinja a edição da planilha à equipe responsável.
- Testar com uma empresa fictícia e conferir o mês, a assinatura e a chegada do e-mail.
- Ativar o envio real e criar o acionador mensal na conta escolhida.
- Conferir o primeiro disparo em Execuções e comparar os registros da planilha com as respostas dos clientes.
- 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
- Como reduzir o retrabalho contábil com um prompt para organizar pendências
- Agente de IA na contabilidade: como funciona e como montar o primeiro
Fontes e referências
- Google for Developers — Scripts vinculados, permissões do Apps Script e fuso horário do projeto.
- Google for Developers — MailApp, cotas do Apps Script e Lock Service.
- Google for Developers — Acionadores instaláveis.
- Ajuda do Google — Configurações do Google Planilhas.