Tabela de conteúdos
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. | ||||||||||||||
|
|
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:
|
||||||||||||||
|
|
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:
|
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]
| Usuário do Firebird para acesso ao banco de dados. | |
| Senha do Firebird criptografada | |
| 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. | |
| Configuração do Firebird para que seja utilizado caracteres de acentuação. | |
| 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 do host da retaguarda | |
| 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. | |
| Usuário do Firebird para acesso ao banco de dados da retaguarda. | |
| Senha do Firebird da retaguarda criptografada | |
| Configuração do Firebird da retaguarda para que seja utilizado caracteres de acentuação. |
[CFe]
| 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]
| Porta em que o servidor do EasyCash está em modo LISTENING. A porta padrão é 5060. | |
| 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. | |
| 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:
- 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:
Configurações
Geral
Nesta aba temos as seguintes opções com suas finalidades descritas abaixo:
| 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. | |
| 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
| 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. | |
| Seta o valor do timer que irá neste intervalo de tempo atualizar as informações do banco de dados na tela principal. | |
| Seta o valor de timeout do comando ping utilizado pelo servidor para validar o acesso a internet. | |
| URL de um link externo que o servidor irá executar o ping para validar o acesso a internet. | |
|
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. |
|
| 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
|
|
|
| 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. |
|
|
|
| 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(*) | |
| A partir deste valor, será obrigatória a indentificação do consumidor(*) | |
O valor de R$200.000,00 também foi baseado no mesmo documento conforme demonstrado na imagem abaixo:
|
|
| 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. |
|
|
|
| Versão corrente do modelo aceito pela SEFAZ. Atualmente, a versão corrente em todo território nacional é a 4.0. | |
| 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. | 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
| Seta o tipo de ambiente que será utilizado, automaticamente trocando os endereços dos webservices para cada situação. | |
| Sigla da UF da SEFAZ autorizadora. | |
| Seta qual algoritmo será utilizado para comunicação com o webservice via protocolo SSL. |
|
|
|
| É 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). | |
| É 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). | |
|
|
|
| Quando setada esta configuração ajusta o tempo de espera baseado no tempo de retorno do número do recibo após o envio. | |
| Tempo em milissegundos de espera antes de realizar a primeira consulta após o envio da NFC-e para a SEFAZ. | |
| Número máximo de tentativas de consultas a serem realizadas após o envio da NFC-e para a SEFAZ. | |
| 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. |
| Quando setada, na emissão em contingência imprime a via do consumidor, conforme especificação técnica. | |
| 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. | |
| Mostra um preview da impressão antes de definitivamente enviar os dados para a impressora. | |
| Instrui para que o sistema acione a guilhotina(se disponível) da impressora no final de cada impressão. | |
| Formata as informações do item, como código, quantidade, unidade, descrição entre outros para ser impresso em uma única linha. | |
| 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. | |
| Quando esta propriedade é setada, não é impresso os itens no DANFE que será entregue para o cliente. | |
| 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. | |
| 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. | |
| Quando setada esta configuração o sistema não irá processar as tags de formatação presentes no layout do DANFE. |
Impressora
| 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. | |
| 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.
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)
Menu de Apoio(2)
Alterar
Cancelar
Inutilizar
Transmitir
Imprimir
Gerar PDF Completo
Gerar PDF Resumido
Gerar TXT
Imprimir Completo
Imprimir Resumido
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:
