Documentação de software

Esta funcionalidade foi implementada com o objetivo de trazer mais segurança para o contribuinte em relação aos registros transmitidos pelo equipamento SAT para a SEFAZ e os dados processados no sistema. Caso haja alguma discordância, o usuário poderá visualizar o problema e deve solicitar um atendimento ao suporte para que seja efetuada as devidas validações e correções.

Vale ressaltar que a consulta dos cupons enviados podem ser consultados via webservice com data máxima retroativa de 30 dias somente, conforme a documentação SGR-SAT Sistema de Gestão e Retaguarda do SAT-CF-e - Webservice para consulta de lotes enviados de CF-e-SAT Manual para o Contribuinte Versão 1.1 - 01/10/2015 - Página 3. Segue a imagem:

Para efetuar a consulta no site da SEFAZ via WebService é necessário uma chave de acesso, gerada no próprio website da SEFAZ, conforme documentação SGR-SAT Sistema de Gestão e Retaguarda do SAT-CF-e - Webservice para consulta de lotes enviados de CF-e-SAT Manual para o Contribuinte Versão 1.1 - 01/10/2015 - Página 10. Segue a imagem:

Esta chave deve ser adicionada na tela de configuração do EasyCash, conforme o caminho:

Na seguinte tela:

Após a configuração pode-se efetuar o acesso pelo menu conforme a imagem:

Ao clicar no menu, irá abrir uma nova tela, conforme abaixo:

Nesta tela, vale ressaltar as seguintes informações:

Nesta tela, deve-se selecionar o dia, em seguida selecionar o turno e clicar no botão Consultar. Após este procedimento é efetuada a verificação dos cupons comparando a chave dos mesmos que constam no banco de dados do sistema com os dados que constam no banco da SEFAZ. Neste caso, teremos:

No rodapé, é sempre mostrada a chave do CF-e que esteja selecionado, desde que a mesma exista, com o objetivo de facilitar a consulta no site do SGR-SAT.

No grid de divergências pode-se com o botão direito do mouse, tentar obter os dados do cupom diretamente do banco de dados utilizando a chave informada pela SEFAZ. Segue:

Na parte inferior, ao lado da chave, pode-se efetuar uma consulta da chave por dois métodos:

São eles:

1) Através do botão para efetuar consulta de dentro da interface:

2) Através do link que está na tela e utilizando a chave de acesso em destaque, teremos:

Embora exista a possibilidade de estar alterando na retaguarda as informações disponibilizadas abaixo, pede-se para que isto seja realizado somente em casos específicos, uma vez que os dados pré-configurados já atendem a todas as funcionalidades existentes no momento no EasyCash.

Mostra as alíquotas cadastradas para o SAT. Caso não haja nenhuma, pode-se carregar as mesmas da retaguarda adicionando-as para utilização no frente de caixa.

Mostra os comprovantes cadastrados para o SAT. Caso não haja nenhum, pode-se carregar as mesmas da retaguarda adicionando-os para utilização no frente de caixa.

Mostra as formas de pagamento PAI cadastradas para o SAT. Caso não haja nenhuma, pode-se carregar as mesmas da retaguarda adicionando-as para utilização no frente de caixa.

Mostra os relatórios gerenciais cadastrados para o SAT. Caso não haja nenhum, pode-se carregar as mesmas da retaguarda adicionando-os para utilização no frente de caixa.

O módulo SAT utiliza os seguintes valores como padrão, podendo apartir da retaguarda adicionar outras variações:

É uma função utilizada para preparar o SAT para uso e emissão de CF-e. Entre as informações a serem fornecidas, neste processo é enviado para o equipamento qual o tipo de ativação será efetuada pelo Contribuinte. Dentre os tipos de ativação estão:

Esta função efetua a associação entre o CNPJ do contribuinte com o CNPJ da Software House e o SAT. Para isto, é utilizado um código de vinculação assinado digitalmente pelo desenvolvedor do aplicativo comercial com sua chave ICP-BRASIL. Este código de vinculação é definido em Configurações → Equipamentos → SAT → Alterar → Gerar Assinatura.

Para o caso do cliente não estar utilizando o certificado fornecido pela própria SEFAZ gratuitamente para utilização com o SAT, pode-se utilizar esta opção para transmitir seu próprio certificado padrão ICP-BRASIL.

