seabeck.pages.dev

Como criar função personalizada de CEP no Google Sheets?

Validar e formatar CEPs manualmente no Google Sheets pode ser tedioso e propenso a erros. Com uma função personalizada, você automatiza esse processo em segundos, garantindo consistência e precisão nos dados.

Pré-requisitos

Criando a função personalizada de CEP

O Google Sheets permite criar funções personalizadas usando o Google Apps Script. Siga os passos abaixo para implementar uma função que valida e formata CEPs brasileiros.

function CEP(cep) {
  // Remove caracteres não numéricos
  cep = cep.toString().replace(/\D/g, '');

  // Verifica se o CEP tem 8 dígitos
  if (cep.length !== 8) {
    return 'CEP inválido';
  }

  // Formata o CEP como 00000-000
  return cep.slice(0, 5) + '-' + cep.slice(5);
}

Implementando a função no Google Sheets

Para adicionar a função ao seu planilha, siga estes passos:

  1. Abra seu Google Sheets
  2. Vá para Extensões > Apps Script
  3. Cole o código acima no editor
  4. Clique em Salvar e depois em Executar
  5. Autorize o script quando solicitado
  6. Feche a aba do Apps Script e retorne à planilha

Exemplo Prático

CEP Original Função CEP() Resultado
12345678 =CEP(A2) 12345-678
12345-678 =CEP(A3) 12345-678
1234567 =CEP(A4) CEP inválido
12.345-678 =CEP(A5) 12345-678

Função avançada com validação de endereço

Para uma função mais completa que consulta a API dos Correios, use o seguinte código:

function CEP_COMPLETO(cep) {
  cep = cep.toString().replace(/\D/g, '');
  
  if (cep.length !== 8) {
    return 'CEP inválido';
  }

  // Exemplo de chamada à API (requer configuração adicional)
  // var response = UrlFetchApp.fetch('https://viacep.com.br/ws/' + cep + '/json/');
  // var data = JSON.parse(response.getContentText());
  // return data.logradouro + ', ' + data.bairro + ' - ' + data.localidade;

  return cep.slice(0, 5) + '-' + cep.slice(5);
}

Conclusão

Com estas funções personalizadas, você transforma a validação e formatação de CEPs em um processo automático e confiável. A função básica já resolve a maioria dos casos, enquanto a versão avançada pode ser expandida para consultas via API, integrando informações completas de endereço diretamente na sua planilha.