Localize Endereços com Facilidade Usando o CEP

📋 Estrutura da Tabela

A tabela ceps possui 6 colunas.

🔑 Id PRIMARY KEY

🔑 PRIMARY KEY🔒 Somente leitura💾 Grava

Campo Tabela id

Campo VIEW / Exibido id_cep 🔹 Alias na VIEW: id_cep

Tipo number (readonly - PRIMARY KEY)

Data Table ceps

Descrição

Campo id

🔑 PRIMARY KEY

Campo na tabela: id

Alias na VIEW: id_cep

Readonly: ✅ Gerado automaticamente pelo sistema

Formsearch: ✅ Permite busca avançada

📋 Todos os Atributos

🎨 Formatacao

Tipo de dados number

✅ Validacao

Somente leitura 🔒 Sim

📊 Dados

Campo OndeVou id
Alias OndeVou id_cep
Tabela OndeVou ceps

🔍 Formsearch

```
{
  "required": ""
}
```

Alias: id_cep
Tabelas: ceps ✅
FormSearch: ✓
🔑 PRIMARY KEY
VIEW: id_cep
📋 FormSearch

📋 Cep

✅ Obrigatório💾 Grava

Campo Tabela cep

Campo VIEW / Exibido cep

Tipo number

Data Table ceps

Descrição

Campo cep

📋 Todos os Atributos

🎨 Formatacao

Tipo de dados number

✅ Validacao

Obrigatório ✅ Sim

📊 Dados

Campo OndeVou cep
Tabela OndeVou ceps

🔍 Formsearch

```
{
  "required": ""
}
```

Tabelas: ceps ✅
FormSearch: ✓

📋 Cidade

✅ Obrigatório💾 Grava🔗 getdata

Campo Tabela id_cidade

Campo VIEW / Exibido nome_cidade (ID: id_cidade)

Tipo number (getdata)

Data Table ceps

Descrição

Campo cidade

Getdata🔗 cidades

📋 Todos os Atributos

🎨 Formatacao

Tipo de dados number

✅ Validacao

Obrigatório ✅ Sim

📊 Dados

Campo OndeVou nome_cidade
ID OndeVou id_cidade
Tabela OndeVou ceps

🔗 Getdata

{
  "view": "view_cidades",
  "data": "view_cidades",
  "campo-data-id": "id_cidade",
  "campo-data-value-input": "nome_cidade",
  "campo-data-input-select-view": "nome_cidade,sigla_uf",
  "query": {
    "select": "* from view_cidades",
    "where": {
      "and": {
        "texto_digitado": {
          "left": "(unaccent(LOWER(concat(nome_cidade,` `,sigla_uf))) ilike `%",
          "right": "%`)"
        }
      }
    }
  }
}

🔍 Formsearch

```
{
  "required": ""
}
```

ID: id_cidade
Tabelas: ceps ✅
FormSearch: ✓

📋 UF

✅ Obrigatório📋 Somente view🔗 getdata

Campo Tabela id_uf

Campo VIEW / Exibido sigla_uf ⚠️ (somente view)

Tipo number (getdata)

Data Table view_ceps_cidades

Descrição

Campo uf

Getdata🔗 uf

📋 Todos os Atributos

🎨 Formatacao

Tipo de dados number

✅ Validacao

Obrigatório ✅ Sim

📊 Dados

Campo OndeVou sigla_uf
ID OndeVou id_uf
Tabela OndeVou view_ceps_cidades

🔗 Getdata

{
  "view": "view_uf",
  "data": "view_uf",
  "text-empty-search": "sim",
  "campo-data-id": "id_uf",
  "campo-data-value-input": "sigla_uf",
  "campo-data-input-select-view": "nome_uf,sigla_uf",
  "query": {
    "select": "* from view_uf",
    "where": {
      "and": {
        "texto_digitado": {
          "left": "(unaccent(LOWER(concat(nome_uf,` `,sigla_uf))) ilike `%",
          "right": "%`)"
        }
      }
    }
  }
}

🔍 Formsearch

```
{
  "required": ""
}
```

ID: id_uf
Tabelas: view_ceps_cidades (só view)
FormSearch: ✓

📋 Latitude

✅ Obrigatório🔒 Somente leitura💾 Grava

Campo Tabela latitude