Permite o próprio cliente efetuar o bloqueio do equipamento junto a SEFAZ. Neste estado não é possível efetuar nenhum tipo de operação com o equipamento.

Permite o próprio cliente desbloquear o equipamento junto a SEFAZ.

Esta função permite troca do código de ativação pelo contribuinte a qualquer momento. Lembrando que este código é utilizado em todos os comandos para acessar o equipamento.

Através desta função poderá verificar se uma determinada sessão associada a um CF-e foi processada.

Permite que o sistema através do WebService de consulta pública da SEFAZ obtenha informações relativas a um determinado CF-e emitido. Para este procedimento é utilizado a chave do CF-e de 44 caracteres impresso acima do QR Code.

Esta função é utilizada para testes de comunicação entre o EayCash e o equipamento SAT.

Esta função é responsável por verificar a situação de funcionamento do Equipamento SAT e da impressora POS, retornando o máximo de informações disponível de ambos.

Esta mesma tela pode ser acessada na tela principal do EasyCash na barra de ferramentas, conforme a imagem abaixo:

Esta função permite que o EasyCash extraia as informações das operações do dia corrente armazenadas no SAT. As mesmas são exibidas na tela e também gravadas em arquivo para posterior análise. Esta função é importante, por exemplo, no rastreio de problemas ou até mesmo a validação se o SAT já recebeu o comando de atualização de certificado da SEFAZ.

Esta função consiste em um teste de comunicação completo entre o aplicativo comercial, o equipamento SAT e a SEFAZ. Neste caso específico, o CF-e gerado para teste não possui validade e não será contabilizado no financeiro do frente de caixa.

É possível através desta opção verificar qual a data e o horário da última comunicação entre a SEFAZ e o equipamento SAT.

Esta funcionalidade permite realizar teste de conexão com a Internet efetuando ping e telnet nos IPs configurados, podendo ainda adicionar uma URL diferente das já configuradas. Para teste de conexão com uma nova URL deve-se adicionar a URL que deseja testar, a porta e o protocolo e clicar no botão ‘Adicionar’. É possível selecionar em configurações o protocolo que deseja testar. Na parte inferior da tela existem dois botões ‘Executar’ para que seja executado o teste e ‘Fechar’ serve para sair da tela.

Esta funcionalidade pode ser acessada no menu SAT → Validação de XML. A mesma tem como objetivo validar o XML de venda e de cancelamentos que foram rejeitados, a fim de verificar se existe erro e qual é. A primeira aba refere-se às configurações, onde precisa ser informada a origem dos arquivos, versão do layout, tipo de validação e quantidade de registros.

• Origem dos Dados: Define se os dados a serem validados irão ser lidos da pasta de arquivos padrão do EasyCash ou se será lido do XML arquivado no banco de dados.
  
• Versão do Layout: A princípio não será necessário modificar esta configuração, pois ela é setada apartir do layout configurado no próprio SAT. Caso o usuário necessite validar um documento de layout antigo poderá efetuar a alteração.
  
• Tipo de Validação: Informa ao sistema se iremos validar um XML de CF-e de venda ou de cancelamento que foram rejeitados, uma vez que cada documento possui seu arquivo XSD correspondente.
  
• Quantidade de Registros: Define a quantidade máxima de registros que será mostrada na tela, tanto para o diretório de arquivos quanto para o banco de dados, uma vez que retornar todos os mesmos, deixaria o processo lento. O valor máximo é 200 e o mínimo 1.
  

Na parte superior, temos a pasta onde irá ser gravado um backup de cada arquivo gerado pela automação a ser enviado para o SAT. Com isso, podemos validar todos os XML gerados e não somente os aprovados pelo SAT. Observe que os nomes dos arquivos de XML de venda começam com AD e os de cancelamento com a sigla ADC. Caso o usuário queira visualizar o arquivo XML, basta clicar no ícone, conforme explicitado na imagem:

Para efetuar a validação, basta clicar no botão 'Executar' e para salvar em arquivo o resultado da validação basta clicar no botão 'Salvar'.

