Manuais:UniNFe/GerarChaveDFe

De unimake
Revisão de 11h43min de 17 de março de 2022 por Wesley (discussão | contribs) (Ajustado cor e tamanho do título e do "Veja também")
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Gerar chave do DFe

O UniNFe dispõe de um serviço de geração da chave da NFe, para utilizar este serviço basta gerar na pasta de envio o XML ou TXT. Veja na sequencia a estrutura dos arquivos de requisição e retorno:

Documentos que podem ser consultados

Enviando o arquivo no formato XML

Nome do arquivo: ID-gerar-chave.xml

ID Identificador único qualquer. Evite repetição para não ocorrer sobreposição de notas geradas por vários terminais ao mesmo tempo.
-gerar-chave.xml Conteúdo fixo. Sempre será "-gerar-chave.xml"

Exemplo: 1234567890-gerar-chave.xml

Estrutura do XML de solicitação do serviço

<?xml version="1.0" encoding="utf-8"?>
<gerarChave>
  <UF>51</UF>             //Se não informado vai assumir o que está configurado no UniNFe
  <tpEmis>1</tpEmis>      //Se não informado vai assumir o que está configurado no UniNFe
  <nNF>104</nNF>
  <cNF>67182188</cNF>     //Se não informado o UniNFe vai gerar este código automaticamente
  <serie>1</serie>
  <AAMM>0310</AAMM>
  <CNPJ>00000000000000</CNPJ>
  <mod>55</mod>
</gerarChave>

Estrutura do XML de Retorno

O UniNFe detectando o XML de solicitação ele gera a Chave e grava um arquivo na pasta de retorno com a chave composta.

O nome do arquivo de retorno será o mesmo da solicitação mudando somente o final para: -ret-gerar-chave.xml, exemplo: 1234567890-ret-gerar-chave.xml

<?xml version="1.0" encoding="UTF-8"?>
<retGerarChave>
  <chaveNFe>35091255801377000131550010000000010000176506</chaveNFe>
</retGerarChave>

Se ocorrer algum erro na solicitação do serviço, o UniNFe vai gerar um arquivo com o mesmo nome da solicitação mudando somente a extensão para .ERR (exemplo: 1234567890-ret-gerar-chave.err), desta forma o ERP deve monitorar também a existência deste arquivo na pasta de retorno.

Enviando o arquivo no formato TXT

O nome do arquivo deve ter o mesmo formato do XML, porém com extensão TXT (.txt).

Layout do arquivo TXT

UF|35        //Se não for informado vai assumir o que está configurado no UniNFe
tpEmis|1     //Se não for informado vai assumir o que está configurado no UniNFe
nNF|1000
cNF|0        //Se não for informado o UniNFe vai gerar este código automaticamente
serie|1
AAMM|0912
CNPJ|00800077000130

Estrutura do TXT de Retorno

O nome do arquivo de retorno é o mesmo do XML, mudando somente a extensão para TXT (.txt).

35091255801377000131550010000000010000176506

Deve-se monitorar os arquivos de retorno quando ocorrem erros, conforme envio no formato XML.