Campo VIEW / Exibido lat_cep

Tipo number

Data Table ceps

Descrição

Campo latitude

📋 Todos os Atributos

🎨 Formatacao

Tipo de dados number

✅ Validacao

Obrigatório ✅ Sim
Somente leitura 🔒 Sim

📊 Dados

Campo OndeVou latitude
Alias OndeVou lat_cep
Tabela OndeVou ceps

Alias: lat_cep
Tabelas: ceps ✅

📋 Longitude

✅ Obrigatório🔒 Somente leitura💾 Grava

Campo Tabela longitude

Campo VIEW / Exibido lng_cep

Tipo number

Data Table ceps

Descrição

Campo longitude

📋 Todos os Atributos

🎨 Formatacao

Tipo de dados number

✅ Validacao

Obrigatório ✅ Sim
Somente leitura 🔒 Sim

📊 Dados

Campo OndeVou longitude
Alias OndeVou lng_cep
Tabela OndeVou ceps

Alias: lng_cep
Tabelas: ceps ✅

📌 Legenda: 🔑 PRIMARY KEY ✅ Obrigatório 🔒 Somente leitura 👁️ Oculto 💾 Grava 📋 Somente view 🔗 getdata 📝 putdata 🔢 AutoInc 📱 QR Code 📋 Auditoria 📱 GetCollector

🔗 Relacionamentos

Tabelas relacionadas via getdata.

cidades · Principal: Cidade 📄

uf · Principal: UF 📄

🔍 Filtros (formsearch)

Campos disponíveis para filtragem na busca.

Nenhum filtro disponível.

🎮 Controles Disponíveis

Ações que o usuário pode realizar na tabela.

📂 Controle

🔘 Add add 🔘 Copy copy 🔘 Edit edit 🔘 Map map 💾 Salvar save 🔘 Delete delete 🔘 Remove remove

👁️ View Associada

Nome: view_ceps

🔑 PRIMARY KEY - Campo Id

O campo Id é a chave primária da tabela ceps.

Configuração

'Id': {
    'input': {
        'readonly': 'readonly',
        'data-type-ondevou': 'number',
        'data-field-ondevou': 'id',
        "data-field-alias-ondevou": "id_cep",
        'data-table-ondevou': 'ceps'
    }
}

Comportamento

🔒 Readonly: Campo não editável
📊 Tipo: number
🔹 Alias na VIEW: id_cep

💾 JSON da Tabela

Estrutura completa em JSON para integração com APIs e IAs.

Clique para ver o JSON completo 4 KB

