Ello - Base de Conhecimentos

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á:

  1. Importar os credores e criar ou atualizar os respectivos fornecedores em Contas a Pagar
  2. Importar os empenhos e registrá-los no Ello
  3. 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

  1. Configurar os parâmetros (pasta, nomes dos XMLs e impressora)
  2. Exportar os arquivos do Agili Blue e copiá-los para a pasta configurada
  3. Abrir Prefeitura → Empenhos e pressionar F7 – Sincronizar
  4. Aguardar o log de importação e confirmar a conclusão
  5. Revisar a lista de empenhos importados
  6. Selecionar os empenhos desejados e pressionar F8 para imprimir as etiquetas
  7. 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