Mudanças entre as edições de "Manuais:UniNFe/Envio DFe Processo Sincrono"
(→Layout do arquivo TXT (Somente para NFe e NFCe)) |
(Ajustado cor e tamanho do título e do "Veja também") |
||
Linha 1: | Linha 1: | ||
__NOTITLE__ | __NOTITLE__ | ||
− | ==Envio do XML da NFe, NFCe ou CT-e OS no processo síncrono== | + | ==<font color=#008000>'''Envio do XML da NFe, NFCe ou CT-e OS no processo síncrono'''</font>== |
O envio utilizando-se do processo síncrono só foi disponibilizado pela SEFAZ para os documentos de [[Manuais:UniNFe/DFe|NF-e, NFC-e ou CT-e OS]]. | O envio utilizando-se do processo síncrono só foi disponibilizado pela SEFAZ para os documentos de [[Manuais:UniNFe/DFe|NF-e, NFC-e ou CT-e OS]]. | ||
− | ===Enviando o arquivo no formato XML=== | + | ===<font color=#008000>Enviando o arquivo no formato XML</font>=== |
Para enviar o XML da [[Manuais:UniNFe/DFe|NF-e, NFC-e ou CT-e OS]], basta gerar o arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]] com o nome e formato a seguir: | Para enviar o XML da [[Manuais:UniNFe/DFe|NF-e, NFC-e ou CT-e OS]], basta gerar o arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]] com o nome e formato a seguir: | ||
Linha 26: | Linha 26: | ||
* CT-e OS: 13140312345678901234670030000004591064552496-cte.xml | * CT-e OS: 13140312345678901234670030000004591064552496-cte.xml | ||
− | ====Tratando os arquivos gravados na pasta de retorno==== | + | ====<font color=#008000>Tratando os arquivos gravados na pasta de retorno</font>==== |
− | <u>'''Número do lote'''</u> | + | <u><font color=#008000>'''Número do lote'''</font></u> |
Logo após o ERP ter gravado o XML da [[Manuais:UniNFe/DFe|NF-e, NFC-e ou CT-e OS]] na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]], o UniNFe vai gerar um arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de retorno|pasta de retorno]] com o número do lote gerado. | Logo após o ERP ter gravado o XML da [[Manuais:UniNFe/DFe|NF-e, NFC-e ou CT-e OS]] na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]], o UniNFe vai gerar um arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de retorno|pasta de retorno]] com o número do lote gerado. | ||
Linha 43: | Linha 43: | ||
No conteúdo do arquivo de retorno (-num-lot.xml) existe uma tag com o número do lote gerado pelo UniNFe, que deve ser gravado na base de dados do sistema ERP para que este consiga localizar o arquivo de retorno com o número do protocolo de autorização retornado pelo WebService. | No conteúdo do arquivo de retorno (-num-lot.xml) existe uma tag com o número do lote gerado pelo UniNFe, que deve ser gravado na base de dados do sistema ERP para que este consiga localizar o arquivo de retorno com o número do protocolo de autorização retornado pelo WebService. | ||
− | <u>'''Número do protocolo de autorização, denegação ou código de rejeição'''</u> | + | <u><font color=#008000>'''Número do protocolo de autorização, denegação ou código de rejeição'''</font></u> |
Neste ponto o ERP deve continuar aguardando mais um retorno do UniNFe para finalizar o processo de envio, que é o XML com o protocolo de autorização/denegação ou status de rejeição. Veja abaixo a estrutura do nome do arquivo que será gerado na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de retorno|pasta de retorno]]: | Neste ponto o ERP deve continuar aguardando mais um retorno do UniNFe para finalizar o processo de envio, que é o XML com o protocolo de autorização/denegação ou status de rejeição. Veja abaixo a estrutura do nome do arquivo que será gerado na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de retorno|pasta de retorno]]: | ||
Linha 75: | Linha 75: | ||
Agora basta disparar a impressão do DANFe a partir do XML de distribuição gravado na pasta autorizados. Para isso, utilize o aplicativo [http://www.unidanfe.com.br UniDANFe]. | Agora basta disparar a impressão do DANFe a partir do XML de distribuição gravado na pasta autorizados. Para isso, utilize o aplicativo [http://www.unidanfe.com.br UniDANFe]. | ||
− | ===Enviando o arquivo no formato TXT (Somente para NFe e NFCe)=== | + | ===<font color=#008000>Enviando o arquivo no formato TXT (Somente para NFe e NFCe)</font>=== |
Aos que desejarem gerar a nota fiscal no formato TXT, basta gerar o arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]] que o UniNFe fará a conversão para XML e executará o processo de envio conforme descrito no item “Enviando o arquivo no formato XML”. | Aos que desejarem gerar a nota fiscal no formato TXT, basta gerar o arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]] que o UniNFe fará a conversão para XML e executará o processo de envio conforme descrito no item “Enviando o arquivo no formato XML”. | ||
Linha 129: | Linha 129: | ||
Os retornos da SEFAZ serão gravados em XML e TXT (se configurado para isso). Todo o restante do processo deve ser analisado no item “Enviando o arquivo no formato XML”. | Os retornos da SEFAZ serão gravados em XML e TXT (se configurado para isso). Todo o restante do processo deve ser analisado no item “Enviando o arquivo no formato XML”. | ||
− | ====Layout do arquivo TXT (Somente para NFe e NFCe)==== | + | ====<font color=#008000>Layout do arquivo TXT (Somente para NFe e NFCe)</font>==== |
O layout do arquivo TXT utilizado pelo UniNFe, para gerar a NF-e ou NFC-e, está disponível no botão <span style="color: green">'''Layout'''</span> na tela principal do aplicativo. | O layout do arquivo TXT utilizado pelo UniNFe, para gerar a NF-e ou NFC-e, está disponível no botão <span style="color: green">'''Layout'''</span> na tela principal do aplicativo. | ||
− | ===Importante=== | + | ===<font color=#008000>Importante</font>=== |
* O XML gerado deve conter somente a estrutura da NF-e, NFC-e ou CT-e OS, ou seja, não insira as [[Manuais:UniNFe/Envio DFe/TagsEnvioLoteDFe|tags específicas da montagem do XML de lote]], pois o UniNfe já se executa a tarefa. | * O XML gerado deve conter somente a estrutura da NF-e, NFC-e ou CT-e OS, ou seja, não insira as [[Manuais:UniNFe/Envio DFe/TagsEnvioLoteDFe|tags específicas da montagem do XML de lote]], pois o UniNfe já se executa a tarefa. | ||
Linha 139: | Linha 139: | ||
* O processamento da NF-e, NFC-e ou CT-e OS, no processo síncrono, é mais rápido e consome menos recursos dos servidores da SEFAZ, pois evita uma consulta, a do recibo. | * O processamento da NF-e, NFC-e ou CT-e OS, no processo síncrono, é mais rápido e consome menos recursos dos servidores da SEFAZ, pois evita uma consulta, a do recibo. | ||
− | ===Veja também=== | + | ===<font color=#008000>Veja também</font>=== |
* [[Manuais:UniNFe/duv1|DF-e fica parado na pasta "EmProcessamento", o que faço para finalizar?]] | * [[Manuais:UniNFe/duv1|DF-e fica parado na pasta "EmProcessamento", o que faço para finalizar?]] | ||
* [[Manuais:UniNFe/duv2|DF-e foi autorizado e não gerou o arquivo de distribuição do DF-e, como faço para gerar?]] | * [[Manuais:UniNFe/duv2|DF-e foi autorizado e não gerou o arquivo de distribuição do DF-e, como faço para gerar?]] |
Edição das 10h06min de 16 de março de 2022
Envio do XML da NFe, NFCe ou CT-e OS no processo síncrono
O envio utilizando-se do processo síncrono só foi disponibilizado pela SEFAZ para os documentos de NF-e, NFC-e ou CT-e OS.
Enviando o arquivo no formato XML
Para enviar o XML da NF-e, NFC-e ou CT-e OS, basta gerar o arquivo na pasta de envio com o nome e formato a seguir:
CHAVEDFE-dfe.xml
CHAVEDFE | Chave do documento fiscal eletrônico |
-dfe.xml | Este conteúdo varia de acordo com o documento que está sendo enviado, conforme abaixo:
|
Exemplos:
- NF-e ou NFC-e: 13140312345678901234650030000004591064552496-nfe.xml
- CT-e OS: 13140312345678901234670030000004591064552496-cte.xml
Tratando os arquivos gravados na pasta de retorno
Número do lote
Logo após o ERP ter gravado o XML da NF-e, NFC-e ou CT-e OS na pasta de envio, o UniNFe vai gerar um arquivo na pasta de retorno com o número do lote gerado.
Se o UniNFe conseguir assinar e validar o XML, o nome do arquivo de retorno será o mesmo do envio, mudando somente a extensão (final), conforme abaixo:
13140312345678901234650030000004591064552496-num-lot.xml
Caso contrário, o nome do arquivo retornado será:
- NF-e ou NFC-e: 13140312345678901234650030000004591064552496-nfe.err
- CT-e OS: 13140312345678901234670030000004591064552496-cte.err
No conteúdo do arquivo de retorno (-num-lot.xml) existe uma tag com o número do lote gerado pelo UniNFe, que deve ser gravado na base de dados do sistema ERP para que este consiga localizar o arquivo de retorno com o número do protocolo de autorização retornado pelo WebService.
Número do protocolo de autorização, denegação ou código de rejeição
Neste ponto o ERP deve continuar aguardando mais um retorno do UniNFe para finalizar o processo de envio, que é o XML com o protocolo de autorização/denegação ou status de rejeição. Veja abaixo a estrutura do nome do arquivo que será gerado na pasta de retorno:
NUMEROLOTE-pro-rec.xml
NUMEROLOTE | Número do lote sequencial gerado pelo UniNFe com 15 dígitos. Este número não se repete (Chave Única). |
-pro-rec.xml | Conteúdo fixo. Sempre será "-pro-rec.xml" |
Exemplo:
000000000000016-pro-rec.xml (se tudo correu bem)
ou
000000000000016-pro-rec.err (se houve algum erro)
Dentro do XML retornado, no caso de nenhum erro ou rejeição, é disponibilizado uma tag com número do protocolo de autorização. Este número deve ser gravado na base do ERP, pois será utilizado em outras situações.
Se a nota fiscal foi autorizada ou denegada, o UniNFe efetuará a cópia do XML para a pasta de XML Enviados Autorizados ou Denegados e de Backup, além de criar o XML de distribuição da NF-e, NFC-e ou CT-e OS com o protocolo anexado, tendo o mesmo nome do XML enviado, mudando somente a extensão (final), conforme abaixo:
- NF-e ou NFC-e: 13140312345678901234650030000004591064552496-procNFe.xml
- CT-e OS: 13140312345678901234650030000004591064552496-procCTe.xml
Agora basta disparar a impressão do DANFe a partir do XML de distribuição gravado na pasta autorizados. Para isso, utilize o aplicativo UniDANFe.
Enviando o arquivo no formato TXT (Somente para NFe e NFCe)
Aos que desejarem gerar a nota fiscal no formato TXT, basta gerar o arquivo na pasta de envio que o UniNFe fará a conversão para XML e executará o processo de envio conforme descrito no item “Enviando o arquivo no formato XML”.
O nome do arquivo TXT deve ter o seguinte formato:
NUMERODANF_CNPJ_SERIE_DIA_MES_ANO-nfe.txt
NUMERONF | Número da nota fiscal com 9 dígitos e zeros a esquerda. |
CNPJ | CNPJ da empresa geradora da nota fiscal. |
SERIE | Série da NFe com 3 dígitos e zeros a esquerda. |
DIA_MES_ANO | Dia, mês e ano da emissão da nota fiscal. |
-nfe.xml | Conteúdo fixo. Sempre será "-nfe.xml" |
Exemplo:
123456789_12345678901234_001_19_06_2015-nfe.txt
Depois de gerado o TXT na pasta de envio o ERP deve aguardar o UniNFe gerar um arquivo na pasta de retorno para pegar o número da chave da nota fiscal gerada e arquivar em seu banco de dados para dar sequência ao processo.
O nome do arquivo de retorno é exatamente o mesmo do envio, veja abaixo:
123456789_12345678901234_001_19_06_2015-nfe.txt (se tudo correu bem)
ou
123456789_12345678901234_001_19_06_2015-nfe.err (se houve algum erro)
Dentro destes arquivos você encontrará as seguintes informações:
Se tudo correu bem (sem erros): cStat=01 xMotivo=Convertido com sucesso ChaveNfe=51080662675686000166550010000001041671821888
Se houve algum erro: cStat=99 xMotivo=Falha na conversão MensagemErro=XXXXXX...
Os retornos da SEFAZ serão gravados em XML e TXT (se configurado para isso). Todo o restante do processo deve ser analisado no item “Enviando o arquivo no formato XML”.
Layout do arquivo TXT (Somente para NFe e NFCe)
O layout do arquivo TXT utilizado pelo UniNFe, para gerar a NF-e ou NFC-e, está disponível no botão Layout na tela principal do aplicativo.
Importante
- O XML gerado deve conter somente a estrutura da NF-e, NFC-e ou CT-e OS, ou seja, não insira as tags específicas da montagem do XML de lote, pois o UniNfe já se executa a tarefa.
- Para um melhor entendimento dos arquivos enviados ou retornados dos webservices, é de fundamental importância a analise e estudo aprofundado do manual de integração do NF-e, NFC-e ou CT-e OS disponibilizado pela SEFAZ para que os tratamentos dos retornos sejam feitos com a maior eficácia.
- O processamento da NF-e, NFC-e ou CT-e OS, no processo síncrono, é mais rápido e consome menos recursos dos servidores da SEFAZ, pois evita uma consulta, a do recibo.