Objetivo

Cadastrar e gerenciar os dados referentes as cidades.

Caminho

Módulo Pessoa > Menu Manutenção > Aplicação Cidade - GEPES0003

Pré-Requisitos e Restrições

Atualizar o sistema para a versão 21.01 ou versão superior.

Passo a Passo

Entre na aplicação:

Imagem 1 - Cidades

Informe os campos:

• Cidade: nome da cidade.
• Região: região que a cidade pertence.
• UF: estado que a cidade pertence.
• País: país em que está localizada a cidade.
• Sigla: sigla ou abreviação do nome da cidade.
• População: quantidade de habitantes.
• Data da Fundação: data, mês e ano de fundação da cidade.
• DDD: código de telefone.
• Limite do Boleto: limite do valor do boleto.
• Prazo Adicional Concedido no Vencimento do Título:
• Código Nacional da Cidade: código da cidade.
• Código IBGE: código do IBGE da cidade. Os códigos do IBGE são cadastrados por meio da aplicação Cadastro de Código de Município IBGE - GEPES00101.
• Código do País BACEN: código do país no Banco Central.
• Código da Praça Banco SICREDI:
• Código SIAFI: código do Sistema Integrado de Administração Financeira.
• Código Sequencial dos Correios: código para o correio.
• Exige Bairros: após a cidade ser adicionada a cidade é habilitado este campo, e ao ser marcado será exigido que ao informar a cidade seja cadastrado o bairro.
• Exige Logradouros:  após a cidade ser adicionada a cidade é habilitado este campo, e ao ser marcado será exigido que ao informar a cidade seja cadastrado o logradouro.
• CEP: CEP inicial e final da cidade.
• Percentual de Desconto ou Acréscimo de frete: percentual que será incluído ou excluído do frete da cidade cadastrada.
• ZFM/ALC: indica se pertence a Zona Franca de Manaus ou a Área de Livre Comércio, se sim é necessário informar o código da cidade e do estado.
• DAC (AL): se o município for de Alagoas, deve informar o código para a Declaração Anual do Contribuinte.
• É Distrito: quando a cidade cadastrada for um distrito, deve ser informada a cidade principal a qual ela pertence.

Para adicionar uma nova cidade, clique no botão de Incluir <F3>.

Após ser incluída a cidade é habilitado na parte inferior da tela o botão Feriados, em que poderá ser adicionados os feriados relacionados aquela cidade como o aniversário e padroeiro.

Imagem 2 - Feriados

Quando marcado o campo Exige Bairros será habilitado parte inferior da tela terá o botão Bairros. Clique sobre ele e será aberta a tela para inserir os bairros que pertencem aquela cidade.

Para informar o bairro, clique no botão de Incluir <F3> e informe os campos desejados. A coluna Tipo vem da aplicação de Atributos Fixos de Pessoa - GEPES0001 mas não é um campo obrigatório. Após inserir os dados, clique no botão para Atualizar <F4> os dados do bairro.

Imagem 3 - Bairros

Da mesma forma, quando marcar o campo Exige Logradouros será habilitado parte inferior da tela terá o botão Logradouros. Clique sobre ele e será aberta a tela para inserir os logradouros que pertencem aquela cidade.

Para informar o logradouro, clique no botão de Incluir <F3> e informe os campos desejados. A coluna Tipo vem da aplicação de Atributos Fixos de Pessoa - GEPES0001 mas não é um campo obrigatório. Após inserir os dados, clique no botão para Atualizar <F4> os dados do logradouro.

Imagem 4 - Logradouros

Para alterar os dados, selecione a cidade e altere o campo desejado, para salvar clique no botão Atualizar <F4>. E caso deseja excluir, selecione a cidade e clique no botão Excluir <F5>.


A aplicação possui o recurso de busca das informações, utilizando endpoint específico da nova API Conector Dados Globais. Para isso, deve-se instalar a API no ambiente e configurar a URL de instalação na rotina Parâmetros Gerais, na guia Integrações, no campo URL base de API local.

Observação: Para usar o recurso de busca de código IBGE, com base na API dos Correios, não é necessário nenhuma aquisição ou contrato adicional, apenas instalar a API de dependência e realizar a configuração da URL de instalação, na rotina de Parâmetros Gerais.

Ao consultar uma cidade, é feita a comunicação com a API, validando o código do IBGE cadastrado para a cidade

                                                                                                                                                                                      Imagem 5 - Realizando a busca de uma cidade ja inserida no ERP

Realizando a inserção de uma nova cidade, também é realizado a pesquisa dos dados do IBGE para a cidade

                                                                                                                                                                                                Imagem 6 - Realizando a inserção de uma nova cidade

• Na dialog Pesquisa Código IBGE, o usuário poderá selecionar uma determinada Cidade e então clicar no botão Consultar IBGE, e então será feita a pesquisa e caso o Código do IBGE informado no ERP esteja diferente do que a API retornar, os registros serão atualizados, caso contrário será retornada mensagem de que os dados estão corretos.

Imagem 5 - Realizando pesquisa e retorno com o Código IBGE da API diferente do que está gravado no ERP.

Atividades Relacionadas

Pessoa - GEPES0010

Atributos Fixos de Pessoa - GEPES0001

Cadastro de Código de Município IBGE - GEPES00101