{
  "table-id": "ceps",
  "data-table-ondevou": "ceps",
  "data-table-update": "sim",
  "data-table-getdata": "sim",
  "table-class": "highlight",
  "readonly": "nao",
  "controls": [
    "add",
    "copy",
    "edit",
    "map",
    "save",
    "delete",
    "remove"
  ],
  "html": {
    "div": {
      "before": "<h1>Ceps</h1>",
      "after": ""
    }
  },
  "entidade": {
    "page": "cep",
    "title": "Cep",
    "table": "ceps",
    "campo_id": "cep",
    "view": "view_ceps",
    "where_post": "",
    "function": "getCepQrCode",
    "ogTitle": "Localize Endereços com Facilidade Usando o CEP",
    "ogDescription": "Encontre endereços rapidamente com o CEP no OndeVou.com. Simplifique a busca por endereços completos em qualquer lugar do Brasil.",
    "ogImage": "",
    "ogUrl": "https://ondevou.com/cep",
    "ogKeywords": "CEP, busca de endereços, localização por CEP, encontrar endereço, código postal, ondevou, onde, onde ir, software",
    "sobre": {},
    "posts": {
      "1": {
        "id_post": "1",
        "nome_rotina": "Sobre Ondevou Endereços",
        "descricao": "Ondevou Endereços simplifica o cadastro e a organização de participantes por endereço, proporcionando informações detalhadas por rua, bairro, cep e cidade. Com essa ferramenta, você pode gerenciar e encontrar endereços de forma rápida e eficiente, tornando a organização e busca por informações ainda mais simples.",
        "id_rotina": "",
        "id_membro": "",
        "nome_membro": "Firmino Moreira Gusmão",
        "razao_social": "ONDEVOU.COM TECNOLOGIA LTDA",
        "cnpj": "17.058.605/0001-36",
        "razao_social_cliente": "",
        "nome_fantasia_cliente": "",
        "tabela_origem": "",
        "id_origem": "",
        "data_criacao": 1786541043253,
        "link_post": {
          "title": "Saiba mais sobre o Ondevou Endereços",
          "url": "plataforma/produto/enderecos",
          "onclick": "navClose();startMenu(this);return false;",
          "menu": "446"
        }
      }
    }
  },
  "headers": {
    "Id": {
      "width": "10%"
    },
    "Cep": {
      "width": "20%"
    },
    "Cidade": {
      "width": "30%"
    },
    "UF": {
      "width": "10%"
    },
    "Latitude": {
      "width": "15%"
    },
    "Longitude": {
      "width": "15%"
    }
  },
  "columns": {
    "Id": {
      "input": {
        "readonly": "readonly",
        "data-type-ondevou": "number",
        "data-field-ondevou": "id",
        "data-field-alias-ondevou": "id_cep",
        "data-table-ondevou": "ceps",
        "formsearch": {
          "required": ""
        }
      }
    },
    "Cep": {
      "input": {
        "required": "required",
        "data-type-ondevou": "number",
        "data-field-ondevou": "cep",
        "data-table-ondevou": "ceps",
        "data-field-getdata": "cep",
        "formsearch": {
          "required": ""
        }
      }
    },
    "Cidade": {
      "input": {
        "required": "required",
        "data-type-ondevou": "number",
        "data-id-field-ondevou": "id_cidade",
        "data-field-ondevou": "nome_cidade",
        "data-field-getdata": "id_cidade",
        "data-table-ondevou": "ceps",
        "getdata": "{\"view\":\"view_cidades\",\"data\":\"view_cidades\",\"campo-data-id\":\"id_cidade\",\"campo-data-value-input\":\"nome_cidade\",\"campo-data-input-select-view\":\"nome_cidade,sigla_uf\",\"query\":{\"select\":\"* from view_cidades\",\"where\":{\"and\":{\"texto_digitado\":{\"left\":\"(unaccent(LOWER(concat(nome_cidade,` `,sigla_uf))) ilike `%\",\"right\":\"%`)\"}}}}}",
        "formsearch": {
          "required": ""
        }
      }
    },
    "UF": {
      "input": {
        "required": "required",
        "data-type-ondevou": "number",
        "data-id-field-ondevou": "id_uf",
        "data-field-ondevou": "sigla_uf",
        "data-field-getdata": "id_uf",
        "data-table-ondevou": "view_ceps_cidades",
        "getdata": "{\"view\":\"view_uf\",\"data\":\"view_uf\",\"text-empty-search\":\"sim\",\"campo-data-id\":\"id_uf\",\"campo-data-value-input\":\"sigla_uf\",\"campo-data-input-select-view\":\"nome_uf,sigla_uf\",\"query\":{\"select\":\"* from view_uf\",\"where\":{\"and\":{\"texto_digitado\":{\"left\":\"(unaccent(LOWER(concat(nome_uf,` `,sigla_uf))) ilike `%\",\"right\":\"%`)\"}}}}}",
        "formsearch": {
          "required": ""
        }
      }
    },
    "Latitude": {
      "input": {
        "required": "required",
        "readonly": "readonly",
        "data-type-ondevou": "number",
        "data-field-ondevou": "latitude",
        "data-field-alias-ondevou": "lat_cep",
        "data-table-ondevou": "ceps"
      }
    },
    "Longitude": {
      "input": {
        "required": "required",
        "readonly": "readonly",
        "data-type-ondevou": "number",
        "data-field-ondevou": "longitude",
        "data-field-alias-ondevou": "lng_cep",
        "data-table-ondevou": "ceps"
      }
    }
  },
  "formsearch": {
    "data-table-ondevou": "view_ceps_cidades",
    "data-view-ondevou": "view_ceps_cidades",
    "data-where-order": "order by id_cep desc",
    "input": {}
  },
  "url_documentacao": "/docs/ondevou-db-ceps.html",
  "nome_tabela": "ceps"
}

📝 SQL CREATE TABLE - Estrutura Completa

