Documentação de software

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
{{ :easycash:logo_sat.png |}}

A liberação do S@T ocorreu na versão **1.2.002.000** (23/02/2016). 

<note important>Para a utilização deste módulo é muito importante efetuar na retaguarda, no fechamento do dia, a [[http://wiki.intelliware.com.br/doku.php?id=manuais:intellicash:estoque:vendas:conferir_vendas_ecf|Conferência das Vendas]] e o 
[[http://wiki.intelliware.com.br/doku.php?id=manuais:intellicash:financeiro:tesouraria:fechamento_caixa|Fechamento de Caixa]], com a finalidade de evitar divergências entre a SEFAZ e o sistema.</note>

Conforme descrito no site da [[https://portal.fazenda.sp.gov.br/servicos/sat/Paginas/Sobre.aspx|SEFAZ de São Paulo]], temos:

//"O equipamento SAT (Sistema Autenticador e Transmissor de Cupons Fiscais Eletrônicos) documenta, de forma eletrônica, as operações comerciais dos contribuintes varejistas do Estado de São Paulo, substituindo os equipamentos ECF (Emissor de Cupom Fiscal). O SAT gera e autentica os CF-e-SAT (Cupons Fiscais Eletrônicos) e os transmite automatica e periodicamente, via internet, à Secretaria da Fazenda.//\\

//O projeto possibilita aos consumidores localizarem mais rapidamente o documento fiscal no programa Nota Fiscal Paulista, e simplifica as obrigações tributárias acessórias dos estabelecimentos varejistas, por exemplo, eliminando a obrigação de envio do REDF."//

===== Menu SAT =====

==== Conferência dos CF-e na SEFAZ ====
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:

{{ :easycash:sat_manual_contribuinte_conferencia.png |}}

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:

{{ :easycash:sefaz_geracao_chaveseguranca.png |}}

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

||Configuração → PDV → Equipamentos → SAT → Dados Gerais → Alterar||

Na seguinte tela:

{{ :easycash:sat_configuracoesgerais_chavesegurancacontribuinte.png |}}

<note important>Lembrando que embora o EasyCash forneça a opção de inserir a configuração no frente de caixa, deve-se efetuar esta configuração pela retaguarda e exportar a configuração, conforme o manual da retaguarda [[manuais:intellicash:estoque:vendas:conferir_vendas_ecf#conferir_vendas_com_a_sefaz_sat|Conferir Vendas com a SEFAZ - SAT]].</note>

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

{{ :easycash:sat_menu_conferenciacfenasefaz.png |}}

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

{{ :easycash:sat_conferencia_cupomsefaz.png |}}

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

<html>
<table>
<tr>
<td width="30%">
<center><b>Versão do Layout</b></center>
</td>
<td>
É a versão do layout utilizado para transmitir os CF-e. Atualmente na versão 0.07.
</td>
</tr>
<tr>
<td>
<br><br><br><br>
<center><b>Intervalo Extra(Minutos)</b></center>
</td>
<td>
Para calcular o intervalo de tempo que o sistema irá consultar no webservice da SEFAZ, é realizado o seguinte cálculo:
<br><br>
<table>
<tr>
<td>
<center><i><b>DATAHORA_INICIAL</b></i></center>
</td>
<td>
<i>DATA_E_HORA_PRIMEIRO_CUPOM_DO_DIA - [Intervalo Extra]</i>
</td>
</tr>
<tr>
<td>
<center><i><b>DATAHORA_FINAL</b></i></center>
</td>
<td>
<i>DATA_E_HORA_ULTIMO_CUPOM_DO_DIA + [Intervalo Extra]</i>
</td>
</tr>
</table>
Esta opção foi adicionada pois a consulta no webservice é feita por data e hora, o que faz com que, caso um determinado CF-e seja processado fora do intervalo especificado, o mesmo não irá aparecer na listagem. Neste caso, pode-se então ajustar o intervalo conforme a situação.
</td>
</tr>
<tr>
<td>
<center><b>Chave de Segurança</b></center>
</td>
<td>
É a mesma chave que foi configurada na empresa em questão, na seção de configurações do EasyCash.
</td>
</tr>
<tr>
<td>
<center><b>Divergências</b></center>
</td>
<td>
Caso na aba <i>Divergências com a SEFAZ</i> possua algum dado é mostrado aqui a quantidade de registros.
</td>
</tr>
<tr>
<td>
<center><b>Cancelamento forçado</b></center>
</td>
<td>
Caso tenha havido algum cancelamento forçado é mostrado no grid de <i>Comparação de Dados</i> com a cor laranja.
</td>
</tr>
<tr>
<td>
<center><b>CF-e sem Chave</b></center>
</td>
<td>
Caso exista algum cupom que não tenha uma chave relacionada ao mesmo é mostrado no grid de <i>Comparação de Dados</i> com a cor verde.
</td>
</tr>
<tr>
<td>
<center><b>CF-e sem Lote</b></center>
</td>
<td>
Caso exista algum cupom que não tenha um lote relacionado ao mesmo na resposta da SEFAZ é mostrado no grid de <i>Comparação de Dados</i> com a cor azul.
</td>
</tr>
<tr>
<td>
<br><br><br>
<center><b>Comparação de Dados</b></center>
</td>
<td>
Neste grid, além das cores descritas acima, existem três colunas do lado direito que fazem referência a estes casos:
<br><br>
<table>
<tr>
<td>
<center><i><b>Venda</b></i></center>
</td>
<td>
Existe um registro deste cupom como venda no sistema.
</td>
</tr>
<td>
<center><i><b>Canc.</b></i></center>
</td>
<td>
Existe um registro deste cupom como cancelado no sistema.
</td>
</tr>
<td> 
<center><i><b>Rejeita.</b></i></center>
</td>
<td>
Existe um registro deste cupom como rejeitado no sistema.
</td>
</tr>
</table>
</td>
</tr>
</table>
</html>

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:

{{ :easycash:sat_conferenciacupom_retorno.png |}}

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:

{{ :easycash:sat_conferenciavenda_abadivergencia.png |}}

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

{{ :easycash:sat_consulta_sgrsat.png |}}

São eles:

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

<note>A consulta pela chave via interface, pode não funcionar em alguns computadores, por conta do componente utilizado, em razão disso, deve-se utilizar a consulta utilizando a **OPÇÃO 2**.</note>

{{ :easycash:sat_consultapublica_captcha.png |}}

{{ :easycash:sat_consultapublica_resposta.png |}}

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

<note>O caminho do link que irá abrir nesta opção na interface pode ser configurado na mesma tela onde é inserida a chave de acesso do contribuinte.</note>

{{ :easycash:sgr-sat_consulta2.png |}}

<note important>Caso seja encontrada alguma divergência deve-se **IMEDIATAMENTE** entrar em contato com o **SUPORTE TÉCNICO** para que o mesmo possa validar as informações e a causa das mesmas.</note>
==== Configuração ====

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.

{{ :easycash:sat_config.png |}}
<html><center><b><i style="color:#000000;font-size:12px;">Menu Configuração</i></b></center></html>

=== Carregar Alíquotas ===

Mostra as alíquotas cadastradas para o SAT. Caso não haja nenhuma, pode-se [[easycash:manual_de_instrucao_sat&#configuracoes_no_retaguarda|carregar as mesmas da retaguarda]] adicionando-as para utilização no frente de caixa.

=== Carregar Comprovante Não Fiscal ===

Mostra os comprovantes cadastrados para o SAT. Caso não haja nenhum, pode-se [[easycash:manual_de_instrucao_sat&#configuracoes_no_retaguarda|carregar as mesmas da retaguarda]] adicionando-os para utilização no frente de caixa.

=== Carregar Forma de Pagamento ===

Mostra as formas de pagamento PAI cadastradas para o SAT. Caso não haja nenhuma, pode-se [[easycash:manual_de_instrucao_sat&#configuracoes_no_retaguarda|carregar as mesmas da retaguarda]] adicionando-as para utilização no frente de caixa.
  
=== Carregar Relatório Gerencial ===

Mostra os relatórios gerenciais cadastrados para o SAT. Caso não haja nenhum, pode-se [[easycash:manual_de_instrucao_sat&#configuracoes_no_retaguarda|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:

{{ :easycash:formas_de_recebimento.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Formas de Recebimento</i></b></center></html>

{{ :easycash:sat-relatoriogerencial.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Relatórios Gerenciais</i></b></center></html>

{{ :easycash:sat-comprovantenaofiscal.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Comprovantes Não-Fiscais</i></b></center></html>

==== Ferramentas ====

=== Ativação ===

{{ :easycash:sat_ferramentasativacao.png |}} 
<html><center><b><i style="color:#000000;font-size:12px;">Menu Ferramentas - Ativação</i></b></center></html>

== Ativar SAT ==

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

{{ :easycash:sat-tiposcertificados.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Tipos de Ativação</i></b></center></html>

== Associar Assinatura ==

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

{{ :easycash:associacao_de_assinatura.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Associação de Assinatura</i></b></center></html>

== Comunicar Certificado ==

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.             

== Bloquear SAT ==

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.

== Desbloquear SAT ==

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

== Trocar Código de Ativação ==

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.

=== Consultas ===

{{ :easycash:sat_menuconsultas.png |}} 
<html><center><b><i style="color:#000000;font-size:12px;">Menu Ferramentas - Consultas</i></b></center></html>

==Consultar Número de Sessão==

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

{{ :easycash:sat_consultar_numero_de_sessao.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Consulta do Número de Sessão</i></b></center></html>

== Consulta Pública da Chave ==

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.
  
{{ :easycash:consulta_publica.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Consulta Pública da Chave do CF-e</i></b></center></html>

== Consultar SAT ==

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

{{ :easycash:mensagem_de_sat_em_oper.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Mensagem de Informação</i></b></center></html>

== Consultar Status Operacional ==

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.

{{ :easycash:status_sat.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Status do SAT e da Impressora POS</i></b></center></html>

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

{{ :easycash:sat-frentebarraicone.jpg |}}

=== Diversos ===
{{ :easycash:sat_ferramentasdiversos.png |}}
<html><center><b><i style="color:#000000;font-size:12px;">Menu Ferramentas - Diversos</i></b></center></html>

== Extrair Logs ==

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.

{{ :easycash:extrair_log.jpg |}} 
<html><center><b><i style="color:#000000;font-size:12px;">Menu Extrair Logs</i></b></center></html>

== Teste Fim-a-Fim ==

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.

{{ :easycash:sat_teste_fim_a_fim.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Menu Teste Fim-a-Fim</i></b></center></html>

==== Última Comunicação SEFAZ ====
  
É 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. 

{{ :easycash:comunicacao_com_sefaz.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Mensagem Informativa</i></b></center></html>

==== Validação de Conexão de Rede ====

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.

{{ :easycash:teste_conexao.png |}}

<html><center><b><i style="color:#000000;font-size:12px;">Teste de Conexão</i></b></center></html>

<note>Caso adicione uma URL para executar o teste, a mesma não será salva na lista junto com as URL padrões. Assim que sair da tela será apagada da lista.</note>

==== Validação de XML =====

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

{{ :easycash:validacao_xml.png |}}

<html><center><b><i style="color:#000000;font-size:12px;">Tela principal da Validação de XML</i></b></center></html>

{{ :easycash:validacao_xml_arquivo.png |}}

<html><center><b><i style="color:#000000;font-size:12px;">Aba ARQUIVO da Validação de XML</i></b></center></html>

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:

{{ :easycash:campo_arquivo.png |}}

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

<note important>Caso o operador digite o número de sessão, o código de erro e como as datas sempre são setadas automaticamente pelo componente, esta será a pesquisa de maior importância, levando em consideração os 3 fatores e sobrescrevendo a lista anteriormente citada.</note>

{{ :easycash:validador_xml_banco_de_dados.png |}}

<html><center><b><i style="color:#000000;font-size:12px;">Aba BANCO DE DADOS da Validação de XML</i></b></center></html>

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

==== Leitura X ====

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.

==== Reimpressão ====
  
{{ :easycash:reimpressao_de_doc.jpg |}} 
<html><center><b><i style="color:#000000;font-size:12px;">Tela de Reimpressão</i></b></center></html>

==== Encerramento do Dia ====

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.
  
{{ :easycash:encerramento.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Mensagem exibida ao Encerrar o Dia</i></b></center></html>

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.
===== Relatórios =====

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

{{ :easycash:relatorios_sat.png |}}

{{ :easycash:relatorios_venda_canc_rejeitado.png |}}

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.

{{ :easycash:previw.png |}}

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.

{{ :easycash:aba_resultado.png |}}

===== Configurações do SAT =====

Pode ser acessado pelo menu: 

<html><center>
<b>Configurações</b> → <b>Equipamentos</b> → <b>SAT</b></center></html> 

{{ :easycash:configuracao_sat.png |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações do Equipamento SAT</i></b></center></html>

==== Dados Gerais ====

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

{{ :easycash:config.gerais_do_sat.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações da aba Dados Gerais</i></b></center></html>

Vale ressaltar nesta tela duas configurações:

<html>

<center>
<table style="width:100%">
<tr>
<td style="width:30%"><b><center>Versão do leiaute do CF-e</center></b></td>
<td>Deve-se configurar a versão do leiaute que o SAT está utilizando para transmitir o CF-e. A algum tempo foi retirada a versão 0.06, sendo atualmente utilizada a versão 0.07.</td>
</tr>
<tr>
<td style="width:30%"><b><center>Página de Código</center></b></td>
<td>Deve-se configurar a página de código que o SAT utiliza para interpretar os caracteres das informações enviadas para o mesmo. Para o SAT da Bematech utilizamos a página de código 65001(UTF-8). Maiores informações podem ser obtidas no link </html>[[https://msdn.microsoft.com/pt-br/library/2x8et5ee.aspx|MSDN - Páginas de código]]<html>.</td>
</tr>
</table>
</center>

</html>

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.

{{ :easycash:sat_vincular_assinatura.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações de Vincular Assinatura</i></b></center></html>
  
==== Rede ====

{{ :easycash:config.sat_rede.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações da aba Rede</i></b></center></html>
  
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.

==== Impressão ====

A impressão do CF-e segue as diretrizes descritas no manual de orientação da 
[[https://portal.fazenda.sp.gov.br/servicos/sat/Paginas/Downloads.aspx|SEFAZ de São Paulo]]. Temos:

__Cupom Fiscal Eletrônico__:

{{ :easycash:manual_satcfe.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Visual Padrão do CF-e</i></b></center></html>

__Cancelamento do Cupom Fiscal Eletrônico__:

{{ :easycash:manual_satcfecancelamento.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Visual Padrão do Cancelamento de CF-e</i></b></center></html>

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

{{ :easycash:manual_satqrcode.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Especificações da SEFAZ para o Código de Barras e o QR Code</i></b></center></html>

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

{{ :easycash:configuracao_sat_impressao.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações da aba Impressão</i></b></center></html>

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:

{{ :easycash:pos_configporta.jpg |}}

**Interfaces suportadas:** 

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

<note important>Ambas as fotos abaixo foram emitidas em ambiente de homologação(sem validade fiscal), logo podem conter informações adicionais que não aparecem no CF-e de produção.</note>

Segue:

=== Fortes Report (Gerador de Relatório) ===

Mais informações podem ser encontradas neste [[https://github.com/fortesinformatica/fortesreport-ce|link]]. Lembrando que __**esta forma de impressão faz utilização do spooler de impressão do sistema operacional Windows**__.

{{ :easycash:sat_vendacancelamentofortes.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Venda e Cancelamento utilizando Fortes Report</i></b></center></html>
  
Como descrito acima, este processo faz utilização do serviço de spooler do Windows, demonstrado abaixo:

{{ :easycash:spooler_impressao.jpg? 900|}}

<html><center><b><i style="color:#000000;font-size:12px;">Demonstração do serviço do Windows</i></b></center></html>

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

{{ :easycash:impressoraposinstalada.jpg? 900|}}

<html><center><b><i style="color:#000000;font-size:12px;">Impressora instalada no Painel de Controle</i></b></center></html>

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:

{{ :easycash:spooler_veroqueestasendoimpresso.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Visualização do que está sendo impresso</i></b></center></html>

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:

{{ :easycash:sat_configfortes.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configuração específica para o Fortes Report</i></b></center></html>

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. 

=== ESC/POS ===

Uma pequena descrição pode ser encontrada neste [[https://en.wikipedia.org/wiki/ESC/P|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 [[http://partners.bematech.com.br/bemacast/Paginas/post.aspx?idPost=6099|link]]. __Este forma de impressão envia os comandos diretamente para a impressora POS__.

{{ :easycash:sat_vendacancelamentoescpos.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Venda e Cancelamento utilizando ESC/POS</i></b></center></html>

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:

{{ :easycash:sat_configescpos.jpg |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configuração específica para o ESC/POS</i></b></center></html>

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:

{{ :easycash:sat_logcontroleporta.jpg |}}

=== Envio de Dados(Dispositivo) ===

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:

{{ :easycash:sat_configdispositivo.png |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configuração do buffer de transmissão com a Impressora</i></b></center></html>

Temos:

<html>
<table>
<tr>
<td>
<center><b>Buffer de Envio</b></center>
</td>
<td>
Determina o número máximo de bytes a serem enviados pela porta serial.
</td>
</tr>
<tr>
<td>
<center><b>Espera Buffer</b></center>
</td>
<td>
Determina o tempo em milissegundos a ser aguardado pelo sistema antes do envio do próximo Buffer de dados.
</td>
</tr>
<tr>
<td>
<center><b>Timeout(s)</b></center>
</td>
<td>
Tempo máximo que irá esperar uma resposta da impressora para considerar a mesma inoperante. Esta propriedade funciona no nível mais baixo de requisição ao hardware.
</td>
</tr>
<tr>
<td>
<center><b>LinhasBuffer</b></center>
</td>
<td>
Limita a quantidade de informações que estarão no buffer para envio para a impressora.
</td>
</tr>
</table>
</html>

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).
=====  Configurações no Retaguarda =====
 
No retaguarda, pode-se acessar o menu:

<html><center>
<b>Configuração</b> → <b>EasyCash</b> → <b>SAT</b></center></html>

Onde podemos configurar:

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

Segue:

{{ :easycash:intellicash_sat.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Menu de Configuração do SAT no retaguarda</i></b></center></html>

{{ :easycash:intellicash_sat_comprovantes_nf.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Programação de Comprovante Não-Fiscal</i></b></center></html>

{{ :easycash:intellicash_sat_formas_de_pagamento.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Programação de Forma de Pagamento</i></b></center></html>

{{ :easycash:intellicash_sat_relatorio_gerencial.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Programação de Relatório Gerencial</i></b></center></html>

Na coluna 'Sistema', temos:\\
  ***1** - Registro padrão do sistema e não pode ser modificado\\
  ***0** - Registro novo cadastrado pelo usuário

<note important>Na liberação do SAT para utilização no frente de caixa, automaticamente o sistema tenta trazer para o banco do mesmo, as informações de alíquota, comprovante não-fiscal, relatório gerencial e formas de pagamento.</note> 

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

<html><center><b>
Gerenciamento → Cadastro → Produtos → Atributos → Tributação</b></center></html>

Segue:

{{ :easycash:sat-tributacaoretag.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Tela de tributação do retaguarda</i></b></center></html>
===== Relatório de Logs =====

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.

{{ :easycash:logs.png |}}

{{ :easycash:logs2.png |}}


===== Liberação do Emissor de CF-e =====

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:

<html><center><b>
Gerenciamento → Cadastros → ECF's</b></center></html>

Segue:

{{ :easycash:sat-cadastroretaguarda.jpg |}}

<html><center><b><i style="color:#000000;font-size:12px;">Tela de cadastro de ECF do retaguarda</i></b></center></html>

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. 

{{ :easycash:liberacao_ecf.png |}}

<html><center><b><i style="color:#000000;font-size:12px;">Tela de liberação do sistema EasyCash</i></b></center></html>
===== Diagrama de composição do imposto no S@T =====

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

{{ :easycash:sat_-_diagrama_de_composicao_de_imposto_no_xml.png |}}

<note important>A partir da Especificação de Requisitos versão 2.14.10 página 73, layout 0.07, para o TIPO ICMS = 21 a tributação N - CSOSN passa a ser 400 - [[http://example.com|https://portal.fazenda.sp.gov.br/servicos/sat/Downloads/Especificacao_SAT_v_ER_2_14_10.pdf]]</note>

Para **TRIBPISCOFINS**:

<html>
<center>
<table>
<tr>
<td>
<b>159</b>(Isenta de Contribuição)
</td>
<td>
<b>pis07 / cof07</b>
</td>
</tr>
<tr>
<td>
<b>160</b>(Sem Incidência da Contribuição)
</td>
<td>
<b>pis08 / cof08</b>
</td>
</tr>
<tr>
<td>
<b>161</b>(Com Suspensão da Contribuição)
</td>
<td>
<b>pis09 / cof09</b>
</td>
</tr>
</table>
</center>
</html>
===== Equipamentos Testados =====

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

==== SAT ====

<html>
<center>
<table>
<tr>
<td>
<b>Linker SAT</b>
</td>
<td>
Elgin
</td>
</tr>
<tr>
<td>
<b>NSAT-4200</b>
</td>
<td>
Nitere 
</td>
</tr>
<tr>
<td>
<b>SS-1000</b>
</td>
<td>
Sweda
</td>
</tr>
<tr>
<td>
<b>TS-1000</b>
</td>
<td>
Tanca
</td>
</tr>
<tr>
<td>
<b>D-SAT</b>
</td>
<td>
Dimep 
</td>
</tr>

<tr>
<td>
<b>Smart SAT</b>
</td>
<td>
Elgin 
</td>
</tr>
<tr>
<td>
<b>S@T-ID</b>
</td>
<td>
Control ID
</td>
</tr>
<tr>
<td>
<b>GerSAT 3.0</b>
</td>
<td>
Gertec
</td>
</tr>
</table>
</center>
</html>
==== Impressora POS ====

<html>
<center>
<table>
<tr>
<td>
<b>MP-4200 TH</b>
</td>
<td>
Bematech 
</td>
</tr>
<tr>
<td>
<b>SI-300S</b>
</td>
<td>
Sweda
</td>
</tr>
<tr>
<td>
<b>Elgin i9</b>
</td>
<td>
Elgin
</td>
</tr>
<tr>
<td>
<b>Print iD Touch</b>
</td>
<td>
Control ID
</td>
</tr>
</table>
</center>
</html>
===== Informações Complementares =====

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:

[[https://portal.fazenda.sp.gov.br/servicos/sat/Paginas/PaginaGuiaDoUsuario.aspx|Guia do Usuário - Da Aquisição do SAT à Vinculação do Aplicativo Comercial ao SAT]]

[[https://portal.fazenda.sp.gov.br/servicos/sat/Downloads/Manual_Orientacao_SAT_v_MO_2_16_02.pdf|Manual de Orientação do SAT – versão 02.16.02 – 18 de maio de 2017]]

[[https://portal.fazenda.sp.gov.br/servicos/sat/Downloads/Guia_Aplicativo_QRCode_SATSP_V02.pdf|Guia de Uso do Aplicativo QRCode - Como usar o Aplicativo QRCode (Atualizado em 12/01/2015)]]

[[https://portal.fazenda.sp.gov.br/servicos/sat/Downloads/Especificacao_SAT_v_ER_2_23_01.pdf|Especificação de Requisitos do SAT versão 02.23.01]]

[[https://portal.fazenda.sp.gov.br/servicos/sat/Paginas/obrigatoriedade.aspx|Obrigatoriedade de Uso do SAT]]

[[https://portal.fazenda.sp.gov.br/servicos/sat/Downloads/Modelo-Pedido_de_Cessa%C3%A7%C3%A3o_de_Uso_de_SAT.pdf|Modelo - Pedido de Cessação de Uso de SAT]]

<note>Links atualizados no dia 23/01/2018.</note>

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.

===== Solução de Problemas =====

==== Erro na abertura da porta de comunicação com o S@T ====

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 [[http://wiki.intelliware.com.br/doku.php?id=easycash:guia_de_instalacao_sat#informacoes_complementares|ú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:

{{ :easycash:energiaPortaUSB01.png |}}

{{ :easycash:energiaPortaUSB02.png |}}

==== Data/Hora do computador difere do equipamento S@T ====

Neste caso, é importante validar se o fuso horário no painel de controle encontra-se devidamente setado para Brasília, conforme listado neste [[http://bematechpartners.com.br/wiki/index.php/2017/10/09/fuso-horario-fiscal-manager-sat-vecf/|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  [[https://www.tecmundo.com.br/placa-mae/106522-saber-bateria-cmos-computador-defeito.htm|link]].
Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página
