====== 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 |