Comando SQL COMPLETO para criar a tabela ceps no PostgreSQL. Esta estrutura foi extraída DIRETAMENTE do banco de dados.

🏗️ Estrutura Completa

📋 5 colunas 🔗 4 constraints 📑 5 índices ⚡ 0 triggers

Clique para ver o SQL completo ✅ COMPLETO

-- ============================================================
-- ESTRUTURA COMPLETA DA TABELA ceps
-- Fonte: PostgreSQL - 12/08/2026 10:24:03
-- ============================================================

CREATE TABLE public.ceps (
    id integer NOT NULL DEFAULT nextval('ceps_id_seq'::regclass),
    cep varchar(15),
    id_cidade integer,
    latitude numeric(25, 20),
    longitude numeric(25, 20),
    CONSTRAINT ceps_pkey PRIMARY KEY (id),
    CONSTRAINT ceps_unique_cep UNIQUE (cep),
    CONSTRAINT 2200_220988_1_not_null CHECK (id IS NOT NULL)
);

-- ============================================================
-- ÍNDICES
-- ============================================================
CREATE INDEX ceps_idx_cep ON public.ceps USING gin (to_tsvector('mydict'::regconfig, (cep)::text));
CREATE INDEX ceps_idx_lat_lng ON public.ceps USING gist (ll_to_earth((latitude)::double precision, (longitude)::double precision));
CREATE UNIQUE INDEX ceps_pk_id ON public.ceps USING btree (id);
CREATE UNIQUE INDEX ceps_unique_cep ON public.ceps USING btree (cep);
CREATE INDEX fki_ceps_id_cidade_for_cidades_id ON public.ceps USING btree (id_cidade);

✅ SQL extraído DIRETAMENTE do banco de dados

📊 Comparação: JSON Config vs Banco Real

Verifique se a configuração JSON está sincronizada com a estrutura do banco de dados.

Campo	Tipo (JSON)	Tipo (Banco)	Status
`cep`	`number`	`character varying`	✅ OK
`id`	`number`	`integer`	✅ OK
`id_cidade`	`-`	`integer`	❌ Só no banco
`latitude`	`number`	`numeric`	✅ OK
`longitude`	`number`	`numeric`	✅ OK
`nome_cidade`	`number`	`-`	⚠️ Só no JSON
`sigla_uf`	`number`	`-`	⚠️ Só no JSON

💡 Dica: Use esta comparação para garantir que a configuração JSON está atualizada com a estrutura do banco.
📌 Legenda: ✅ OK = presente em ambos | ⚠️ Só no JSON = pode ser um campo virtual | ❌ Só no banco = falta adicionar ao JSON

💡 Como Popular a Tabela

Exemplo prático usando o padrão OndeVou.

📋 Fluxo completo padrão

// 1. Buscar dados com getData
var dados_retorno = getData({
    'query': `SELECT * FROM view_ceps WHERE participante = ${globais.dados_fixo.participante}`,
    'view': 'view_ceps'
});

// 2. Definir painel e slide
var painel = globais.dados_pagina.visivel.painel;
var slide = globais.dados_pagina.visivel.slide;

// 3. Encontrar a tabela no DOM
var idTable = getIdTableFromSlide({ 'table-id': 'ceps' });

// 4. Resetar a tabela
setTableControlsReset(idTable);

// 5. Popular a tabela
setTableControlsSetValue(idTable, dados_retorno);

🏆 Propriedade Intelectual

Marca Registrada

OndeVou.com®

Propriedade Intelectual Assegurada

Processo INPI:
908765967

Titular:
ONDEVOU.COM TECNOLOGIA LTDA

CNPJ:
17.058.605/0001-36

Classificação:
Classe 42 - Serviços de TI

🗄️ Localize Endereços com Facilidade Usando o CEP

📋 Estrutura da Tabela

🔗 Relacionamentos

🔍 Filtros (formsearch)

🎮 Controles Disponíveis

👁️ View Associada

🔑 PRIMARY KEY - Campo Id

Configuração

Comportamento

💾 JSON da Tabela

📝 SQL CREATE TABLE - Estrutura Completa

🏗️ Estrutura Completa

📊 Comparação: JSON Config vs Banco Real

💡 Como Popular a Tabela

📋 Fluxo completo padrão

🏆 Propriedade Intelectual

OndeVou.com®