Pular para o conteúdo principal

Enderecos

O Address (Endereco) armazena informacoes de localizacao dos clientes, utilizado para entregas, faturamento e integracao com servicos de geolocalizacao.

Descricao​

Cada cliente pode ter multiplos enderecos cadastrados. O sistema integra com servicos de CEP para preenchimento automatico e calcula distancias para validacao de areas de entrega.

Dados​

Campos Obrigatorios​

CampoTipoDescricao
zip_codeCEPCEP (formato: XXXXX-XXX)
streetTextoLogradouro (rua, avenida)
street_numberTextoNumero (ou "s/n")
neighborhoodTextoBairro
cityTextoCidade
stateSelecaoEstado (UF)

Campos Opcionais​

CampoTipoPadraoDescricao
complementTexto-Complemento (apto, bloco)
countryTextoBrasilPais
defaultBooleanofalseSe e o endereco padrao

Campos Calculados​

CampoDescricao
short_addressEndereco resumido para exibicao
city_stateCidade/UF formatado
latLatitude (geolocalizacao)
lngLongitude (geolocalizacao)

Campos de Delivery​

CampoDescricao
delivery_areaArea de entrega vinculada
km_distanceDistancia da loja em km

Relacionamentos​

Pertence a​

EntidadeDescricao
accountConta (multi-tenant)
customerCliente dono do endereco
delivery_areaArea de entrega (se aplicavel)

Integracao com CEP (ViaCEP)​

Preenchimento Automatico​

Ao informar o CEP, o sistema consulta a API ViaCEP:

Mapeamento de Campos​

Campo ViaCEPCampo Address
logradourostreet
bairroneighborhood
localidadecity
ufstate

Comportamento​

  1. CEP deve ter 8 digitos para disparar consulta
  2. Se API falhar, campos ficam editaveis manualmente
  3. Usuario pode corrigir dados preenchidos

Endereco Padrao​

Regra de Unicidade​

Cada cliente pode ter apenas um endereco padrao:

Uso do Endereco Padrao​

UsoDescricao
FaturamentoUsado em notas fiscais
DeliverySugerido como destino
CacheArmazenado no cliente para acesso rapido

Sincronizacao​

Ao alterar o endereco padrao:

  1. Sistema atualiza o cliente
  2. Campo default_address do cliente e atualizado
  3. Mudancas refletem em notas fiscais futuras

Geolocalizacao​

Calculo de Coordenadas​

Coordenadas sao calculadas automaticamente:

  1. Monta endereco completo
  2. Consulta servico de geocoding
  3. Armazena lat/lng

Formato do Endereco para Geocoding​

{street}, {number}, {neighborhood}, {city}, {state}

Uso das Coordenadas​

UsoDescricao
Calculo de distanciaDistancia ate a loja
Validacao de areaSe esta na area de entrega
MapaExibicao em mapa

Validacao de Area de Entrega​

Processo de Validacao​

Validacao por CEP​

CEP do cliente: 01310-100 (= 1310100)
Faixa da area: 01000-000 a 01999-999

Se: 1000000 <= 1310100 <= 1999999
Entao: Endereco na area

Validacao por Distancia​

Coordenadas do cliente: [-23.5505, -46.6333]
Coordenadas da loja: [-23.5489, -46.6388]
Distancia calculada: 0.8 km
Raio da area: 5 km

Se: 0.8 <= 5
Entao: Endereco na area

Campos Derivados​

short_address​

Formato: {street}, {number}, {complement}, {neighborhood}, {city}, {state}

Exemplo: "Av. Paulista, 1000, Sala 101, Bela Vista, Sao Paulo, SP"

city_state​

Formato: {city}/{state.upcase}

Exemplo: "Sao Paulo/SP"

Acoes Disponiveis​

AcaoLayoutDescricao
indexembedLista enderecos do cliente
showmodalVer detalhes do endereco
new/createmodalAdicionar endereco
edit/updatemodalEditar endereco
destroymodalExcluir endereco

Lista de Enderecos​

Colunas Exibidas​

ColunaDescricao
short_addressEndereco resumido (clicavel)
city_stateCidade/UF
countryPais
zip_codeCEP
defaultIndicador de padrao

Paginacao​

20 enderecos por pagina

Estados Brasileiros​

O campo state aceita apenas UFs validas:

AC, AL, AP, AM, BA, CE, DF, ES, GO, MA,
MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN,
RS, RO, RR, SC, SP, SE, TO

Regras de Negocio​

Validacoes​

CampoValidacao
zip_codeObrigatorio
streetObrigatorio
street_numberObrigatorio
neighborhoodObrigatorio
cityObrigatorio
stateObrigatorio, UF valida

Restricoes​

  1. Unico endereco padrao: Por cliente
  2. UF valida: Deve ser estado brasileiro
  3. CEP formato: 8 digitos (com ou sem hifen)
  4. Vinculo obrigatorio: Endereco deve ter cliente

Exportacao​

  • PDF: Lista de enderecos (A4, paisagem)
  • Disponivel no contexto de clientes

Permissoes​

AcaoQuem Pode
CriarUsuarios com permissao CRM
EditarUsuarios com permissao CRM
ExcluirUsuarios com permissao CRM
VerUsuarios com permissao CRM

Uso em Notas Fiscais​

O endereco padrao do cliente e usado para:

Dado NF-eCampo
Logradourostreet
Numerostreet_number
Complementocomplement
Bairroneighborhood
Cidadecity
UFstate
CEPzip_code
Codigo IBGE Cidade(derivado)
Codigo IBGE UF(derivado)