A seção Países, Estados e Municípios do Vendelo permite gerenciar informações de localização geográfica de forma hierárquica. Ao ativar o Vendelo, o sistema já vem pré-configurado com os dados de estados e municípios da localização informada durante a instalação. Esta documentação explica como navegar entre as diferentes telas e gerenciar essas informações de localização.
Índice
Navegação Geral
O sistema de localização do Vendelo está organizado em três níveis hierárquicos: países no nível superior, estados dentro de cada país, e municípios dentro de cada estado. A navegação segue essa hierarquia natural.
Ao ativar o Vendelo pela primeira vez, o sistema já inclui automaticamente os estados e municípios da localização que você informou durante a configuração inicial.
Como Navegar Entre os Níveis
- Acesse a tela de Países através do menu principal
- Clique em um país para visualizar seus Estados na aba correspondente
- Dentro da tela de um país, selecione um estado para ver seus Municípios
- Use as abas na parte inferior para alternar entre as diferentes seções
Gestão de Países
A tela de países permite visualizar, adicionar, editar e remover países do sistema. Cada país contém informações específicas como códigos bancários e do SISCOMEX.
Lista de Países
A lista apresenta os países cadastrados com as seguintes informações:
- Nome: denominação completa do país
- Código Banco Central: código de 4 dígitos usado pelo Banco Central
- Código SISCOMEX: código de 3 dígitos do sistema de comércio exterior
- Data de Criação: quando o registro foi incluído no sistema
- Última Atualização: data da modificação mais recente
Adicionando um Novo País
- Na lista de países, clique no botão Adicionar (ícone +)
- Preencha o Nome do país (campo obrigatório)
- Informe o Código do Banco Central se disponível
- Digite o Código SISCOMEX quando necessário
- Clique no botão Salvar (ícone de disquete) para confirmar
O nome do país é obrigatório e não pode ficar em branco. Os códigos são opcionais mas recomendados para uso em relatórios fiscais.
Gestão de Estados
Dentro da tela de cada país, você encontra uma aba dedicada aos estados daquele país. Esta seção permite gerenciar as divisões administrativas de primeiro nível.
Visualizando Estados de um País
- Acesse a tela de edição de um país existente
- Clique na aba Estados na parte inferior da tela
- Visualize a lista de estados já cadastrados para aquele país
- Use os botões de ação para editar ou remover estados
Adicionando um Novo Estado
- Na aba Estados de um país, clique no botão Adicionar
- Uma janela modal será aberta com o formulário de estado
- Preencha o Nome do Estado (campo obrigatório)
- O campo País já vem preenchido e não pode ser alterado
- Clique em Salvar para confirmar a inclusão
Estados só podem ser criados dentro de um país existente. O sistema automaticamente vincula o novo estado ao país atual.
Gestão de Municípios
Os municípios representam o terceiro nível da hierarquia administrativa e ficam dentro de cada estado. Esta seção permite gerenciar essas localidades menores.
Acessando Municípios
- Navegue até um país específico
- Acesse a aba Estados deste país
- Clique no botão de edição de um estado
- Na tela do estado, acesse a aba Municípios
Gerenciando Municípios
Cada município possui as seguintes informações:
- Nome: denominação oficial do município
- Código IBGE: código brasileiro de 7 dígitos do IBGE
- Estado: vinculação ao estado (não editável)
Adicionando um Novo Município
- Na aba Municípios de um estado, clique em Adicionar
- Preencha o Nome do município (obrigatório)
- Informe o Código IBGE quando disponível
- O campo Estado já vem preenchido automaticamente
- Salve as alterações clicando no botão Salvar
O código IBGE é útil para relatórios fiscais e integração com sistemas governamentais brasileiros. Embora opcional, é recomendado preenchê-lo quando conhecido.
Formulários e Campos
Todos os formulários seguem o mesmo padrão de interface e comportamento no sistema.
| Nível | Campos Obrigatórios | Campos Opcionais | Campos Automáticos |
|---|---|---|---|
| País | Nome Obrigatório | Código Banco Central, Código SISCOMEX | Data de Criação, Última Atualização |
| Estado | Nome Obrigatório | – | País, Data de Criação, Última Atualização |
| Município | Nome Obrigatório | Código IBGE | País, Estado, Data de Criação, Última Atualização |
Comportamento dos Formulários
- Validação: campos obrigatórios são verificados antes do salvamento
- Botão Salvar: só aparece quando há alterações válidas no formulário
- Campos Automáticos: são preenchidos pelo sistema e não podem ser editados
- Navegação: use as abas inferiores para alternar entre seções
Não é possível excluir um país que possui estados cadastrados, nem um estado que possui municípios. Remova primeiro os registros dependentes.
Perguntas Frequentes
O Vendelo já vem com dados pré-cadastrados?
Sim, ao ativar o Vendelo, o sistema já inclui automaticamente os estados e municípios da localização que você informou durante a configuração inicial. Você não precisa cadastrar essas informações manualmente.
Como faço para adicionar um novo país?
Na tela de lista de países, clique no botão Adicionar (+), preencha pelo menos o nome do país (campo obrigatório) e clique em Salvar. Os códigos do Banco Central e SISCOMEX são opcionais.
Posso editar os dados que já vieram pré-cadastrados?
Sim, todos os dados podem ser editados. Clique no botão de edição (lápis) ao lado do registro desejado, faça as alterações necessárias e salve.
Por que não consigo excluir um país?
Um país não pode ser excluído se possui estados cadastrados. Primeiro você deve remover todos os estados daquele país, e então poderá excluir o próprio país.
Para que servem os códigos do Banco Central e SISCOMEX?
Esses códigos são usados em relatórios fiscais e declarações governamentais. O código do Banco Central é usado em operações financeiras internacionais, enquanto o SISCOMEX é específico para comércio exterior.
Como adiciono um estado a um país?
Entre na tela de edição do país desejado, clique na aba “Estados” na parte inferior, depois clique no botão Adicionar. Preencha o nome do estado e salve.
O código IBGE dos municípios é obrigatório?
Não, o código IBGE é opcional. Porém, é recomendado preenchê-lo quando disponível, pois é útil para relatórios fiscais e integração com sistemas governamentais brasileiros.
Por que alguns campos aparecem desabilitados?
Campos como “País” na tela de estados e “Estado” na tela de municípios são preenchidos automaticamente pelo sistema e não podem ser editados, pois representam a hierarquia estabelecida.
Como navego entre as diferentes seções?
Use as abas na parte inferior da tela para alternar entre países, estados e municípios. A navegação segue a hierarquia: países > estados > municípios.
Posso filtrar ou pesquisar nas listas?
Sim, todas as listas possuem filtros automáticos. Use os campos de filtro acima de cada coluna para localizar rapidamente os registros desejados.
