Configuração do server Financeiro para NF Web (SrvMegaFinancNfWeb)

Para que serve este servidor

O Financeiro para NF Web é um programa que fica rodando em segundo plano, sozinho, sem ninguém precisar acompanhar. Ele trata uma exigência da Reforma Tributária: quando um título é baixado (pago) e nessa baixa há juros, multa ou desconto, esses valores precisam gerar um documento fiscal próprio.

O caminho é o seguinte:

1. O módulo Financeiro registra a baixa em uma fila de baixas pendentes, sempre que ela tiver juros, multa ou desconto.
2. Este servidor pega cada baixa dessa fila, avalia se ela realmente precisa gerar documento fiscal e, quando precisa, monta a nota fiscal na fila do Integrador de Notas Fiscais Web.
3. O Integrador de Notas Fiscais Web é quem transforma isso em nota fiscal oficial.

Ou seja, este servidor é a primeira etapa da corrente. Ele não emite nota: ele prepara.

Os parâmetros deste documento controlam o ritmo desse trabalho e com qual usuário ele é feito.

Como este servidor de aplicação opera

O termo servidor refere-se ao servidor de aplicação do ERP, e não à máquina física ou virtual onde ele está instalado. Este servidor de aplicação é disponibilizado como um executável independente, compatível com ambientes Windows e Linux. Cada execução ativa desse executável constitui uma instância do servidor, e uma mesma máquina pode executar uma ou mais instâncias. O comportamento, os parâmetros de configuração e o arquivo MegaConfig.xml são idênticos nas duas plataformas.

Do ponto de vista de arquitetura, este servidor é um processo autônomo de segundo plano um daemon, na terminologia de sistemas distribuídos. Ele carrega seu próprio temporizador interno a partir do MegaConfig.xml e decide sozinho quando trabalhar: a cada ciclo consulta a fila, reserva o que vai processar e segue, sem orquestrador, sem cadastro de agenda e sem nenhuma tela que o acione.

O padrão de integração que ele implementa é o de consumidor por varredura (Polling Consumer) sobre uma fila mantida em tabela. Como podem existir várias threads dentro da mesma instância, e várias instâncias em máquinas distintas, todas competindo pela mesma fila, o modelo é o de consumidores concorrentes (Competing Consumers), e a exclusividade de cada registro é garantida por bloqueio de linha no Oracle, não por um controlador central. Isso o distingue dos outros modelos que existem no ERP, pois:

• NÃO é um servidor de processamento sob demanda, que fica ocioso aguardando a chamada de uma tela;
• NÃO é um servidor de integração, acionado pela chegada de uma requisição ou de um arquivo externo; e,
• NÃO é um servidor de AGENDA, cuja execução é governada por um cadastro no banco que define janelas de horário e a máquina responsável.

Na prática, essa independência traz duas consequências:

• a capacidade cresce horizontalmente: basta subir mais instâncias, sem nenhuma configuração de coordenação entre elas e sem risco de a mesma pendência ser processada duas vezes;
• e, por não haver quem o convoque, a única garantia de que o trabalho está sendo feito é o processo estar de pé e é por isso que a inicialização automática e o acompanhamento do processo em execução deixam de ser conveniência e passam a ser parte da operação.

Onde configurar

Os parâmetros ficam no mesmo arquivo de configuração usado pelo restante do Mega:

MegaConfig.xml

No ambiente padrão de versão, o caminho é:

V:\Versao\Config\MegaConfig.xml

Se você não souber onde está o seu, procure pelo arquivo MegaConfig.xml na pasta onde o Mega foi instalado.

Como editar, passo a passo

1. Faça uma cópia de segurança do arquivo antes de mexer. Copie o MegaConfig.xml para um lugar seguro e renomeie a cópia, por exemplo MegaConfig_backup_2026-09-04.xml.
2. Abra o MegaConfig.xml com o Bloco de Notas (ou outro editor de texto simples). Não use Word.
3. Localize a linha </DOCUMENT>, no final do arquivo.
4. Cole o bloco de configuração (mostrado mais abaixo) antes dessa linha.
5. Salve o arquivo.
6. Pare e inicie o servidor novamente.

Os três parâmetros

USUARIO — em nome de quem o servidor trabalha

O servidor não é uma pessoa, mas todo lançamento no Mega precisa estar vinculado a um usuário. Este parâmetro define qual usuário será registrado como responsável pelas notas fiscais que o servidor preparar.

O que preencher: o código de um usuário que exista e esteja ativo no Mega, e que tenha permissão para emitir notas fiscais. A recomendação é criar um usuário exclusivo para essa finalidade (por exemplo, “REFORMA TRIBUTARIA”), assim fica simples identificar depois, nos relatórios e no histórico, o que foi gerado automaticamente.

THREADS — liga ou desliga o processamento

Neste servidor o parâmetro funciona como uma chave de duas posições. Ele aceita apenas dois valores:

Como acelerar, então: se a fila estiver acumulando, o caminho é reduzir o INTERVALO, e não mexer no THREADS.

INTERVALO — de quanto em quanto tempo olhar a fila

Define a pausa entre uma verificação da fila e a próxima. O valor é sempre em segundos.

O que preencher:

