Mudanças entre as edições de "Manuais:UniNFe/GerarChaveDFe"
(Adicionado __NOTITLE__) |
(Ajustado cor e tamanho do título e do "Veja também") |
||
Linha 1: | Linha 1: | ||
__NOTITLE__ | __NOTITLE__ | ||
− | ==Gerar chave do [[Manuais:UniNFe/DFe|DFe]] == | + | ==<big><font color=#008000>'''Gerar chave do [[Manuais:UniNFe/DFe|DFe]]'''</font></big>== |
O UniNFe dispõe de um serviço de geração da chave da NFe, para utilizar este serviço basta gerar na [[Manuais:UniNFe/Configurando_o_UniNFe/Configuracoes_Empresas/ConfigAbaPastas/Pasta_de_envio|pasta de envio]] o XML ou TXT. Veja na sequencia a estrutura dos arquivos de requisição e retorno: | O UniNFe dispõe de um serviço de geração da chave da NFe, para utilizar este serviço basta gerar na [[Manuais:UniNFe/Configurando_o_UniNFe/Configuracoes_Empresas/ConfigAbaPastas/Pasta_de_envio|pasta de envio]] o XML ou TXT. Veja na sequencia a estrutura dos arquivos de requisição e retorno: | ||
− | === Documentos que podem ser consultados === | + | === <font color=#008000>Documentos que podem ser consultados </font>=== |
* [[Manuais:UniNFe/DFe|NF-e]] | * [[Manuais:UniNFe/DFe|NF-e]] | ||
Linha 11: | Linha 11: | ||
* [[Manuais:UniNFe/DFe|MDF-e]] | * [[Manuais:UniNFe/DFe|MDF-e]] | ||
− | === Enviando o arquivo no formato XML === | + | === <font color=#008000>Enviando o arquivo no formato XML </font>=== |
Nome do arquivo: ID-gerar-chave.xml | Nome do arquivo: ID-gerar-chave.xml | ||
Linha 25: | Linha 25: | ||
Exemplo: 1234567890-gerar-chave.xml | Exemplo: 1234567890-gerar-chave.xml | ||
− | ====Estrutura do XML de solicitação do serviço==== | + | ====<font color=#008000>Estrutura do XML de solicitação do serviço</font>==== |
<pre> | <pre> | ||
Linha 41: | Linha 41: | ||
</pre> | </pre> | ||
− | ====Estrutura do XML de Retorno==== | + | ====<font color=#008000>Estrutura do XML de Retorno</font>==== |
O UniNFe detectando o XML de solicitação ele gera a Chave e grava um arquivo na [[Manuais:UniNFe/Configurando_o_UniNFe/Configuracoes_Empresas/ConfigAbaPastas/Pasta_de_retorno|pasta de retorno]] com a chave composta. | O UniNFe detectando o XML de solicitação ele gera a Chave e grava um arquivo na [[Manuais:UniNFe/Configurando_o_UniNFe/Configuracoes_Empresas/ConfigAbaPastas/Pasta_de_retorno|pasta de retorno]] com a chave composta. | ||
Linha 56: | Linha 56: | ||
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. | 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 === | + | === <font color=#008000>Enviando o arquivo no formato TXT </font>=== |
O nome do arquivo deve ter o mesmo formato do XML, porém com extensão TXT (.txt). | O nome do arquivo deve ter o mesmo formato do XML, porém com extensão TXT (.txt). | ||
− | ==== Layout do arquivo TXT ==== | + | ==== <font color=#008000>Layout do arquivo TXT</font> ==== |
<pre> | <pre> | ||
Linha 72: | Linha 72: | ||
</pre> | </pre> | ||
− | ====Estrutura do TXT de Retorno==== | + | ====<font color=#008000>Estrutura do TXT de Retorno</font>==== |
O nome do arquivo de retorno é o mesmo do XML, mudando somente a extensão para TXT (.txt). | O nome do arquivo de retorno é o mesmo do XML, mudando somente a extensão para TXT (.txt). |
Edição atual tal como às 11h43min de 17 de março de 2022
Índice
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.