NFeGeraXMLEmitente (obsoleta)

Função obsoleta: a partir da versão 2018/01 da NFeLibrary, esta função é considerada obsoleta. Ela será mantida ainda nesta versão da Library, mas não será mais atualizada ou corrigida. Os desenvolvedores devem utilizar apenas a função NFeGeraXMLNFe4_00 para gerar o arquivo XML da NF-e. Futuramente o pacote será removido em definitivo do produto.

A função NFeGeraXMLEmitente é usada para gerar um arquivo XML com os dados do emitente de uma NF-e ou, como é usada na grande maioria dos casos, gerar o conteúdo  no formato XML que poderá ser inserido no arquivo XML completo da NF-e criado através da função NFeGeraXMLNFe.

A imagem abaixo mostra a estrutura do elemento emit.

Elemento_emit

A recomendação de uso desta função é criar um pacote com uma nova função global que sirva de interface entre o sistema e a chamada da função NFeGeraXMLEmitente. Esta função intermediária poderia receber como parâmetros a identificação do registro do emitente, uma flag para indicar se o registro já está ou não posicionado no buffer, outra flag para indicar se a função deve ou não exibir erros e retornar o Handle do elemento emit criado.

Se a intenção de usar a função NFeGeraXMLEmitente é para criar um arquivo XML que possa ser usado para carga no software emissor da SEFAZ ou para troca de dados com outros aplicativos, então nesta nova função um outro parâmetro poderia ser definido para indicar o caminho do diretório onde o arquivo deve ser gerado.

Se o emitente da NF-e emitir notas com cobrança de ICMS por substituição tributária, também é recomendado a adição de um parâmetro para informar o número da inscrição estadual do substituto tributário da UF destino.

Tipo de Retorno

Handle

Pacote

A função NFeGeraXMLEmitente está definida dentro do pacote NF-eGeraXMLEmitente.pkg.

Sintaxe

Move (NFeGeraXMLEmitente({sDiretorio}, {sCNPJCPF}, {sxNome}, {sxFant}, ;
                         {sIE}, {sIEST}, {sIM}, {sCNAE}, {sxLgr}, ;
                         {sNro}, {sxCpl}, {sxBairro}, {icMun}, {sxMun}, ;
                         {sUF}, {sCEP}, {sFone}, {bRetornaHandle}, ;
                         {bExibeErro}, {iCRT})) to {hoRet}

