Ferramentas do usuário

Ferramentas do site


easycash:manual_de_instrucao_servidor_nfce

Servidor NFC-e

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:

BD 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:

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 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 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

Segue a descrição dos itens:

  1. Mostra o IP da máquina cliente que está acessando o servidor.
  2. Mostra a sessão associada a cada conexão que está processando no servidor.
  3. 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.
  4. 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.
  5. Mostra a porta em que o servidor de aplicativo está em modo LISTENING e também a quantidade de conexões ativas no momento.
  6. 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.
  7. Mostra a quantidade de notas confirmadas, em contingência, canceladas e rejeitadas no dia corrente.
  8. 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.
  9. 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.
  10. Sinaliza se o servidor está utilizando algum algoritmo de criptografia e compressão nas conexões com os clientes.
  11. 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:

Configurações

Geral

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

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

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:

O valor de R$200.000,00 também foi baseado no mesmo documento conforme demonstrado na imagem abaixo:

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

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

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



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

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

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

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:

Será aberta a seguinte tela:

Teremos nesta tela, conforme enumerado as seguintes situações:

Filtros(1)

Alterar

Tela 1 - Identificação da NFC-e

Tela 2 - Emitente da NFC-e

Tela 3 - Detalhamento dos itens da NFC-e

Tela 4 - Imposto ICMS da NFC-e

Tela 5 - Imposto PIS da NFC-e

Tela 6 - Imposto COFINS da NFC-e

Tela 7 - Total da NFC-e

Tela 8 - Transporte da NFC-e

Tela 9 - Pagamentos da NFC-e

Tela 10 - Informação Adicional da NFC-e

Cancelar

Inutilizar

Transmitir

Imprimir

Gerar PDF Completo

Gerar PDF Resumido

Gerar TXT

Imprimir Completo
Imprimir Resumido

E-Mail

XML

Visualizar

Consultar

Situação do Cadastro do CNPJ

Status da NFC-e

Status

Status WS(WebService)

Abas de Conteúdo(3)

Vendas

Contingência

Rejeições

Detalhes

Descrição

Exceções

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/manual_de_instrucao_servidor_nfce.txt · Última modificação: 2019/07/17 15:00 por amonteiro