Mudanças entre as edições de "Manuais:UniNFe/GerarChaveDFe"
(Criou página com '==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 Manuais:UniNFe/Confi...') |
(Adicionado __NOTITLE__) |
||
Linha 1: | Linha 1: | ||
+ | __NOTITLE__ | ||
==Gerar chave do [[Manuais:UniNFe/DFe|DFe]] == | ==Gerar chave do [[Manuais:UniNFe/DFe|DFe]] == | ||
Edição das 07h53min de 16 de fevereiro 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.