Método Consultar com novo parâmetro

Italo Giurizzato Junior · 24 Fevereiro, 2020

Olá Pessoal,

O método Consultar agora possui um novo parâmetro chamado: AExtrairEventos.

function Consultar(const AChave: String = ''; AExtrairEventos: Boolean = False) ; Boolean;

Para quem utiliza os métodos direto da classe WebServices, deve acrescentar a seguinte linha:

(...).WebServices.Consulta.ExtrairEventos := True ou False;

O que ocorre quando o campo ExtrairEventos possui o valor True?

Simples, quando realizamos um consulta a um DF-e além de retornar a sua situação é retornado também alguns eventos vinculados a ele, como por exemplo o evento de cancelamento.

Se o valor de ExtrairEventos for True o método Consultar vai se encarregar de verificar se no retorno contem eventos, caso afirmativo eles serão extraídos e salvos em disco nas pastas conforme o seu tipo.

Por exemplo, se no retorno tivermos o evento de cancelamento, será salvo na pasta: ...\Evento\Cancelamento o arquivo *-procEventoNFe.xml (caso estejamos consultando uma NF-e).

Essa nova funcionalidade esta disponível nos componentes: ACBrBPe, ACBrCTe, ACBrMDFe, ACBrNF3e e ACBrNFe.

Em breve tanto o ACBrMonitor quanto o ACBrLib vão passar a ter também essa funcionalidade.

O que eu ganho com essa nova funcionalidade no método Consultar.

Vamos supor que o seu cliente venha perder o XML da nota por exemplo, neste caso basta você ler os dados da nota do banco de dados, gerar e assinar o XML e por fim realizar uma consulta com o XML carregado, desta forma ao realizar a consulta a SEFAZ vai retornar o protocolo de autorização e o componente se encarrega de atualizar o XML acrescentando o protocolo nele, deixando-o assim um documento com validade jurídica.

Mas se o seu cliente perder o XML de um evento como por exemplo o de cancelamento, não tinha como refazer o mesmo, pois não temos um método para consultar eventos, aliais a SEFAZ não possui um serviço para esse fim.

Como dito acima o Consultar além de retornar a situação do documento e retorna também alguns eventos. Antes o componente ignorava esse conteúdo, mas agora foi implementado a extração dos eventos.

Resumindo caso o seu cliente venha perder o XML de um evento (*-procEventoNFe.xml), lembre-se que o método Consultar pode recuperar ele novamente, desde que esse tipo de evento que foi perdido é retornado pelo Consultar.

Espero que tenham gostado dessa nova funcionalidade.