NFeLerXMLAutorizado

A função NFeLerXMLAutorizado é usada para carregar os dados de um arquivo XML de NF-e autorizado em uma estrutura que contém os dados completos da NF-e. É particularmente útil para verificar a autenticidade de uma NF-e recebida de um fornecedor e também para automatizar o processo de entrada do produto recebido.

Tipo de Retorno

tNFe

Pacote

A função NFeLerXMLAutorizado está definida dentro do pacote NF-eLerXMLAutorizado.pkg.

Sintaxe

Move (NFeLerXMLAutorizado({sArquivoXML}, {sCertificado}, {sProxy}, ;
                          {sUsuario}, {sSenha}, {bExibeErro} [, ;
                          {bVerificaAutenticidade}, ;
                          {bVerificaAssinatura}])) to {vtRet}

Onde:

  • {sArquivoXML} é o caminho completo do arquivo XML que será lido;
  • {sCertificado} é a string que representa o certificado digital que será usado na transmissão dos dados. Se não for informado, uma tela será exibida para o usuário escolher um dos certificados instalados para o usuário corrente. Veja mais detalhes sobre como informar este parâmetro clicando aqui;
  • {sProxy} é usado para informar o endereço do servidor proxy, se necesário. Por exemplo ’http://proxyserver:port’. Verificar com o cliente qual é o endereço do servidor proxy e a porta https, pois a porta padrão do https é 443 e, sendo assim, teríamos algo como ’http://192.168.15.1:443’;
  • {sUsuario} é usado para informar o usuário para autenticação no proxy, se necessário;
  • {sSenha} é usado informar a senha de autenticação no proxy, se necessário;
  • {bExibeErro} é usado para indicar se a função deve exibir ou não os erros que ocorrerem na execução;
  • {bVerificaAutenticidade} (obsoleto) é um parâmetro opcional usado para indicar se a função deve (True) ou não (False) verificar a autenticidade da NF-e na SEFAZ emitente. Caso seja omitido, o padrão é considerar esse parâmetro como True. Este parâmetro é considerado obsoleto a partir da versão 2015/02 e o valor padrão será False. Para consultar a situação da NF-e, utilize a função NFeConsultar.
  • {bVerificaAssinatura} é um parâmetro opcional que indica se a função deve validar a assinatura digital do arquivo antes de fazer a leitura, sendo False o valor padrão indicando que não será validada a assinatura;
  • {vtRet} é uma variável do tipo tNFe que receberá o retorno da chamada da função. O tipo tNFe é uma estrutura que receberá todos os dados do XML lido e o campo bSucesso contido dentro desta estrutura será True se a leitura for bem sucedida e False caso contrário. O campo sMensagem terá a mensagem descritiva do motivo da falha ou do sucesso.

Exemplo

Um exemplo de uso da função pode ser encontrado dentro da Workspace de Exemplo no botão oEscolherArquivoButton na view LerXMLAutorizado.vw. Abaixo a função citada e a chamada da função da Library na linha 09.

NFeLerXMLAutorizado

Observações

  • Na versão 2013/02 a função NFeLerXMLAutorizado foi alterada para validar a assinatura digital do arquivo e só carregar os dados contidos no XML se a assinatura fosse válida. Na versão 2014/01 foi introduzido o parâmetro opcional {bVerificaAssinatura} mudando o comportamento da função para o mesmo comportamento de antes da versão 2013/02, ou seja, a função não validará mais a assinatura e carregará o XML, e se for desejada a validação da assinatura do arquivo, deverá ser informado True no novo parâmetro {bVerificaAssinatura};
  • A leitura de um arquivo XML de uma NF-e pode falhar por diversos motivos, entre eles:
    • O XML não é um XML de NF-e;
    • O XML não é um XML autorizado (não contém os dados de autorização);
    • Se o parâmetro {bVerificaAutenticidade} for True e a NF-e não estiver autorizada na SEFAZ;
    • Se o parâmetro {bVerificaAssinatura} for True e a assinatura digital da NF-e não for válida.

Não encontrou o que precisava, entre em contato conosco.