NFeEnviaManDest

A função NFeEnviaManDest é usada para enviar para a SEFAZ uma manifestação do destinatário sobre uma NF-e já autorizada.

Tipo de Retorno

Integer

Pacote

A função NFeEnviaManDest está definida dentro do pacote NF-eEnviaManDest.pkg.

Sintaxe

Move (NFeEnviaManDest({sSiglaWS}, {iTpAmbiente}, {sNomeCertificado}, ;
                      &{sMsgDados}, &{sMsgRetWS}, &{sMsgResultado}, ;
                      {sChaveNFe}, {sCnpjAutor}, {sDhEvento}, {iTpEvento}, ;
                      {sJust}, &{sNrProtocolo}, &{sDhProtocolo}, {sProxy}, ;
                      {sUsuario}, {sSenha} , {sLicenca}, {bExibeErro}, ;
                      &{sXmlRet} [, {sArquivoXML}, {sArquivoXMLPedido})] ;
                      to {iRet}

Onde:

  • {sSiglaWS} informar "AN". O WS do Ambiente Nacional (AN) atende a todas as UFs. Os destinatários do RS que desejarem utilizar o WS do RS podem informar "RS";
  • {iTpAmbiente} é ambiente de trabalho, podendo ser 1-Produção ou 2-Homologação;
  • {sNomeCertificado} é 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;
  • &{sMsgDados} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá o XML completo que foi enviado ao Web Service. Normalmente esta informação é útil somente para o propósito de depuração é não é usada na prática pelo emitente;
  • &{sMsgRetWS} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá a mensagem XML de resposta do Web Service. Normalmente esta informação é útil somente para o propósito de depuração é não é usada na prática pelo emitente;
  • &{sMsgResultado} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá a mensagem literal do resultado da chamada do Web Service. Por exemplo, se você tentar baixar uma NF-e que não existe, receberá o seguinte retorno: "Rejeição: Chave de Acesso inválida (número NF = 0)";
  • {sChaveNFe} é a chave da NF-e que se quer manifestar;
  • {sCNPJAutor} é o CNPJ do autor da manifestação, que é o destinatário da NF-e, sendo que não é necessário se preocupar em remover traços, separadores ou espaços, pois a função removerá os caracteres de formatação;
  • {sDhEvento} é a data e hora do evento, e deve ser informado no formato "AAAA-MM-DD HH:MM:SSTZD", onde TSD pode ser -02:00 (Fernando de Noronha), -03:00 (Brasília) ou -04:00 (Manaus) ou -01:00, -02:00 e -03:00 no horário de verão. A partir da versão 2022/01, caso o parâmetro não seja informado, a função irá informar automaticamente a data e hora do computador;
  • {iTpEvento} é o tipo do evento, que pode ser: 0-Confirmação da Operação; 1-Ciência da Operação; 2-Desconhecimento da Operação; 3-Registro da Operação não Realizada;
  • {sJust} é a justificativa da manifestação, sendo essa informação obrigatória para o evento do tipo “3-Registro da Operação não Realizada”. Para os outros eventos esse parâmetro será desprezado;
  • &{sNrProtocolo} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá o número do protocolo de autorização do recebimento da manifestação;
  • &{sDhProtocolo} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá a data do registro da manifestação no formato UTC com a indicação do fuso horário;
  • {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;
  • {sLicenca} é usado para informar a chave da licença de uso ou registro quando a função é utilizada em ambiente de produção;
  • {bExibeErro} é usado para indicar se a função deve exibir ou não os erros que ocorrerem na execução;
  • &{sXMLRet} é uma variável do tipo String que precisa ser passada por referência e que após a execução da função receberá o XML da manifestação com seu respectivo protocolo de autorização;
  • {sArquivoXML} é um parâmetro opcional onde deve ser informado o nome do arquivo em que o XML de retorno deverá ser salvo;
  • {sArquivoXMLPedido} é um parâmetro opcional onde deve ser informado o nome do arquivo em que o XML do pedido enviado para a SEFAZ deverá ser salvo;
  • {iRet} é o código do retorno da chamada da função em que 0 (zero) indica que a manifestação foi registrada com sucesso e qualquer valor diferente de 0 (zero) indica que houve erro.

Exemplo

Um exemplo de uso da função pode ser encontrado dentro da Workspace de Exemplo no botão oButtonManifestar na view Destinacaovw. Abaixo a função citada e a chamada da função da Library na linha 22.

NFeEnviaManDest

Observações

  • Após um dia da liberação da versão 2020/01, foi desligado o WS de eventos da versão 1.00. Com isso, a função NFeEnviaManDest passou a apresentar erro. Este problema estará corrigido na próxima versão da NFeLibrary. Se você utiliza esta função, para contornar, abra o pacote e procure por “1.00” e substitua por “4.00”. Nosso suporte está à disposição em caso de dúvidas nesta alteração. Esta alteração está feita na versão 2021/01.
  • Esta função está disponível a partir da versão 2.1.1.5.0 da NFeLibrary.dll (NFeLibraryDLL2Gv1.1e.zip). As licenças de emissão adquiridas após 29/02/2012 tem direito de receber uma nova chave de licença que permite o uso desta função. As licenças de emissão adquiridas antes de 29/02/2012 precisarão atualizar a licença de emissão para receber a nova chave que permite o uso desta função. Entre em contato conosco para mais informações sobre como atualizar. O uso em ambiente de homologação não requer a chave da licença.

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