Recomendação: o valor de fábrica de 60 segundos é adequado para quase todos os cenários. Como uma baixa financeira não tem urgência de emissão imediata, não há necessidade de intervalos muito curtos. Evite valores abaixo de 10 segundos: cada verificação consulta o banco de dados, e verificações excessivas geram carga sem ganho real.

Quantidade de baixas por verificação

Independente da configuração, o servidor pega no máximo 10 baixas por verificação. Esse limite é fixo e não pode ser alterado pelo arquivo de configuração.

Para dimensionar: com o INTERVALO de fábrica (60 segundos), o servidor processa até 10 baixas por minuto, o que dá até 600 por hora. Se o seu volume for maior que isso, reduza o INTERVALO. Por exemplo, com 30 segundos a capacidade dobra para até 20 por minuto.

Bloco pronto para copiar

Cole este bloco no MegaConfig.xml, antes da linha </DOCUMENT>. Depois ajuste os valores conforme a sua necessidade.

	<!-- Server de geração de NF-e CBS/IBS a partir de baixas financeiras (SrvMegaFinancNfWeb) -->
	<SRVMEGAFINANCNFWEB>
		<!-- Código do usuário do ERP que executa o processo. Obrigatório maior que zero -->
		<USUARIO>1</USUARIO>
		<!-- Liga ou pausa o processamento. Apenas 0 ou 1 -->
		<THREADS>1</THREADS>
		<!-- Intervalo entre verificações da fila, em segundos -->
		<INTERVALO>60</INTERVALO>
	</SRVMEGAFINANCNFWEB>

Configurações sugeridas por cenário

Uso normal, na maioria dos ambientes

		<THREADS>1</THREADS>
		<INTERVALO>60</INTERVALO>

Volume alto de baixas com juros, multa ou desconto

		<THREADS>1</THREADS>
		<INTERVALO>30</INTERVALO>

Volume baixo, sem urgência

		<THREADS>1</THREADS>
		<INTERVALO>300</INTERVALO>

Pausar o processamento temporariamente, sem desligar o servidor

		<THREADS>0</THREADS>

Se algo não funcionar

Relação com o outro servidor

O fluxo completo é:

1. Baixa com juros/multa/desconto no Financeiro.
2. Financeiro para NF Web (este servidor) prepara a nota.
3. Integrador de Notas Fiscais Web emite a nota fiscal.
4. Nota fiscal disponível no Mega.

Se apenas este servidor estiver rodando, as baixas saem da fila do Financeiro mas a nota nunca é emitida. Se apenas o Integrador estiver rodando, as baixas do Financeiro nunca chegam até ele. Mantenha os dois ativos e configurados.

Regras de ouro

1. Sempre faça backup do MegaConfig.xml antes de alterar.
2. Sempre reinicie o servidor depois de salvar. Sem isso, nada muda.
3. Não tente aumentar o THREADS acima de 1. Para ganhar velocidade, reduza o INTERVALO.
4. Verifique se o Integrador de Notas Fiscais Web também está rodando. Sem ele, a nota fiscal não é emitida.

Como iniciar o servidor automaticamente (AUTOSTART)

Como fazer

1. Faça uma cópia de segurança do MegaConfig.xml.
2. Na máquina servidora, abra o Prompt de Comando e digite hostname. Anote o nome.
3. Abra o MegaConfig.xml com o Bloco de Notas e localize a seção <AUTOSTART>.
4. Dentro dela, crie (ou complete) o bloco com o nome da máquina:

	<AUTOSTART>
		<NOME_DA_MAQUINA>
			<DEFAULT>N</DEFAULT>
			<SRVMEGANFINTEGRADOR>S</SRVMEGANFINTEGRADOR>
			<SRVMEGAFINANCNFWEB>S</SRVMEGAFINANCNFWEB>
		</NOME_DA_MAQUINA>
	</AUTOSTART>

5. Salve o arquivo.
6. Feche e abra novamente o MegaServerStart (ícone na área de notificação do Windows).

S = liga automaticamente. N = não liga.

Nome da tag de cada servidor

Cuidados

• Cuidado com nome repetido. Se o mesmo servidor aparecer duas vezes no bloco, o MegaServerStart não inicia e nenhum servidor da máquina sobe. Revise o bloco antes de salvar.
• Cuidado com a linha DEFAULT. Com S, ela liga todos os servidores da instalação e ignora a sua lista. Mantenha N.
• Cuidado com o nome da máquina. Use o da máquina servidora, não o da sua estação. Se o nome começar com número, escreva o bloco como <COMPUTADOR_NOME>.
• Cuidado ao concluir que não funcionou. A primeira tentativa ocorre poucos segundos após abrir o MegaServerStart, mas as seguintes são espaçadas (até 25 minutos). Aguarde alguns minutos antes de mexer de novo.
• Confirme que <USAMEGACONNECTIONMANAGER>S</USAMEGACONNECTIONMANAGER> está com S. Se estiver N, o AUTOSTART é ignorado — acione a equipe técnica, não altere por conta própria.
• Não altere nem remova a linha SRVMEGARUNNER, se existir.
• Em servidores Linux esta seção não tem efeito. Trate a inicialização automática com o suporte Mega.

Conferir se subiu

Gerenciador de Tarefas (Ctrl + Shift + Esc), aba “Detalhes”, procure por SrvMegaNfIntegrador.exe e SrvMegaFinancNfWeb.exe.