Municipios
Mantem a tabela de municipios usada nos cadastros fiscais do sistema (empresas, parceiros e servicos) e na emissao de documentos. Cada municipio e identificado pelo **codigo IBGE**, alem de nome e UF.
Para que serve
Antes de comecar
- Tenha o codigo IBGE (ate 7 digitos) e a UF do municipio.
- Na maioria dos casos a tabela ja vem carregada; use a pesquisa antes de cadastrar um novo registro.
Como usar
- Use a busca por nome, UF ou codigo IBGE para localizar o municipio (a pesquisa ignora acentos).
- Para incluir um municipio ausente, clique em Adicionar.
- Informe Codigo IBGE, Nome e UF (obrigatorios) e, se necessario, o Codigo SIAFI.
- Clique em Salvar.
Campos principais
| Campo | Uso |
|---|---|
| Codigo IBGE | Identificador oficial do municipio (ate 7 digitos) |
| Nome | Descricao do municipio (ate 120 caracteres) |
| UF | Unidade federativa (2 letras) |
| Codigo SIAFI | Codigo complementar usado em integracoes de governo |
Regras importantes
- Codigo IBGE, Nome e UF sao obrigatorios.
- Um municipio em uso (referenciado por empresa, parceiro, servico ou regras de retencao) nao pode ser excluido — o sistema bloqueia a exclusao para preservar a integridade fiscal.
- A pesquisa aceita nome (sem distincao de acentos), sigla de UF ou apenas os digitos do codigo.
Problemas comuns
| Situacao | Como resolver |
|---|---|
| Municipio nao encontrado | Pesquise pela UF ou pelo codigo IBGE; se nao existir, cadastre |
| Nao consigo excluir | O municipio esta em uso em algum cadastro fiscal; ele so pode ser excluido se nao houver vinculos |
| Erro no Codigo SIAFI | Coluna pode nao existir no banco; aplique a migration indicada na mensagem |
Telas do sistema
Capturas reais desta tela, com dados sensíveis mascarados.
