Home 5 NFeLibrary 5 Documentação 5 Funções 5 NFeInfPerecimentoPerdaRouboFurtoFOBEv

NFeInfPerecimentoPerdaRouboFurtoFOBEv

A função NFeInfPerecimentoPerdaRouboFurtoFOBEv é usada para enviar o evento “Perecimento, perda, roubo ou furto durante o transporte contratado pelo adquirente” da NF-e – Código do evento: 211124.

Tipo de Retorno

Boolean

Pacote

A função NFeInfPerecimentoPerdaRouboFurtoFOBEv está definida dentro do pacote NF-eInfPerecimentoPerdaRouboFurtoFOBEv.pkg.

Sintaxe

Move (NFeInfPerecimentoPerdaRouboFurtoFOBEv(&{vParams})) to {bRet} 

Onde:

  • &{vParams} é uma variável do tipo tNFeInfPerecimentoPerdaRouboFurtoFOBEv. Deve ser passada por referência. Contém os parâmetros para execução da função e também retornos, conforme abaixo:
      • sSiglaWS: é a sigla do Web Service para o qual será enviado o evento. Atualmente o “SVRS” atende a todas as UFs para este evento;
      • iTipoAmbiente: indica o ambiente para onde o evento será enviado, sendo 1-Produção e 2-Homologação;
      • sVersao: versão do evento. Se for deixado em branco, será usado o valor “4.00”;
      • 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;
      • sChaveNFe: é a chave da NF-e para a qual será registrado o evento;
      • sCNPJCPFAutor: é o CNPJ/CPF do autor do Evento;
      • sDhEvento: é a data e hora do evento no formato AAAA-MM-DDThh:mm:ss. Caso não seja informada, será pega da máquina local (no caso de aplicação Web, é pega do servidor);
      • iNroPerecPerdRouFurFOB: é o número sequencial do evento (relativo a este mesmo tipo de evento). Deve iniciar com 1 e vai até o máximo de 20. A sequência deve ser controlada pelo desenvolvedor e não deve duplicar;
      • sVerAplic: é a versão do aplicativo do autor do evento;
      • sProxy: é o endereço do servidor proxy que deve ser usado para realizar a consulta;
      • sUsuario: é o usuário que será autenticado no servidor proxy para realizar a consulta;
      • sSenha: é a senha do usuário que será autenticado no servidor proxy para realizar a consulta;
      • sLicenca: é usado para informar a chave da licença de uso quando a função é utilizada em ambiente de produção;
      • sPathXMLProtocoloAutorizado: é o caminho completo, finalizado com “.XML”, onde será salvo o XML quando o evento for autorizado;
      • sCdOrgaoAutor: é o código da UF do autor do Evento;
      • vgPerecimentoFOB: estrutura de array do tipo tNFeInfPerecimentoPerdaRouboFurtoFOBEv_gPerecimentoFOB que contém os seguintes parâmetros:
        • inItem: é o número do item da nota;
        • nvIBSgPerecimento: é o valor do IBS na nota de aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento;
        • nvCBSgPerecimento: é o valor do CBS na nota de aquisição correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento;
        • nqPerecimento: é a quantidade que foi objeto de roubo, perda, furto ou perecimento;
        • suPerecimento: é a unidade relativa ao parâmetro nqPerecimento;
        • nvIBS: é o valor do crédito IBS referente às aquisições a ser estornado correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento;
        • nvCBS: é o valor do crédito CBS referente às aquisições a ser estornado correspondente à quantidade que foi objeto de roubo, perda, furto ou perecimento.
      • bExibeErro: indica se as mensagens de erro do processo devem ser mostradas (TRUE) ou não (FALSE);
      • sRetMsgDados: retorna o XML usado para realizar a consulta no WS;
      • sRetMsgRetWS: retorna o XML recebido quando a consulta for realizada;
      • iRetCdRetorno: retorna o código numérico que representa o retorno da consulta realizada, podendo ser o código de retorno da DLL ou o código de retorno da consulta feita na SEFAZ;
      • sRetMsgResultado: retorna texto contendo a mensagem de retorno de acordo com iRetCdRetorno;
      • sRetMsgResultGravacao: texto contendo a mensagem retornada na tentativa de salvar o arquivo;
      • iRetCdGravacao: retorna o código relativo ao resultado da tentativa de salvar o arquivo XML, sendo: -1-ocorreu um erro ao tentar salvar e 0-arquivo salvo com sucesso.
      • sRetNroProtocolo: retorna o número do protocolo, quando o processo é realizado com sucesso;
      • sRetDhProtocolo: retorna a data e hora do protocolo no formato AAAA-MM-DDThh:mm:ss, quando o processo é realizado com sucesso;
      • sRetXMLProtocoloAutorizado: retorna o XML gerado pelo Web Service e o respectivo protocolo, quando executado com sucesso; 
    • {bRet} é uma variável do tipo boolean que recebe o retorno da função, sendo que TRUE indica que o Web Service foi consumido com sucesso e FALSE indica que algum erro ocorreu ao consumir o Web Service.

    Observação

    • A função está disponível a partir da versão 2025/01 da NFeLibrary.