1. Geração Kit do Faturamento

Objetivo

Documentar o procedimento completo para geração e processamento do kit do faturamento, com orientação tanto na interface do sistema (UI) quanto nos passos técnicos necessários para processar o item pendente.

Visão geral

O usuário inicia a geração do kit pela interface do sistema. Após a operação, o processo fica com status Pendente e deve ser processado por um serviço/sistema responsável que gera o arquivo final (kit) disponível para download.

Passo a passo — Interface

1. No sistema, abra: Mais opções > Relatórios > Kit do Faturamento.
2. Preencha os campos de filtro conforme o período e parâmetros desejados.
3. Clique em Gerar. O registro aparecerá com status Pendente e ficará aguardando o processamento. Próximo passo: realizar o processamento técnico do kit (siga a seção abaixo).

Pré-requisitos

• Repositório do projeto (branch de testes) disponível: https://dev.azure.com/employertec/Etec.WFat/_git/Etec.WFat?version=GBteste
• Ambiente de testes configurado e com permissões adequadas
• Ferramentas para compilar/rodar o serviço (.NET/Visual Studio conforme o projeto)

Processamento técnico (configuração e execução)

1. Abra o arquivo de configuração do serviço:

   Employer.Plataforma.Services.PreFaturaGeracao\App.config

2. Atualize as connectionStrings para apontar ao banco de testes ou ao ambiente desejado. Exemplo:

<connectionStrings>
	<add connectionString="Data Source=EMPVW02251\PRE309;Initial Catalog=WIF_PRD2;User ID=connection_app;Password=123;Application Name=Conexao_Servico_PreFatura" name="CONNSTRINGBASE" />
	<add connectionString="Data Source=EMPVW02251\PRE310;Initial Catalog=PLATAFORMA_MODELO;User ID=plataforma_app;Password=123;Application Name=PlataformaBase_Servico_PreFatura" name="CONNSTRINGPLATAFORMABASE" />
	<add connectionString="Data Source=EMPVW02251\PRE309;Initial Catalog=PLATAFORMA_LOGERRO_PRD2;User ID=auditoria_app;Password=123;Application Name=Conexao_Servico_PreFatura" name="QueryLog" />
	<add connectionString="metadata=res://*/BDLogErro.csdl|res://*/BDLogErro.ssdl|res://*/BDLogErro.msl;provider=System.Data.SqlClient;provider connection string=\"Data Source=EMPVW02251\\PRE309;Initial Catalog=PLATAFORMA_LOGERRO_PRD2;Persist Security Info=True;User ID=logerro_app;Password=123;MultipleActiveResultSets=True\"" name="PLATAFORMA_LOG_HOM_ERROEntities" providerName="System.Data.EntityClient" />
</connectionStrings>

3. No projeto Employer.Plataforma.Services.GerarKITFaturamento, ajuste o Program.cs para executar diretamente a rotina de geração quando necessário. Por exemplo, comente a lógica de execução como serviço e mantenha apenas a chamada de inicialização:

using System.ServiceProcess;

namespace Employer.Plataforma.Services.GerarKITFaturamento
{
	static class Program
	{
		static void Main()
		{
			GerarKITFaturamento.InicializarServico();
		}
	}
}

4. Para gerar o kit de um registro específico, identifique o Idf_Notas executando a query abaixo no banco de dados:

SELECT 
	ln.Idf_Notas, l.Idf_Lotes,
	ln.Idf_Fatura, lr.Idf_Relatorios,
	ln.Idf_Lotes_Notas, lr.Idf_Lotes_Relatorios,
	l.Idf_Empresa, l.Idf_Usuario_Gerador,
	ln.Idf_Contrato, ln.Dta_Inicio, ln.Dta_Fim
FROM employer.FAT_KIT_Faturamento_Lotes_Relatorios lr
JOIN employer.FAT_KIT_Faturamento_Lotes_Notas ln ON lr.Idf_Lotes_Notas = ln.Idf_Lotes_Notas
JOIN employer.FAT_KIT_Faturamento_Lotes l ON l.Idf_Lotes = ln.Idf_Lotes
WHERE l.Idf_Status_Lotes = 1

5. Com o Idf_Lotes em mãos, ajuste a query usada no código-fonte para forçar a geração para esse registro. O arquivo onde essa query pode ser alterada é:

   E:\Projetos\Repos\Etec.WFat\Employer.Plataforma.BLL.wFat\KITFaturamentoLotesNotas_P2.cs

   Localize o trecho de construção da query (aprox. linha indicada no projeto) e adicione o filtro:

   AND ln.Idf_Lotes = <numero_capturado>

6. Compile e execute o projeto/serviço Employer.Plataforma.Service.GerarKITFaturamento para processar os kits pendentes.

Verificação após processamento

1. Volte à tela Kit do Faturamento no sistema.
2. Confirme que o registro anteriormente em Pendente aparece como Finalizado.
3. Clique no botão de download e valide o conteúdo do kit gerado.
4. Verifique logs do serviço e tabelas de auditoria para confirmar execução sem erros.

Checklist rápido

• Configuração de App.config revisada e apontando para o ambiente correto
• Program.cs ajustado para execução de teste
• Idf_Notas identificado (quando necessário)
• Serviço executado e logs verificados
• Kit gerado e arquivo validado via UI