Onde:

  • {sDiretorio} é o caminho do diretório onde será gerado o arquivo XML com os dados do emitente. Mesmo que não haja interesse em usar o arquivo XML, é obrigatório informar um diretório válido para a geração do arquivo. É possível informar, por exemplo, o diretório temporário do usuário corrente obtido a partir da variável de ambiente TEMP com o comando Get_Environment;
  • {sCNPJCPF} é o CNPJ ou CPF do emitente da NF-e, não sendo necessário remover caracteres de separação, pois a função se encarregará de removê-los. Este parâmetro é o conteúdo da tag CNPJ ou CPF do elemento emit;
  • {sxNome} é a razão social ou nome do emitente. Este parâmetro é o conteúdo da tag xNome do elemento emit;
  • {sxFant} é nome fantasia do emitente. Este parâmetro é o conteúdo da tag xFant do elemento emit;
  • {sIE} é a Inscrição Estadual (IE) do emitente, e deveser informado "ISENTO" se o emitente for contribuinte do ICMS mas não estiver obrigado à inscrição no cadastro de contribuintes do ICMS. Este parâmetro é o conteúdo da tag IE do elemento emit;
  • {sIEST} é a Inscrição Estadual do Substituto Tributário da UF de destino da mercadoria e deve ser informado quando houver retenção do ICMS ST para a UF de destino. Este parâmetro é o conteúdo da tag IEST do elemento emit;
  • {sIM} é a Inscrição Municipal do emitente e deve ser informada quando ocorrer a emissão de NF-e conjugada com prestação de serviços sugeitos ao ISSQN e fornecimento de peças sujeitas ao ICMS. Este parâmetro é o conteúdo da tag IM do elemento emit;
  • {sCNAE} é a CNAE fiscal do emitente e deve ser informada quando o parâmetro {sIM} for informado. Este parâmetro é o conteúdo da tag CNAE do elemento emit;
  • {sxLgr} é o logradouro (sem número ou complemento) do endereço do emitente, por exemplo "Av. Paulista". Este parâmetro é o conteúdo da tag xLgr do elemento emit;
  • {sNro} é o número do endereço do destinatário, sendo esta informações obrigatória para geração do XML, mesmo quando o endereço não tem um número. Nesses casos pode ser informado, por exemplo, "SEM NUMERO" ou "S/N". Note que no caso de endereços como "Rodovia Fernão Dias, Km 129 + 200m" é possível informar no parâmetro {sxLgr} apenas "Rodovia Fernão Dias" e no parâmetro {sNro} informar "Km 129 + 200m". Este parâmetro é o conteúdo da tag nro do elemento emit;
  • {sxCpl} é o complemento do endereço do emitente e quando não houver complemento uma string nula deve ser informada. Este parâmetro é o conteúdo da tag xCpl do elemento emit;
  • {sxBairro} é o bairro do endereço do emitente. Este parâmetro é o conteúdo da tag xBairro do elemento emit;
  • {icMun} é o código do município do endereço do destinatário, sendo necessário utilizar a tabela do IGBE. Se a versão da NFeLibrary em uso for a versão Plus então é possível fazer uso da função NFePegaCodigoMunicipioIBGE para obter o código do município a partir de seu nome e da sigla da sua UF. Este parâmetro é o conteúdo da tag cMun do elemento emit;
  • {sxMun} é o nome do município do emitente. Este parâmetro é o conteúdo da tag xMun do elemento emit;
  • {sUF} é a sigla da UF do emitente. Este parâmetro é o conteúdo da tag UF do elemento emit;
  • {sCEP} é o código do CEP do emitente. Este parâmetro é o conteúdo da tag CEP do elemento emit;
  • {sFone} é o telefone do emitente. Este parâmetro é o conteúdo da tag fone do elemento emit;
  • {bRetornaHandle} se True for informado indica que a função deve retornar o identificador (Handle) do objeto nó dest que poderá ser usado pela função NFeGeraXMLNFe para gerar o arquivo XML completo da NF-e. Se este parâmetro for False o retorno ainda assim será o valor numérico que representou o objeto do nó dest, porém como o objeto foi destruído, uma posterior tentativa de usá-lo gerará erros imprevisíveis no programa;
  • {bExibeErro} é usado para indicar se a função deve exibir ou não os erros que ocorrerem na execução;
  • {iCRT} é o código de regime tributário do emitente. Este parâmetro é o conteúdo da tag CRT do elemento emit;
  • {hoRet} receberá o identificador (Handle) do objeto que representa o nó emit. Um retorno igual a 0 (zero) indica que houve um erro na chamada da função. Note que se não ocorrer erro a função sempre será retornado o identificador do nó emit, mas o nó só deve ser usado se o parâmetro {bRetornaHandle} for True, caso contrário o objeto não será válido, pois foi destruído e o valor diferente de 0 (zero) é apenas um indicador de que a função foi executada com sucesso.

Exemplo

Um exemplo de uso da função pode ser encontrado dentro da Workspace de Exemplo na função NFePreparaEmitenteExemploById no pacote NF-ePreparaEmitenteExemplo.pkg. Abaixo a função citada e a chamada da função da Library na linha 32.

NFeGeraXMLEmitente

Observações

  • Para maiores detalhes sobre os elementos e tags geradas por esta função e sobre o próprio elemento principal emit, por favor consulte o manual de integração mais recente disponível no Portal da NF-e.

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