Módulo Prefeitura
O módulo Prefeitura é destinado a clientes que operam como órgãos municipais (prefeituras e secretarias). Ele permite importar as notas de empenho geradas pelo software municipal Agili Blue, sincronizar os credores como fornecedores no Ello e imprimir etiquetas de identificação dos empenhos.
Conceitos Básicos
Empenho
O empenho é a reserva formal de verba orçamentária para pagamento de um bem ou serviço. No Ello, cada empenho fica registrado com número, data, valor, descrição e o credor (fornecedor) ao qual se destina.
Credor
O credor é a pessoa física ou jurídica que receberá o pagamento referente ao empenho. Ele é identificado pelo CPF ou CNPJ e, após a sincronização, passa a existir também como fornecedor no módulo de Contas a Pagar.
Órgão
O órgão identifica a unidade administrativa (secretaria, departamento etc.) que gerou o empenho. É um código de dois caracteres exportado pelo Agili Blue.
Configuração do Módulo
Antes de utilizar o módulo, acesse Configurações → Parâmetros do Sistema → aba Prefeitura e preencha:
| Parâmetro | O que configurar |
|---|---|
| Pasta dos arquivos | Caminho completo da pasta onde os XMLs do Agili Blue serão salvos |
| Arquivo de credores | Nome do arquivo XML que contém os credores (ex.: credores.xml) |
| Arquivo de empenhos | Nome do arquivo XML que contém os empenhos (ex.: empenhos.xml) |
| Impressora padrão | Impressora que será usada para imprimir as etiquetas de empenho |
<note important>Os arquivos XML devem ser exportados do Agili Blue e copiados para a pasta configurada antes de executar a sincronização.</note>
Empenhos
Acesse o módulo pelo menu Prefeitura → Empenhos. A tela exibe a lista de empenhos já importados com as colunas:
- Número — número do empenho
- Data — data de emissão
- Descrição — objeto do empenho
- Órgão — código da unidade administrativa
- CNPJ/CPF do Credor — identificação do credor
- Valor — valor reservado
- Fornecedor — nome do fornecedor vinculado pelo CNPJ/CPF (preenchido após sincronização)
Sincronizar (F7)
Pressione F7 – Sincronizar para importar os dados dos XMLs. O sistema irá:
- Importar os credores e criar ou atualizar os respectivos fornecedores em Contas a Pagar
- Importar os empenhos e registrá-los no Ello
- Exibir um log de progresso e confirmar “Importação de dados concluída!!!” ao final
<note>Se o XML estiver com um erro de formato (problema conhecido do Agili Blue), o sistema detecta automaticamente e oferece a correção. Confirme Sim para prosseguir.</note>
Imprimir Etiquetas (F8)
Selecione um ou mais empenhos na lista e pressione F8 – Etiqueta para imprimir as etiquetas na impressora configurada.
- Para selecionar múltiplos empenhos: segure Ctrl e clique em cada linha desejada
- Limite: até 50 etiquetas por impressão
- A impressão é enviada diretamente para a impressora padrão definida nos parâmetros (sem prévia em tela)
Fornecedores Vinculados
Após a sincronização, os credores dos empenhos ficam disponíveis como fornecedores em Contas a Pagar → Fornecedores. O vínculo é feito automaticamente pelo CNPJ ou CPF.
A partir daí é possível:
- Registrar o pagamento do fornecedor (baixa do título)
- Lançar um crédito em favor do fornecedor, se necessário
- Consultar o histórico de transações pelo botão de estatísticas
Departamentos de RH
Em RH → Departamentos, a Prefeitura organiza o quadro de pessoal por secretaria ou setor para fins de folha de pagamento e coleta de ponto.
- Cada departamento tem um código de três dígitos e uma descrição
- Departamentos inativos aparecem riscados na lista; use “Ver Inativos” para exibi-los ou ocultá-los
- Para cadastrar ou editar um departamento, selecione-o e pressione Enter (ou o botão de edição)
Fluxo de Trabalho Típico
- Configurar os parâmetros (pasta, nomes dos XMLs e impressora)
- Exportar os arquivos do Agili Blue e copiá-los para a pasta configurada
- Abrir Prefeitura → Empenhos e pressionar F7 – Sincronizar
- Aguardar o log de importação e confirmar a conclusão
- Revisar a lista de empenhos importados
- Selecionar os empenhos desejados e pressionar F8 para imprimir as etiquetas
- Acessar Contas a Pagar → Fornecedores para registrar os pagamentos devidos
Problemas Comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| “Arquivo não encontrado” ao sincronizar | Caminho ou nome do arquivo incorreto nos parâmetros | Verificar a pasta e os nomes dos arquivos XML em Parâmetros do Sistema |
| Coluna “Fornecedor” vazia na lista | CNPJ do credor ainda não foi importado | Executar F7 – Sincronizar para importar os credores primeiro |
| Etiqueta não imprime | Nenhum empenho selecionado ou impressora incorreta | Selecionar ao menos um empenho; conferir o parâmetro “Impressora padrão” |
| Erro de formato no XML (Agili Blue) | Bug conhecido na exportação do Agili Blue | Confirmar “Sim” na tela de correção automática que o Ello exibe |
| Empenho não aparece na lista após sincronização | XML não estava atualizado na pasta | Verificar se o arquivo correto foi copiado para a pasta antes de sincronizar |