====== Servidor NFC-e ====== {{ :easycash:nfce.png?600 |}} A liberação do servidor de NFC-e ocorreu na versão 1.4.006.000. ===== Estrutura de Pastas ===== O diretório padrão de instalação do servidor é o:

C:\IWS\EC\Server

Dentro deste diretório vale ressaltar a importância de alguns diretórios:

Pasta onde fica o arquivo FDB que é o banco de dados do servidor.

Schemas

Guarda os esquemas que serão utilizados pelo servidor para validar os XML que o mesmo efetuar algum tipo de processamento. Deve-se atentar para sempre ter os esquemas da versão 4.0 atualizados.

Embedded

Para o caso de utilizar o Firebird Embarcado, nesta pasta encontra-se os arquivos principais utilizado por este tipo de solução.

NFCe

Diretório principal da NFC que mantêm todos os arquivos relativos a transmissão ou tentativas de transmissão para a SEFAZ. Podemos destacar os seguintes subdiretórios:

*Evento*	Diretório padrão que guarda todos os arquivos gerados pela transmissão para a SEFAZ referente ao cancelamento de NFC-e.
*Inu*	Diretório padrão que guarda todos os arquivos gerados pela transmissão para a SEFAZ referente a inutilização de um número referente a NFC-e.
*NFe*	Diretório padrão que guarda o XML de todos as NFC-e processadas com sucesso.
*PDF*	Diretório padrão que guarda todos os PDF que o servidor gerar referente a NFC-e. Utilizada pela opção de impressão em PDF na tela de gerenciamento.
*TMP*	Diretório padrão que guarda todos os arquivos temporários gerados pelo sistema pelos mais diversos motivos. Exemplo: Geração de um arquivo temporário para poder exibir corretamente uma página web na opção de gerenciamento.

LOG

Todos os processos que o sistema executa possui um arquivo de log que armazena possíveis problemas, cuja finalidade é auditoria ou suporte. Para o servidor, podemos citar os seguintes arquivos:

*EasyCashSRV_IE_YYYYMMDD.log*	Arquivo que guarda as exceções lançadas no momento em que o servidor tentar enviar para a retaguarda os dados das NFC-e processadas, dados das contingências, erros gerais que ocorreram no processo, inutilizações e cancelamentos.
*EasyCashSRV_GERAL_YYYYMMDD.log*	Arquivo que guarda informações gerais referentes ao sistema, seja para sinalizar que um processo foi executado ou para indicar algum erro ainda não categorizado.
*EasyCashSRV_DS_YYYYMMDD.log*	Arquivo que guarda informações gerais referentes ao tipo de comunicação utilizada entre o servidor e os clientes(EasyCash).
*EasyCashSRV_DS_TO_YYYYMMDD.log*	Arquivo que guarda informações gerais referentes as conexões provenientes dos clientes que foram abortadas no servidor devido ao tempo de espera exceder o limite especificado pelo sistema internamente.
*EasyCashSRV_DS_TRACE_YYYYMMDD.log*	Arquivo que guarda todas as informações que transitam entre o cliente e o servidor. Só é utilizado em casos extremos onde é necessário detectar algum erro na transmissão entre cliente-servidor.
*EasyCashSRV_BD_YYYYMMDD.log*	Arquivo que guarda as informações relativas a execução das procedures no banco de dados, a recuperação de dados do banco de dados entre outros processos referentes ao banco de dados do servidor.
*EasyCashSRV_WS_YYYYMMDD.log*	Arquivo que guarda as informações relativas a transmissão de dados para o webservice da SEFAZ.

===== Significado da composição dos nomes dos Arquivos ===== Nos diretórios citados anteriormente, pode-se encontrar algumas outras extensões cujo significado está descrito na tabela a seguir. Segue: {{ :easycash:formacaonomearquivosnfe.png?650 |}} ===== Parâmetros do Arquivo EasyCashSRV.ini ===== Na pasta do servidor, no arquivo de configuração do servidor chamado **EasyCashSRV.ini**, deve ser realizado corretamente as seguintes configurações: [BDServer]