Caso o usuário selecione a opção de 'Banco de Dados' acessando a aba correspondente, o usuário poderá optar por utilizar pesquisa em ordem de importância do maior para o menor:

• Último registro no banco de dados
• Número de sessão
• Código de erro
• Data de início/Data de término

Para efetuar a validação basta clicar no botão ‘Executar’ e no ‘Salvar’ para que o arquivo gerado seja salvo.

A Leitura X é um relatório que pode ser emitido a qualquer momento do dia e quantas vezes forem necessárias. Contém informações resumidas da movimentação do dia tais como venda bruta, venda líquida, valor vendido por alíquota, contadores fiscais, vendas realizadas por forma de pagamento entre outras informações. Com o encerramento do dia as informações de movimentos no período posterior ao dia em questão são zeradas na Leitura X.

O encerramento do dia deve ser realizado após o término do expediente todo dia. No caso do SAT, se o encerramento já foi realizado, mas é necessário efetuar mais vendas, pode-se abrir o caixa novamente, entrando como um novo turno no mesmo dia.

O encerramento do dia contém informações sobre movimento do dia: Venda Bruta, Venda líquida, Cancelamentos, Descontos e Acréscimos além dos Pagamentos, Recebimentos, Sangria e Suprimento e os valores de cada alíquota.

Em Relatórios → SAT permite visualizar os arquivos XML referentes a venda e cancelamento, através de filtro de dia e hora.

Após inserir o ‘Tipo’ e também data e hora, ao clicar no botão Filtrar se não tiver nenhum XML correspondente ao filtro será exibida uma mensagem informando e caso haja o foco já irá automaticamente para a aba correspondente quando estiver no filtro de venda e cancelamento e quando filtro for dos rejeitados o foco irá para aba resultado. O relatório de CF-e de venda e cancelamento exibe um preview do XML na parte inferior, assim como mostra a imagem abaixo.

Já para o relatório de CF-e rejeitados, na aba ‘Resultado’ possui os botões Validar e Visualizar tanto no grid superior para CF-e de Venda que foram rejeitados e inferior CF-e de Cancelamento que foram rejeitados. Botão Validar irá abrir a janela de validação do XML. E o Botão Visualizar irá exibir o XML referente ao que está selecionado.

Pode ser acessado pelo menu:

Quando mando alterar exibe a janela abaixo para configurações. A mesma só poderá ser fechado depois de dar ‘Ok’ para salvar as alterações ou caso deseje sair sem fazer alterações clicar em ‘Cancelar’.

Vale ressaltar nesta tela duas configurações:

Em relação as funções dos botões temos:

• Atualizar Firmware: Esta funcionalidade está disponível para atualização do Software Básico do SAT, que DEVE ser realizada sob orientação da SEFAZ ou do Fabricante do Equipamento.
• Gerar Assinatura: Permite gerar o código de vinculação utilizado para associação entre o aplicativo comercial e o equipamento SAT. Utiliza o CNPJ do cliente, o CNPJ da Software House e um certificado válido para assinar digitalmente o mesmo.

A interligação entre o equipamento SAT e a rede do estabelecimento comercial, pode ser realizada através de cabo ou via wireless. Em configurações de rede do equipamento SAT basta selecionar qual das opções será utilizada.

• Interfaces suportadas: Ethernet e Wireless(Dependendo do equipamento SAT).
• Protocolos Suportados: DHCP, PPPoE ou IP Fixo.

Existe ainda a possibilidade de configurar o equipamento através de um proxy.

A impressão do CF-e segue as diretrizes descritas no manual de orientação da SEFAZ de São Paulo. Temos:

Cupom Fiscal Eletrônico:

Cancelamento do Cupom Fiscal Eletrônico:

Vale ressaltar que para o QR Code e o código de barras as instruções da SEFAZ são definidas da seguinte forma:

Para configurar a impressora e as informações do CF-e no sistema, teremos:

Lembrando que é imprescindível que a porta configurada no EasyCash deve ser exatamente a porta da impressora POS exibida no Gerenciador de Dispositivos do Windows e deve estar configurado no arquivo 'EasyCash1.ini'. Esta observação também é válida para o tópico do Fortes Report. Na imagem abaixo, como exemplo, temos a impressora na COM6. Segue:

Interfaces suportadas:

