País
Menu: Cadastro › Endereço › País. Recurso: FrmPais.
Para que serve
Cadastra os países usados no endereço: sigla, nome, códigos IBGE e BACEN e a bandeira.
O cadastro é global: vale para todos os clientes, não só para a empresa em que você está logado. O sistema já vem com os países; use esta tela para incluir um que falte ou corrigir dados e bandeira.
Quem usa
Só o perfil Administrador Global (usuário administrator) vê esta tela. Perfis comuns não recebem País, UF nem Cidade.
| Permissão | O que libera |
|---|---|
| Consultar | Lista, pesquisa e Atualizar |
| Novo | Botão Novo |
| Editar | Ícone Editar e Salvar |
| Auditoria | Histórico do país aberto |
Só quem tem Editar vê o ícone para abrir o cadastro. Auditoria aparece no formulário depois de abrir o registro. Não há botão Excluir nesta tela.
Antes de começar
- Entrar como administrator. Sem o perfil Administrador Global a tela nem entra no menu.
- Confira se o país já existe: pesquise pela sigla (BRA, USA) ou pelo nome antes de incluir de novo.
- A bandeira é opcional. Se for anexar, use PNG, JPEG, WEBP ou GIF de no máximo 512 KB.
Não é preciso cadastrar UF nem cidade nesta rotina. UF e País são cadastros independentes.
Passo a passo
Incluir um país
Lista da tela: pesquisa, Atualizar e Novo. A bandeira aparece na primeira coluna; o lápis abre o cadastro.
- Abra Cadastro › Endereço › País.
- Clique em Novo.
- Informe a Sigla (2 ou 3 letras), o Nome (2 a 100 caracteres), o Código IBGE e o Código BACEN.
- Se quiser bandeira: clique com o botão direito na área da bandeira, escolha Adicionar e selecione o arquivo.
- Clique em Salvar.
Formulário de inclusão. A sigla vira maiúscula sozinha. Clique com o botão direito em Sem bandeira para adicionar a imagem.
Bandeira
O clique com o botão direito abre Adicionar e Remover. A imagem aparece na lista depois de salvar. Remover só tira a imagem; o país continua cadastrado.
Auditoria
No país salvo, Auditoria abre o histórico do nome, da sigla, dos códigos e da bandeira. Informe o período (a tela já sugere as últimas 24 horas) e Buscar. Clique em um registro para ver valor anterior e valor novo à direita. A bandeira aparece como Imagem, sem o arquivo em si.
Campos que importam
| Campo | Comportamento |
|---|---|
| Sigla | 2 ou 3 letras, única. A tela aceita só A–Z e passa para maiúscula. |
| Nome | 2 a 100 caracteres, único. |
| Código IBGE | Obrigatório, número inteiro ≥ 0, único. |
| Código BACEN | Obrigatório, número inteiro ≥ 0. Não precisa ser único. |
| Bandeira | Opcional. PNG, JPEG, WEBP ou GIF, no máximo 512 KB. |
O que o sistema faz sozinho
- Mostra os países de todo o sistema, não só do cliente logado. A pesquisa filtra nome e sigla; se você digitar um número, também IBGE e BACEN.
- Converte a sigla para maiúscula e ignora o que não for letra.
- Já traz os países padrão na instalação.
O que não pode
- Usar nome com menos de 2 ou mais de 100 caracteres.
- Usar sigla com menos de 2 ou mais de 3 letras.
- Repetir nome, sigla ou código IBGE que já existam.
- Anexar arquivo que não seja imagem, ou maior que 512 KB.
- Vincular esta tela a um perfil que não seja Administrador Global.
Se der errado
| Mensagem | O que fazer |
|---|---|
| O Nome do País precisa possuir entre 2 e 100 caracteres | Ajuste o nome. |
| O Nome do País informado já existe | Abra o país existente; não cadastre de novo. |
| A Sigla do País precisa possuir entre 2 e 3 caracteres | Use 2 ou 3 letras (BRA, US, AR). |
| A Sigla do País informada já existe | Escolha outra sigla. |
| O Código IBGE é obrigatório | Informe um número inteiro ≥ 0. |
| O Código IBGE informado já existe | Confira o código; cada país tem um IBGE. |
| O Código BACEN é obrigatório | Informe um número inteiro ≥ 0. |
| A bandeira precisa ser um arquivo de imagem | Escolha PNG, JPEG, WEBP ou GIF. |
| A bandeira precisa ter no máximo 512 KB | Reduza o arquivo. |
| Sem permissão para consultar países | Peça Consultar em FrmPais no perfil Administrador Global. |
| Nenhum país encontrado. | Limpe a pesquisa ou confira se você não está filtrando um nome inexistente. |
| Informe a DataHoraInicial e a DataHoraFinal | Preencha o período da auditoria. |
| A DataHoraInicial deve ser anterior ou igual à DataHoraFinal | Inverta as datas. |
| Nenhum registro de auditoria no período informado. | Amplie o período. |
A tela não aparece no menu: quem está logado não é o administrator, ou falta Acessar no recurso FrmPais.