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