Pra explicitar o entendimento abaixo foi adicionado uma foto de cada caso.

Segue:

Mais informações podem ser encontradas neste link. Lembrando que esta forma de impressão faz utilização do spooler de impressão do sistema operacional Windows.

Como descrito acima, este processo faz utilização do serviço de spooler do Windows, demonstrado abaixo:

Logo, para poder utilizar o mesmo, a impressora deve estar devidamente instalada e setada como default no sistema operacional, conforme a imagem:

Durante o processo de impressão irá aparecer um ícone de impressora do lado do relógio e na tela demonstrada a seguir terá um registro indicando o que está sendo impresso:

Para setar a utilização desta interface, deve-se na tela de impressão selecionar Fortes Report e em seguida setar a impressora instalada no Windows conforme a imagem abaixo:

Os valores dos campos Largura, Topo, Fundo, Esquerda e Direita já vêm otimizado para a bobina de 80 mm. Caso seja necessário ajustar a impressão em algum caso específico, pode-se alterar estas opções. A opção Preview é para mostrar em tela o que será impresso antes de enviar para a impressora, podendo ser utilizada como apoio para o suporte.

Para este processo existem duas observações importantes:

• O sistema de relatório do Fortes só é utilizado na venda e no cancelamento da mesma. Nos outros relatórios é utilizado a interface ESC/POS pois os mesmos são personalizados e não possuem layout padrão definido.
• Por utilizar o spooler do Windows, pode ocorrer casos de travamento ou lentidão durante a impressão. Portanto, sempre recomendamos utilizar o ESC/POS em detrimento desta opção. Em caso de problemas constantes ou como uma opção em caso de algum suporte, mudamos para Fortes Report.

Uma pequena descrição pode ser encontrada neste link. No caso, das impressoras Bematech, a mesma implementa também um conjunto de instruções próprias baseadas no protocolo ESC/POS que pode ser verificado neste link. Este forma de impressão envia os comandos diretamente para a impressora POS.

Por enviar os dados diretamente para a impressora POS, esta opção é mais confiável e mais rápido para um ambiente de varejo.

Deve-se setar na configuração o modelo da impressora POS utilizada, a porta e a página de código utilizada(caso utilize alguma específica). Vale salientar que alguns POS utilizam protocolos de outros fabricantes, portanto, é sempre importante efetuar uma leitura do manual do equipamento. Segue:

Nesta tela temos ainda as seguintes opções adicionais:

• Colunas: Explicita a quantidade de colunas que o sistema utilizará para dividir o espaçamento na bobina de 80 mm.
• Espaço entre Linhas: Define o espaço que irá ser dado pela impressora entre uma linha e outra no CF-e.
• Linhas Pular: Define a quantidade de linhas que a impressora irá pular no final de cada impressão. Utilizado para corrigir o corte, no caso da impressora estar cortando o cupom na parte impressa.
• Imprimir Item em 1 linha: Força as informações do item a serem impressos em uma única linha. Importante tomar cuidado pois pode restringir a descrição do item.
• Corte Papel: Caso a impressora POS possua guilhotina, efetua o corte da impressão de modo automático.
• Controle Porta: Esta opção é utilizada para que o sistema a cada envio de comando para a impressora, abra a porta serial, envie o comando e em seguida feche a porta serial. Muito utilizado para caso o usuário utilize cabo/placa de conversão USB/Serial ou comece a apresentar muita instabilidade na utilização da impressora. Quando esta opção está habilitada, no log do POS pode-se obervar a descrição:

Devido ao fato de termos vários tipos de impressoras e pequenas variações de resposta entre cada impressora a um determinado evento, foi adicionado mais algumas configurações de controle, para facilitar a resolução de certas instabilidades. Segue a imagem:

Temos:

Os valores mostrados acima são os valores default do sistema e são otimizados para trabalhar com o máximo de impressoras. Estas configurações funcionam nos dois modos de impressão(Fortes e ESC/POS).

No retaguarda, pode-se acessar o menu:

Onde podemos configurar:

• Comprovantes Não-Fiscais
• Formas de Pagamento
• Relatório Gerencial

Segue:

Na coluna 'Sistema', temos:

• 1 - Registro padrão do sistema e não pode ser modificado
  