UserName=SYSDBA	*Usuário do Firebird para acesso ao banco de dados.*
Pwd=XXXXXXXXXXXXXXXXXXXX	*Senha do Firebird criptografada*
Path=C:\IWS\EC\BD\SERVER_NFCE.fdb	*Caminho do banco de dados do frente de caixa. Pode ser informado um caminho físico até o arquivo FDB, um caminho de rede ou até mesmo um alias devidamente configurado no Firebird.*
Charset=WIN1252	*Configuração do Firebird para que seja utilizado caracteres de acentuação.*
Embedded=0	*Descrição a seguir.*

Segue as configurações padrões de acesso ao banco de dados que é realizada no EasyCash. Um detalhe a chamar a atenção é a tag **Embedded**, que pode ser: * 0 (Zero) → Quando setado para este valor significa que o banco de dados a ser utilizado pelo servidor será o [[https://www.firebirdsql.org/en/firebird-2-5/|Firebird padrão]] devidamente instalado na máquina. É a opção de instalação padrão. * 1 (Um) → Quando setado para este valor significa que o banco de dados a ser utilizado pelo servidor será o [[https://www.firebirdsql.org/pdfmanual/html/fbmetasecur-embedded.html|Firebird Embedded(Embarcado)]] que não necessita de instalação na máquina do cliente, rodando direto de uma DLL. [IntellicashServer]

IP=192.168.0.10	*IP do host da retaguarda*
PathRetag=192.168.0.10/3050:C:\IWS\EC\BD\INTELLICASH.fdb	*Caminho do banco de dados da retaguarda. Pode ser informado um caminho físico até o arquivo FDB, um caminho de rede ou até mesmo um alias devidamente configurado no Firebird.*
UserName=SYSDBA	*Usuário do Firebird para acesso ao banco de dados da retaguarda.*
Pwd=F92C	*Senha do Firebird da retaguarda criptografada*
Charset=WIN1252	*Configuração do Firebird da retaguarda para que seja utilizado caracteres de acentuação.*

[CFe]

Identacao=3

Utilizado na geração do XML do CF-e para formatar a disposição das tags, facilitando assim a leitura. O valor padrão é 3.

[NFCe]

ServerPorta=5060	*Porta em que o servidor do EasyCash está em modo LISTENING. A porta padrão é 5060.*
Trace=0	Quando setado para 1, gera na pasta 'LOG' um arquivo chamado 'EasyCashSRV_DS_TRACE_AAAAMMDD.log' com todos os dados trafegados pelo servidor. Só deve ser utilizado em caso de suporte, pois este tipo de registro pode causar lentidão no servidor.
TentativasErroHTTP=2	Seta a quantidade de tentativas de reconexão para o caso do servidor receber um erro de transmissão HTTP. Em alguns clientes ocorria falha na transmissão mas ao retentar o envio era realizado normalmente. É indicado valor igual ou maior que dois.

===== Interface Principal ===== ==== Aba Status Geral ==== {{ :easycash:servidor_nfce.png?750 |}} Segue a descrição dos itens: - Mostra o IP da máquina cliente que está acessando o servidor. - Mostra a sessão associada a cada conexão que está processando no servidor. - Lista as requisições que estão ATIVO ou IDLE no banco de dados. No caso de utilizar o Firebird Embedded algumas informações deste grid são suprimidas. - Instruções que estão sendo processadas em tempo real no servidor. A cada refresh é mostrado no grid a data/hora, número do PDV, instrução processada, IP e porta de origem do cliente. - Mostra a porta em que o servidor de aplicativo está em modo LISTENING e também a quantidade de conexões ativas no momento. - Mostra a porta do servidor do banco de dados em que o mesmo está em modo LISTENING e a quantidade de conexões ativas no momento. - Mostra a quantidade de notas confirmadas, em contingência, canceladas e rejeitadas no dia corrente. - Mostra a quantidade de memória física disponível da máquina em relação a quantidade de memória total sendo utilizada da máquina. Na segunda barra de progresso mostra a quantidade de memória utilizada pelo aplicativo do servidor em relação a quantidade de memória física total disponível. Lembrando que como trata-se de um servidor, a segunda barra de progresso deve ter ao longo do tempo uma variação mínima, alocando e desalocando(variando) de acordo com a necessidade. - Os três painéis mostra o status do servidor(servidor datasnap), o segundo painel sempre constará //Processo OUT//(não existe fila de espera) e a situação do acesso a internet(Recurso). Caso esteja verde significa que estão iniciados corretamente. Se apresentar a cor vermelha, significa que foi parado através do menu ou que no momento de iniciar automaticamente ocorreu algum erro. - Sinaliza se o servidor está utilizando algum algoritmo de criptografia e compressão nas conexões com os clientes. - O primeiro ícone será mostrado caso esteja utilizando o servidor em modo de homologação. O segundo ícone é um ícone de status da internet e o terceiro ícone sinaliza qual módulo do servidor está sendo utilizado. ==== Aba Recurso - NFC-e ==== Nesta aba, é mostrado os dados do webservice que está sendo utilizado pelo servidor, sendo na parte superior os dados devidamente processados e na parte inferior o XML da resposta do webservice, conforme a imagem a seguir: {{ :easycash:servidor_nfce_aba_recurso.png?750 |}} ===== Configurações ===== ==== Geral ==== {{ :easycash:nfce_configuracao_geral.png?550 |}} Nesta aba temos as seguintes opções com suas finalidades descritas abaixo:

Consulta Status WebServices(URL)	Permite digitar a URL que será utilizada para consultar o status dos webservices na tela de gerenciamento. Por padrão já vêm setada uma URL que informa o status de todos os webservices do Brasil.
Intervalo de Transmissão à SEFAZ(Minutos)	*Permite configurar o intervalo de tempo em minutos que o servidor irá tentar enviar para a SEFAZ os cupons que entraram em contingência.*

==== Servidor ==== {{ :easycash:nfce_configuracao_servidor.png?550 |}}

Porta(Listening)	*Seta o valor da porta em que o servidor irá ficar em modo LISTENING. Também pode ser setado diretamente no arquivo de configuração.*
Monitor Banco de Dados(TimeOut Geral)	*Seta o valor do timer que irá neste intervalo de tempo atualizar as informações do banco de dados na tela principal.*
TimeOut do Ping(Outros)	*Seta o valor de timeout do comando ping utilizado pelo servidor para validar o acesso a internet.*
URL de Teste	*URL de um link externo que o servidor irá executar o ping para validar o acesso a internet.*
Validação de DATA/HORA	Permite setar o tipo de controle que o servidor irá utilizar para controlar a data/hora utilizada por ele. Por padrão vêm setado para utilizar o temporizador interno que faz uso de funções de contadores de alta performance do sistema. Existem ainda para este caso mais algumas opções: + Servidor NTP(Pool) - Utiliza o site 'pool.ntp.org' para obter a data e hora. + Servidor NTP(Lista) - Utiliza uma listagem interna de servidores que fornecem o serviço NTP no Brasil para obter a data e hora. + Servidor IntelliCash - Ainda não implementado.
Filtros da Comunicação entre Cliente e Servidor	Permite definir se o servidor irá utilizar algoritmo de criptografia e compressão nas conexões efetuadas pelos clientes. Estas configurações devem ser obrigatoriamente as mesmas dos clientes. Ainda é possível definir quais algoritmos utilizar e efetuar ajustes em alguns parâmetros definidos no campo 'Propriedade'.

==== NFC-e ==== === Geral === {{ :easycash:nfce_configuracao_nfce_geral.png?550 |}}

Forma de Emissão
Normal	*Emissão normal da NFC-e, entrando em contingencia automaticamente, quando necessário.*
OffLine	*Todas emissões serão offline, no entanto, o servidor irá transmitir assim que possível, se ele também não estiver nesta configuração.*

Limites Máximos
Valor da operação	**Valor máximo de alguma operação permitida pela NFC-e, publicado nas especificações de requisitos. Atualmente, este valor é de R$ 200.000,00()***
Identificação não obrigatória	**A partir deste valor, será obrigatória a indentificação do consumidor()***

(*)Estes dois valores podem variar, de acordo com as especificações da SEFAZ de cada unidade federativa. O valor de R$10.000 que o sistema apresenta foi baseada nas instruções da NFC-e do Estado do Rio de Janeiro no documento **Preenchimento da NFC-e - Orientações para o contribuinte do Estado do Rio de Janeiro - Atualizado em 25 de maio de 2016**, conforme a imagem abaixo: {{ :easycash:nfce_identificacao_destinatario.png?650 |}} O valor de R$200.000,00 também foi baseado no mesmo documento conforme demonstrado na imagem abaixo: {{ :easycash:nfce_valor_total.png?650 |}}

Código de Segurança do Contribuinte

O CSC e o IDCSC são utilizados para gerar o QRCode e são fornecidos pela SEFAZ exclusivamente ao contribuinte, ao efetuar o seu credenciamento.

Configuração do XML
Versão do documento fiscal	*Versão corrente do modelo aceito pela SEFAZ. Atualmente, a versão corrente em todo território nacional é a 4.0.*
Diretório com os arquivos XSD (Schema)	O arquivo XML de cada nota emitida é criada e validade a partir de um ou mais modelos. São os chamados Schemas. Estes Schemas são disponibilizados geralmente no próprio portal da NF-e e devem estar obrigatoriamente atualizados no diretório registrado nesta configuração. Sem estes arquivos, é impossível emitir uma nota.
Retirar acentos dos XMLs enviados	*Em alguns casos, o servidor da SEFAZ pode não reconhecer caracteres especiais. Com esta configuração marcada, os acentos serão removidos do XML antes do envio.*

=== Certificado === {{ :easycash:nfce_configuracao_nfce_certificado.png?550 |}} Os campos **SSLLib**, **CryptLib**, **HttpLib** e **XMLSignLib** são pertinentes ao tipo de codifição encriptação utilizado pelo certificado instalado e da forma que será transmitido/recebido nos servidores da SEFAZ. Estas combinações podem alterar, de acordo com a tecnologia utilizada pelos web services disponibilizados.\\ O **Caminho** deve apontar para o local onde se encontra o certificado, lenbrando que, em casos em que o obrigue que o certificado esteja instalado na máquina (libCapicom, por exemplo), este campo não estará disponível, sendo necessário informar o **Número de Série** e **Senha**.\\ O campo **Informações** é apenas para conferência das informações, tais como CNPJ, validade ou número de série que constam certificado instalado na máquina. Caso o certificado não esteja instalado, não irá apresentar estas informações. === WebService === {{ :easycash:nfce_configuracao_timeout_webservice.png?550 |}}

Ambiente de Homologação	*Seta o tipo de ambiente que será utilizado, automaticamente trocando os endereços dos webservices para cada situação.*
UF de Destino	*Sigla da UF da SEFAZ autorizadora.*
SSL Type	*Seta qual algoritmo será utilizado para comunicação com o webservice via protocolo SSL.*

Timeout
Envio de Venda e Evento	É o tempo máximo de espera de resposta da SEFAZ para a requisição de enviar venda e evento no momento da venda. Este valor já é otimizado para os processos internos do servidor, portanto, deve-se manter o mesmo com valor igual ou menor a 10000 ms (10 s).
Processamento de Contingência	É o tempo máximo de espera de resposta da SEFAZ para a execução do processo de envio automático do servidor para as contingências. Este valor já é otimizado para os processos internos do servidor, portanto, deve-se manter o mesmo com valor maior ou igual a 30000 ms (30 s).

Retorno de Envio da NFC-e
Ajustar automaticamente propriedade "Aguardar"	*Quando setada esta configuração ajusta o tempo de espera baseado no tempo de retorno do número do recibo após o envio.*
Aguardar	*Tempo em milissegundos de espera antes de realizar a primeira consulta após o envio da NFC-e para a SEFAZ.*
Tentativas	*Número máximo de tentativas de consultas a serem realizadas após o envio da NFC-e para a SEFAZ.*
Intervalo	*Tempo em milissegundos de espera entre uma consulta e outra após o envio da NFC-e para a SEFAZ.*

=== Impressão === == Geral == {{ :easycash:nfce_configuracao_nfce_impressao_geral.png?550 |}}

Tipo DANFE	Configura como deve ser impresso o DANFE da NFC-e, conforme descrito abaixo: + Padrão: Impressão com todas as informações da NFC-e conforme especificação técnica. + Simplificado: Impressão com apenas algumas informações da NFC-e conforme especificação técnica. + Sem Geração: Não gera nenhum tipo de impressão. O cliente não irá receber um comprovante. + Mensagem Eletrônica: Sinaliza que o DANFE será enviado por e-mail. Ainda não implementado.
Via consumidor	*Quando setada, na emissão em contingência imprime a via do consumidor, conforme especificação técnica.*
Controle Porta	*Quando setada, o sistema irá abrir e fechar a porta da impressora para cada comando a ser enviado, ao contrário da outra opção que abre a porta uma única vez, envia todos os comandos e fecha.*
Mostrar Preview	*Mostra um preview da impressão antes de definitivamente enviar os dados para a impressora.*
Corte Papel	*Instrui para que o sistema acione a guilhotina(se disponível) da impressora no final de cada impressão.*
Imprimir item em 1 Linha	*Formata as informações do item, como código, quantidade, unidade, descrição entre outros para ser impresso em uma única linha.*
Imprimir desconto/acréscimo por item	Quando esta informação é setada, o rateio do desconto ou o acréscimo que é dado no final do cupom é impresso para cada item. Quando desmarcada, somente é impresso o desconto/acréscimo no final do CF-e na área de subtotalização.
Imprimir itens(DANFC-e resumido)	*Quando esta propriedade é setada, não é impresso os itens no DANFE que será entregue para o cliente.*
Imprimir logo na lateral	*Quando setada esta configuração, permite que o logo da empresa seja impresso ao lado das informações da empresa e não uma embaixo da outra.*
Imprimir QRCode na lateral	*Quando setada esta configuração, o sistema irá imprimir o QRCode deslocado para o lado esquerdo do cupom e informações como Consumidor, Número, Série, Data/Hora de emissão do lado direito.*
Ignorar tags de formatação	*Quando setada esta configuração o sistema não irá processar as tags de formatação presentes no layout do DANFE.*

== Impressora == {{ :easycash:nfce_configuracao_nfce_impressao_impressora.png?550 |}}

Fortes Report(Spooler Windows)	Quando setada esta configuração o sistema irá utilizar para a impressão uma impressora devidamente instalada no Windows, ou seja, deve estar presente no setor de impressoras no Painel de Controle. Para este tipo de impressão é utilizado o spooler do Windows, sendo que o sistema operacional que irá efetuar o gerenciamento da impressão.
ESCPOS	Quando setada esta configuração, deve-se ter o dispositivo apenas presente em uma COM no Gerenciador de Dispositivos. Deve-se também indicar o fabricante do equipamento, para que possa ser utilizado o conjunto de instruções correspondente. Neste caso, a comunicação é direta com o equipamento.

==== Empresa ==== {{ :easycash:nfce_configuracao_empresa.png?550 |}} Nesta tela, deve ser fornecida todas as informações da empresa que irá emitir as NFC-e, do mesmo modo em que as mesmas foram cadastradas na SEFAZ. Estes dados serão utilizados para a constituição da NFC-e e para o envio da mesma para a SEFAZ. ==== E-Mail ==== {{ :easycash:nfce_configuracao_email.png?550 |}} Nesta opção pode-se setar o endereço de e-mail que será utilizado posteriormente para envio do DANFE para o e-mail do consumidor final. ===== Gerenciamento ===== Acessível pelo menu principal da tela do servidor, conforme a imagem abaixo: {{ :easycash:menu_nfce.png?400 |}} Será aberta a seguinte tela: {{ :easycash:tela_principal_gerenciamento.png?850 |}} Teremos nesta tela, conforme enumerado as seguintes situações: ==== Filtros(1) ==== ==== Menu de Apoio(2) ==== === Alterar === {{ :easycash:gerenciamento_alterar_identificação.png?850 |}} Tela 1 - Identificação da NFC-e {{ :easycash:gerenciamento_alterar_emitente.png?850 |}} Tela 2 - Emitente da NFC-e {{ :easycash:gerenciamento_alterar_detalhamento_produto.png?850 |}} Tela 3 - Detalhamento dos itens da NFC-e {{ :easycash:gerenciamento_alterar_detalhamento_imposto_icms.png?850 |}} Tela 4 - Imposto ICMS da NFC-e {{ :easycash:gerenciamento_alterar_detalhamento_imposto_pis.png?850 |}} Tela 5 - Imposto PIS da NFC-e {{ :easycash:gerenciamento_alterar_detalhamento_imposto_cofins.png?850 |}} Tela 6 - Imposto COFINS da NFC-e {{ :easycash:gerenciamento_alterar_total.png?850 |}} Tela 7 - Total da NFC-e {{ :easycash:gerenciamento_alterar_transporte.png?850 |}} Tela 8 - Transporte da NFC-e {{ :easycash:gerenciamento_alterar_pagamento.png?850 |}} Tela 9 - Pagamentos da NFC-e {{ :easycash:gerenciamento_alterar_informacao_adicional.png?850 |}} Tela 10 - Informação Adicional da NFC-e === Cancelar === === Inutilizar === === Transmitir === === Imprimir === == Gerar PDF Completo == {{ :easycash:gerenciamento_imprimir_pdfcompleto.png?350 |}} == Gerar PDF Resumido == {{ :easycash:gerenciamento_imprimir_pdfresumido.png?350 |}} == Gerar TXT == {{ :easycash:gerenciamento_imprimir_txt.png?950 |}} == Imprimir Completo == == Imprimir Resumido == === E-Mail === === XML === == Visualizar == {{ :easycash:gerenciamento_xml_visualizar.png?500 |}} === Consultar === == Situação do Cadastro do CNPJ == {{ :easycash:gerenciamento_consultar_cadastroCNPJ.png?500 |}} == Status da NFC-e == {{ :easycash:gerenciamento_consultar_statusnfce.png?500 |}} === Status === {{ :easycash:gerenciamento_status.png?500 |}} === Status WS(WebService) === {{ :easycash:gerenciamento_statusws.png?650 |}} ==== Abas de Conteúdo(3) ==== === Vendas === {{ :easycash:gerenciamento_vendas.png?850 |}} === Contingência === {{ :easycash:gerenciamento_contingencia.png?800 |}} === Rejeições === == Detalhes == {{ :easycash:gerenciamento_rejeicoes.png?800 |}} == Descrição == {{ :easycash:gerenciamento_rejeicoes_descricao.png?800 |}} === Exceções === {{ :easycash:gerenciamento_excecoes.png?800 |}} ====== Contingência ====== ===== Offline ===== O servidor do EasyCash segue o procedimento padrão de contingência conforme descrito no documento **Manual de Padrões - Padrões Técnicos Contingência Offline - Versão 2.0 de 16 de dezembro de 2016**. Este processo pode ser descrito em 3 etapas como demonstradas nas imagens abaixo: {{ :easycash:contingencia_imagem01.png?800 |}} {{ :easycash:contingencia_imagem02.png?800 |}} {{ :easycash:contingencia_imagem03.png?800 |}}