Mudanças entre as edições de "Totall Nfe"

De TotaliWiki
Ir para: navegação, pesquisa
m
 
(60 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 1: Linha 1:
 +
{{Tags|Totall Commerce|Totall NFe}}
 +
{{Referencias}}
 +
 
== Conceito ==
 
== Conceito ==
  
O Totall Nfe é o sistema que grava os retornos de NF-e gerados pelo sistema Emissor DFe. E também é responsável por monitor o banco de dados para gerar instruções de cancelamento e inutilização para o Emissor DFe.  
+
O Totall NFe é o sistema que apóia o Checkout e o Backoffice no processo de emissão e cancelamento de NF-e. Esse sistema é dividido em dois módulos distintos.
  
== Composição ==
+
'''Totall Nfe GX:''' que é uma aplicação web que roda em um servidor Apache Tomcat.<BR/>
 +
Essa aplicação possui um serviço web que se conecta ao banco de dados do Emite Nf-e e atualiza os dados do Totall Commerce.
  
O Totall Nfe é divido em dois módulos distintos. Um que é uma aplicação ''client'' chamada '''TotallNfeApp''', que roda a partir da instalação de um serviço chamado '''TotallNfe'''; e outro que é uma aplicação web chamada '''TotallNfeGX'''.
+
'''Totall Nfe:''' que é uma aplicação ''client'' que é instalado como serviço do windows.<BR/>
 +
Ele é responsável pelo arquivamento dos arquivos processados, para que o diretório de integração fique o mais enxuto possível.<BR>
  
=== TotallNfeApp ===
+
[[Imagem:Overview_nfe.png|450px]]<BR/>
 +
'''Figura 1. Overview da interação entre os módulos.'''
  
ÿ a aplicação ''client'' que monitora o diretório de integração com o Emissor DFe (<tt>TD_FIL.PATNFE</tt>) para gravar o retorno da emissão ou gerar instruções de cancelamento e inutilização.
+
== Totall NFe (servidor) ==
  
=== TotallNfeGX ===
+
É a aplicação web que sincroniza o status da NF-e entre a base do Emite NF-e e o Totall Commerce.
 +
O link para acessá-lo é o seguinte:<BR>
 +
http://localhost:8082/TotallNfeGX/servlet/home
  
ÿ a aplicação web que faz a persistência e exibição dos dados de retorno. Ele é requisitado pelo '''TotallNfeApp''' para fornecer a lista de notas a cancelar ou inutilizar.
+
[[Imagem:Totallnfe-server.PNG|800px]]
 +
 
 +
== Totall NFe (local) ==
 +
 
 +
É a aplicação que monitora o diretório de integração com o Emite Nf-e (<tt>TD_FIL.PATNFE</tt>) para arquivar os arquivos já processados (".aut", ".imp" e ".ok").
 +
 
 +
=== Configurações Disponíveis ===
 +
 
 +
Dentro do arquivo <tt>TotallNfeApp.jar</tt>, em <tt>\br\com\totall\nfe\gui\</tt>, existe o arquivo <tt>config.properties</tt>.<br/>
 +
Extraia o arquivo para fora do <tt>.jar</tt>. O sistema dará preferência às configurações do arquivo externo.
 +
 
 +
'''Propriedades'''
 +
* delay_verifica_retornos é o tempo (em milisegundos) que o sistema aguarda entre as verificações do diretório onde são gravados os arquivos de NF-e (<tt>TD_FIL.PATNFE</tt>).
 +
* <del>delay_verifica_cancelamentos é o tempo (em milisegundos) que o sistema aguarda entre as verificações das notas canceladas no banco de dados.</del>
 +
* <del>delay_reprocessa_log é o tempo (em milisegundos) que o sistema aguarda para reprocessar um arquivo que foi processado com erros.</del>
 +
* <del>delay_apos_erro é o tempo (em milisegundos) que o sistema aguarda para continuar o processo após um erro tratado.</del>
 +
* dir_log é o caminho onde o sistema gera o log relativo ao monitoramento de diretórios.
 +
* <del>dir_arq é o caminho onde o sistema gera os arquivos de controle internos.</del>
 +
* dir_properties é o caminho onde o sistema verifica um config.properties externo. Esse arquivo não precisa conter todas as configurações. <br/>Ele pode conter apenas a linha level_log=DEBUG para que facilmente o implantar possa verificar o que o sistema está processando.<br/>Para utilizar um properties externo é necessário reiniciar o serviço.
 +
* level_log indica o nível de criticidade para registro de mensagens no log.<BR/>'''INFO''' mostra apenas mensagens informativas e erros.<BR/>'''DEBUG''' mostra, além das mensagens do INFO, uma série de mensagens para que se possa avaliar melhor alguma situação de problema.
 +
* nfegx_servidor é o IP (ou nome da máquina) do Apache onde o TotallNfeGX está instalado.
 +
* nfegx_porta é a porta que está sendo utilizada pelo Apache.
 +
* nfegx_nome é o nome da pasta dentro de webapps onde está a aplicação (é ''case sensitive'').
 +
 
 +
o diretório raíz de onde o processo é executado é a pasta <tt>TotallNfe\servico</tt>
 +
 
 +
'''Valores padrão'''
 +
* delay_verifica_retornos=300000
 +
* <del>delay_verifica_cancelamentos=900000</del>
 +
* <del>delay_reprocessa_log=3600000</del>
 +
* <del>delay_apos_erro=60000</del>
 +
* dir_log=../logs/
 +
* <del>dir_arq=../arqs/</del>
 +
* dir_properties=../
 +
* level_log=INFO
 +
* nfegx_servidor=localhost
 +
* nfegx_porta=8082
 +
* nfegx_nome=TotallNfeGX
  
 
== Instalação ==  
 
== Instalação ==  
Linha 19: Linha 64:
 
Verificar o artigo [[Instalação do Totall Nfe]].
 
Verificar o artigo [[Instalação do Totall Nfe]].
  
== Configurações Disponíveis ==
+
=== Log da Aplicação Servidora ===
  
Caso seja necessário, é possível descompactar o arquivo <tt>TotallNfeApp.jar</tt> (com o serviço desativado) e alterar as seguintes configurações:
+
Executar <tt>TOTALLNFE_HOME/GXServerConfig/config.bat</tt>.
Arquivo: <tt><raíz do .jar>\br\com\totall\nfe\gui\config.properties</tt>
+
  
'''Valores padrão'''
+
O programa GeneXus Application Client Configuration será executado.
delay_dir=2000
+
Nele navegue pelas seguintes opções:
delay_bd=5000
+
* Guia Namespaces
dir_log=../logs/
+
** Com default marcado aperte em Edit
 +
*** Guia JDBC Log Configuration
  
'''Propriedades'''
+
Configure da seguinte forma
* delay_dir é o tempo (em milisegundos) que o sistema aguarda entre as verificações do diretório onde são gravados os arquivos de NF-e (TD_FIL.PATNFE).
+
(X) Log JDBC Activity
* delay_bd é o tempo (em milisegundos) que o sistema aguarda entre as verificações das notas canceladas no banco de dados.
+
( ) Enable buffering
* dir_log é o caminho onde o sistema gera o log relativo ao monitoramento de diretórios. O seu caminho é contado a partir de onde o arquivo .jar está.
+
Log Detail: High
 +
(X) Use unique name
 +
Log Level: Namespace
 +
Path for log files: C:\TotallNfe\Logs
 +
 
 +
* Aperte Ok
 +
** Ok
 +
*** Save e Exit.<BR />
 +
Este processo atualizará o arquivo <tt>client.cfg</tt> que está na mesma pasta.<BR />
 +
Este arquivo deverá ser copiado para <tt>TOMCAT_HOME/webapps/TotallNfeGX/WEB-INF/classes/</tt>.<BR />
 +
 
 +
== Fluxo de Arquivos Otimista ==
 +
 
 +
=== Emissão de Nota Fiscal ===
 +
 
 +
Após gravar a venda, o Checkout gera o arquivo <TT>NF.ERP</TT> e o Emite NF-e devolve o <TT>NF.aut</TT>.<BR/>
 +
Após confirmação no banco de dados o sistema busca as NF-e com as situações descritas abaixo (<TT>TT_VEN.FLGNFE</TT>) e muda de acordo com a situação que se encontra no Emite NF-e, consultado a tabela <TT>docNFes</TT>.
 +
 
 +
{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
 +
! style="background:#efefef;" |''Código''
 +
! style="background:#efefef;" |''Descrição''
 +
|-
 +
|0
 +
|Não enviada
 +
|-
 +
|2
 +
|Rejeitada
 +
|-
 +
|6
 +
|Cancelada
 +
|-
 +
|8
 +
|Erro de importação
 +
|}
 +
'''Tabela 1. Situação das emissões antes do processamento.'''
 +
 
 +
NF-es nessa situação podem ser atualizadas para:
 +
{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
 +
! style="background:#efefef;" |''Código''
 +
! style="background:#efefef;" |''Descrição''
 +
|-
 +
|1
 +
|Autorizada
 +
|-
 +
|2
 +
|Rejeitada
 +
|-
 +
|6
 +
|Denegada
 +
|}
 +
'''Tabela 2. Situação das emissões após processamento.'''
 +
 
 +
=== Cancelamento de Nota Fiscal ===
 +
 
 +
'''O ATO COPETE ICMS 35/2010 formaliza que a partir de 01/01/2012 o emitente poderá'''
 +
'''solicitar o cancelamento da NF-e, ''em prazo não superior a 24 horas'', contado do'''
 +
'''momento em que foi concedida a respectiva Autorização de Uso da NF-e, desde que não'''
 +
'''tenha ocorrido a circulação da mercadoria ou a prestação de serviço e observadas'''
 +
'''demais normas constantes do Ajuste SINIEF 07/2005, de 5 de outubro de 2005.'''
 +
'''ATO COTEPE ICMS 35, DE 24 DE NOVEMBRO 2010 Publicado no DOU de 30.11.10'''
 +
 
 +
Ao logar no Totall Backoffice na tela "Problemas na Base de Dados" será apresentado o aviso
 +
de cancelamento da NF-e.
  
== Fluxo de Arquivos ==
+
No cancelamento da venda pelo Checkout/Backoffice o sistema gera o arquivo <TT>CANC.ERP</TT> e o Emite NF-e devolve o <TT>CANC.canc</TT>.<BR/>
 +
Após confirmação no banco de dados o sistema busca as NF-e com as situações descritas abaixo (<TT>TT_VEN.FLGNFE</TT>) e muda de acordo com a situação que se encontra no Emite NF-e, consultado a tabela <TT>docCancelamento</TT>.
  
Emissão de Nota Fiscal
+
{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
 +
! style="background:#efefef;" |''Código''
 +
! style="background:#efefef;" |''Descrição''
 +
|-
 +
|1
 +
|Autorizada
 +
|}
 +
'''Tabela 3. Situação dos cancelamentos antes do processamento.'''
  
Ao emitir uma venda pelo Totall Checkout ele gera o arquivo nf?.erp e imp?.erp.
+
NF-es nessa situação podem ser atualizadas para:
Emissor DFe altera nf?.erp para nf?.ok e cria um arquivo nf?.aut.
+
{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
O Totall Nfe altera para nf?.aut.ok e grava o retorno na tt_vrt.
+
! style="background:#efefef;" |''Código''
 +
! style="background:#efefef;" |''Descrição''
 +
|-
 +
|3
 +
|Cancelada
 +
|}
 +
'''Tabela 4. Situação dos cancelamentos após processamento.'''
  
Cancelamento de Nota Fiscal
+
=== Inutilização de Nota Fiscal ===
  
Totall Nfe busca no banco de dados as notas canceladas.
+
No cancelamento da venda pelo Checkout/Backoffice, caso a NF-e não se encontre autorizada, o sistema gera o arquivo <TT>INUT.ERP</TT> e o Emite NF-e devolve o <TT>INUT.canc</TT>.<BR/>
Caso a situação da venda no banco (TT_VEN.FLGNFE) seja "1" - Autorizada ou "6" - Denegada, o sistema gera o arquivo canc?.erp.
+
Após confirmação no banco de dados o sistema busca as NF-e com as situações descritas abaixo (<TT>TT_VEN.FLGNFE</TT>) e muda de acordo com a situação que se encontra no Emite NF-e, consultado a tabela <TT>docInutilizacao</TT>.
O Emissor DFe altera para canc?.ok e cria um nf?.canc.
+
TotallNfe altera para nf?.canc.ok e grava o retorno na tt_vrt.
+
  
Inutilização de Nota Fiscal
+
{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
 +
! style="background:#efefef;" |''Código''
 +
! style="background:#efefef;" |''Descrição''
 +
|-
 +
|0
 +
|Não enviada (Caso de erro de importação)
 +
|-
 +
|2
 +
|Rejeitada
 +
|-
 +
|6
 +
|Denegada
 +
|}
 +
'''Tabela 5. Situação das inutilizações antes do processamento.'''
  
Totall Nfe busca no banco de dados as notas canceladas.
+
NF-es nessa situação podem ser atualizadas para:
Caso a situação da venda no banco (TT_VEN.FLGNFE) seja diferente de "1" - Autorizada e "6" - Denegada, o sistema gera o arquivo inut?.erp.
+
{| cellpadding="6px" border=1 style="border:1px solid #C0C0C0; border-collapse:collapse;"
O Emissor DFe altera para inut?.ok e cria um nf?.inut.
+
! style="background:#efefef;" |''Código''
TotallNfe altera para nf?.inut.ok e grava o retorno na tt_vrt.
+
! style="background:#efefef;" |''Descrição''
 +
|-
 +
|4
 +
|Inutilizada
 +
|}
 +
'''Tabela 6. Situação das inutilizações após processamento.'''

Edição atual tal como às 16h39min de 25 de novembro de 2016

Tag-icone-mini.png Totall CommerceTotall NFe
Referenciado por: FAQ Totall NFe | Instalação do Totall Nfe | Nota Fiscal Eletrônica | Roteiro de Treinamento para Totall Nfe | Teste4 | Totall Commerce | 

Conceito

O Totall NFe é o sistema que apóia o Checkout e o Backoffice no processo de emissão e cancelamento de NF-e. Esse sistema é dividido em dois módulos distintos.

Totall Nfe GX: que é uma aplicação web que roda em um servidor Apache Tomcat.
Essa aplicação possui um serviço web que se conecta ao banco de dados do Emite Nf-e e atualiza os dados do Totall Commerce.

Totall Nfe: que é uma aplicação client que é instalado como serviço do windows.
Ele é responsável pelo arquivamento dos arquivos processados, para que o diretório de integração fique o mais enxuto possível.

Overview nfe.png
Figura 1. Overview da interação entre os módulos.

Totall NFe (servidor)

É a aplicação web que sincroniza o status da NF-e entre a base do Emite NF-e e o Totall Commerce. O link para acessá-lo é o seguinte:

http://localhost:8082/TotallNfeGX/servlet/home

Totallnfe-server.PNG

Totall NFe (local)

É a aplicação que monitora o diretório de integração com o Emite Nf-e (TD_FIL.PATNFE) para arquivar os arquivos já processados (".aut", ".imp" e ".ok").

Configurações Disponíveis

Dentro do arquivo TotallNfeApp.jar, em \br\com\totall\nfe\gui\, existe o arquivo config.properties.
Extraia o arquivo para fora do .jar. O sistema dará preferência às configurações do arquivo externo.

Propriedades

  • delay_verifica_retornos é o tempo (em milisegundos) que o sistema aguarda entre as verificações do diretório onde são gravados os arquivos de NF-e (TD_FIL.PATNFE).
  • delay_verifica_cancelamentos é o tempo (em milisegundos) que o sistema aguarda entre as verificações das notas canceladas no banco de dados.
  • delay_reprocessa_log é o tempo (em milisegundos) que o sistema aguarda para reprocessar um arquivo que foi processado com erros.
  • delay_apos_erro é o tempo (em milisegundos) que o sistema aguarda para continuar o processo após um erro tratado.
  • dir_log é o caminho onde o sistema gera o log relativo ao monitoramento de diretórios.
  • dir_arq é o caminho onde o sistema gera os arquivos de controle internos.
  • dir_properties é o caminho onde o sistema verifica um config.properties externo. Esse arquivo não precisa conter todas as configurações.
    Ele pode conter apenas a linha level_log=DEBUG para que facilmente o implantar possa verificar o que o sistema está processando.
    Para utilizar um properties externo é necessário reiniciar o serviço.
  • level_log indica o nível de criticidade para registro de mensagens no log.
    INFO mostra apenas mensagens informativas e erros.
    DEBUG mostra, além das mensagens do INFO, uma série de mensagens para que se possa avaliar melhor alguma situação de problema.
  • nfegx_servidor é o IP (ou nome da máquina) do Apache onde o TotallNfeGX está instalado.
  • nfegx_porta é a porta que está sendo utilizada pelo Apache.
  • nfegx_nome é o nome da pasta dentro de webapps onde está a aplicação (é case sensitive).
o diretório raíz de onde o processo é executado é a pasta TotallNfe\servico

Valores padrão

  • delay_verifica_retornos=300000
  • delay_verifica_cancelamentos=900000
  • delay_reprocessa_log=3600000
  • delay_apos_erro=60000
  • dir_log=../logs/
  • dir_arq=../arqs/
  • dir_properties=../
  • level_log=INFO
  • nfegx_servidor=localhost
  • nfegx_porta=8082
  • nfegx_nome=TotallNfeGX

Instalação

Verificar o artigo Instalação do Totall Nfe.

Log da Aplicação Servidora

Executar TOTALLNFE_HOME/GXServerConfig/config.bat.

O programa GeneXus Application Client Configuration será executado. Nele navegue pelas seguintes opções:

  • Guia Namespaces
    • Com default marcado aperte em Edit
      • Guia JDBC Log Configuration

Configure da seguinte forma

(X) Log JDBC Activity
( ) Enable buffering
Log Detail: High
(X) Use unique name
Log Level: Namespace
Path for log files: C:\TotallNfe\Logs
  • Aperte Ok
    • Ok
      • Save e Exit.

Este processo atualizará o arquivo client.cfg que está na mesma pasta.
Este arquivo deverá ser copiado para TOMCAT_HOME/webapps/TotallNfeGX/WEB-INF/classes/.

Fluxo de Arquivos Otimista

Emissão de Nota Fiscal

Após gravar a venda, o Checkout gera o arquivo NF.ERP e o Emite NF-e devolve o NF.aut.
Após confirmação no banco de dados o sistema busca as NF-e com as situações descritas abaixo (TT_VEN.FLGNFE) e muda de acordo com a situação que se encontra no Emite NF-e, consultado a tabela docNFes.

Código Descrição
0 Não enviada
2 Rejeitada
6 Cancelada
8 Erro de importação

Tabela 1. Situação das emissões antes do processamento.

NF-es nessa situação podem ser atualizadas para:

Código Descrição
1 Autorizada
2 Rejeitada
6 Denegada

Tabela 2. Situação das emissões após processamento.

Cancelamento de Nota Fiscal

O ATO COPETE ICMS 35/2010 formaliza que a partir de 01/01/2012 o emitente poderá
solicitar o cancelamento da NF-e, em prazo não superior a 24 horas, contado do
momento em que foi concedida a respectiva Autorização de Uso da NF-e, desde que não 
tenha ocorrido a circulação da mercadoria ou a prestação de serviço e observadas 
demais normas constantes do Ajuste SINIEF 07/2005, de 5 de outubro de 2005.
ATO COTEPE ICMS 35, DE 24 DE NOVEMBRO 2010 Publicado no DOU de 30.11.10
Ao logar no Totall Backoffice na tela "Problemas na Base de Dados" será apresentado o aviso
de cancelamento da NF-e.

No cancelamento da venda pelo Checkout/Backoffice o sistema gera o arquivo CANC.ERP e o Emite NF-e devolve o CANC.canc.
Após confirmação no banco de dados o sistema busca as NF-e com as situações descritas abaixo (TT_VEN.FLGNFE) e muda de acordo com a situação que se encontra no Emite NF-e, consultado a tabela docCancelamento.

Código Descrição
1 Autorizada

Tabela 3. Situação dos cancelamentos antes do processamento.

NF-es nessa situação podem ser atualizadas para:

Código Descrição
3 Cancelada

Tabela 4. Situação dos cancelamentos após processamento.

Inutilização de Nota Fiscal

No cancelamento da venda pelo Checkout/Backoffice, caso a NF-e não se encontre autorizada, o sistema gera o arquivo INUT.ERP e o Emite NF-e devolve o INUT.canc.
Após confirmação no banco de dados o sistema busca as NF-e com as situações descritas abaixo (TT_VEN.FLGNFE) e muda de acordo com a situação que se encontra no Emite NF-e, consultado a tabela docInutilizacao.

Código Descrição
0 Não enviada (Caso de erro de importação)
2 Rejeitada
6 Denegada

Tabela 5. Situação das inutilizações antes do processamento.

NF-es nessa situação podem ser atualizadas para:

Código Descrição
4 Inutilizada
Tabela 6. Situação das inutilizações após processamento.