• 0 - Registro novo cadastrado pelo usuário

As alíquotas carregadas são as próprias alíquotas cadastradas no sistema de retaguarda, que podem ser validadas no caminho:

Segue:

No menu Utilitários → Relatório de Logs, existe a aba LOG DO SAT que possui quatro sub-abas que permitem visualizar e abrir os logs gerados nos processos que envolvem o SAT e também a impressora POS.

Antes de efetuar a liberação no frente de caixa, primeiramenta precisa-se cadastrar o equipamento SAT na retaguarda com o seu respectivo número de série, através do caminho:

Segue:

No frente de caixa, ao tentar efetuar a liberação o sistema irá procurar na retaguarda o respectivo número de série do equipamento para efetivar o processo. Caso não tenha sido cadastrado o SAT ainda na retaguarda ao tentar liberar no frente irá exibir uma mensagem informando que não encontrou o cadastro e irá questionar o operador se deseja cadastrar. O ideal é que faça primeiramente na retaguarda o cadastro e então no frente quando abrir a janela de liberação já irá identificar o cadastro e basta clicar em 'OK' para que a liberação automática junto ao sistema de licenças da IWS seja realizada. Caso não tenha conexão com internet a liberação automática não será realizada, necessitando da intervenção do suporte técnico.

Abaixo segue o diagrama simplificado que mostra como o sistema compõe o imposto no XML:

Para TRIBPISCOFINS:

O EasyCash já foi testado ou está sendo utilizado pelos clientes com os seguintes equipamentos:

Para informações mais detalhadas, existem alguns documentos que podem ser analisados para uma visão mais ampla de todo o conceito apresentado. São materiais que a própria SEFAZ de São Paulo disponibiliza. São eles:

Guia do Usuário - Da Aquisição do SAT à Vinculação do Aplicativo Comercial ao SAT

Manual de Orientação do SAT – versão 02.16.02 – 18 de maio de 2017

Guia de Uso do Aplicativo QRCode - Como usar o Aplicativo QRCode (Atualizado em 12/01/2015)

Especificação de Requisitos do SAT versão 02.23.01

Obrigatoriedade de Uso do SAT

Modelo - Pedido de Cessação de Uso de SAT

Além destas informações, vale ressaltar também que é sempre importante tirar dúvidas junto ao contador para esclarecer certos procedimentos e ficar sincronizado com as alterações mais recentes da legislação.

Este erro pode ocorrer por alguma oscilação de energia na porta USB, fazendo com que o equipamento não consiga transmitir ou receber as informações necessárias. Pode-se adotar as seguintes validações neste caso:

1 - Verificar se no computador em questão não temos vários equipamentos USB ligados, evitando uma sobrecarga no hub lógico do sistema operacional.

2 - É recomendável que o computador em questão esteja ligado a um estabilizador ou na medida do possível, até mesmo a um nobreak.

3 - Verificar se os dois cabos do SAT, em forma de Y, estejam devidamente conectados ao computador em questão.

4 - Retirar o SAT completamente da energia (todos os conectados na USB). Aguardar até que todos os LEDs indicativos estejam apagados e em seguida religar o equipamento.

5 - Se houver outras portas USB disponíveis trocar para outra porta o SAT.

6 - Verificar se o driver de comunicação, firmware e DLL do SAT estão atualizados na última versão.

7 - Verificar se o cabo USB não apresenta nenhum tipo de corte, desgaste, problema no encaixe ou fissura que atrapalhe o seu funcionamento normal.

8 - Desabilitar no sistema operacional a seguinte configuração no painel de controle de energia:

Neste caso, é importante validar se o fuso horário no painel de controle encontra-se devidamente setado para Brasília, conforme listado neste link da Bematech.

Vale ressaltar que se caso o SAT ficar sem conexão de rede por muito tempo, a sincronização do relógio interno não irá ocorrer, sendo que seria interessante validar este requisito extraindo um log do equipamento.

Caso o computador ainda apresente problemas de data/hora, ou seja, modificando a mesma a todo momento deve-se validar a tensão na bateria interna da placa-mãe, sendo altamente recomendado uma consulta a um suporte técnico de hardware. Uma melhor explicação do problema pode ser encontrada neste link.