Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- easycash:manual_de_instrucao_servidor_sat [2017/08/04 13:52]
amonteiro [Watchdog]
+++ easycash:manual_de_instrucao_servidor_sat [2023/07/12 18:31] (atual)
amonteiro [Configuração da Retaguarda]
@@ Linha 2: / Linha 2: @@
 A liberação do servidor do S@T ocorreu na versão 1.3.005.000.
+<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>
 Foi criado um aplicativo servidor de modo que implementa um sistema de fila de comandos a serem enviados para o SAT. O SAT não realiza multiprocessamento, logo é processado um comando por vez. O objetivo é que **no máximo três PDVs** possam emitir venda utilizando um único SAT. O funcionamento é basicamente o seguinte:
@@ Linha 25: / Linha 28: @@
 **a) Conexão com o Banco de Dados:**
 <html>
-<p style="margin: 0;">[BDServer]</p>
+<br><br>
-<p style="margin: 0;">UserName=SYSDBA</p>
+<b>[BDServer]</b>
-<p style="margin: 0;">Pwd=XXXXXXXXXXXXXXXXXXXX</p>
+<br>
-<p style="margin: 0;">Path=C:\IWS\EC\BD\SERVER_SAT.fdb</p>
-<p style="margin: 0;">Charset=WIN1252</p>
+<center>
-<p style="margin: 0;">Embedded=0</p>
+<table style="width:100%">
+<tr>
+<td>UserName=SYSDBA</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Usuário do Firebird para acesso ao banco de dados.</b></td>
+</tr>
+<tr>
+<td>Pwd=XXXXXXXXXXXXXXXXXXXX</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Senha do Firebird criptografada </i></b></td>
+</tr>
+<tr>
+<td>Path=C:\IWS\EC\BD\SERVER_SAT.fdb</td>
+<td><b><i style="color:#2370BC;font-size:12px;">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.</i></b></td>
+</tr>
+<tr>
+<td>Charset=WIN1252</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Configuração do Firebird para que seja utilizado caracteres de acentuação.</i></b></td>
+</tr>
+<tr>
+<td>Embedded=0</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Descrição a seguir.</i></b></td>
+</tr>
+</table>
+</center>
 </html>
@@ Linha 41: / Linha 66: @@
 <html>
-<p style="margin: 0;">[SAT]</p>
+<center>
-<p style="margin: 0;">AcessoDLL=2</p>
+<table style="width:100%">
-<p style="margin: 0;">ServerPorta=5060</p>
+<tr>
-<p style="margin: 0;">Trace=0</p>
+<td>Trace=0</td>
-<p style="margin: 0;">Marca=BEMATECH</p>
+<td><b><i style="color:#2370BC;font-size:12px;">Habilita um log adicional para arquivar dados adicionais em relação as conexões executadas ao servidor. Utilizado para questões de suporte. Por padrão, vêm desabilitada.</i></b></td>
-<p style="margin: 0;">Porta=COM1</p>
+</tr>
-<p style="margin: 0;">NomeDLL=C:\IWS\EC\SAT\BemaSAT32.dll</p>
+<tr>
-<p style="margin: 0;">CodigoAtivacao=XXXXXXXXXXXXXXXXXXXX</p>
+<td>ServerPorta=5060</td>
-<p style="margin: 0;">SwHAssinatura=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</p>
+<td><b><i style="color:#2370BC;font-size:12px;">Porta que o servidor do SAT está operando.</i></b></td>
-<p style="margin: 0;">PaginaDeCodigo=65001</p>
+</tr>
-<p style="margin: 0;">VersaoDadosEnt=0,07</p>
+<tr>
-</html>
+<td>AcessoDLL=2</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Forma de acesso  as funções da DLL do SAT.  Bematech e Sweda utiliza padrão 2, no caso de ser outro fabricante, verificar a configuração correta no manual do SAT.</i></b></td>
+</tr>
+</table>
+</center>
-Segue as configurações padrões do SAT que é realizada no EasyCash. Com dois adendos:
+</html>
-**- ServerPorta:** Porta que o servidor do SAT está operando.\\
+<note>
-**- Trace:** Habilita um log adicional para arquivar dados adicionais em relação as conexões executadas ao servidor. Utilizado para questões de suporte. Por padrão, vêm desabilitada.\\
+Nesta tag é aceito:
+  * 0 - Nenhum
+  * 1 - cdecl [[https://msdn.microsoft.com/pt-br/library/zkwh89ks.aspx|Definição __cdecl]]
+  * 2 - stdcall [[https://msdn.microsoft.com/pt-br/library/zxk0tw93.aspx|Definição __stdcall]]
+</note>
+<html>
+<center>
+<table style="width:100%">
+<tr>
+<td>Porta=COM18</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Porta do equipamento SAT</i></b></td>
+</tr>
+<tr>
+<td>Marca=BEMATECH</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Modelo do equipamento SAT</i></b></td>
+</tr>
+<tr>
+<td>NomeDLL=C:\IWS\EC\Client\SAT\BemaSAT32.dll</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Caminho da DLL do SAT que deve ficar dentro da pasta SAT.</i></b></td>
+</tr>
+<tr>
+<td>CodigoAtivacao=5F8181818383DA64E2</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Código de ativação do SAT. Esse código de ativação é criptografado.</i></b></td>
+</tr>
+<tr>
+<td>SwHAssinatura=XXXXXXXX</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Esse é o vinculo entre CNPJ do cliente e o CNPJ da Software House criptografado e informado pela IWS conforme item anterior Associar Assinatura.</i></b></td>
+</tr>
+<tr>
+<td>PaginaDeCodigo=65001</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Sistema trabalha com o padrão UTF-8. Verificar no manual do SAT se trabalha com esse padrão.</i></b></td>
+</tr>
+<tr>
+<td>VersaoDadosEnt=0,07</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Versão do XML. Padrão do sistema de acordo com a SEFAZ.</i></b></td>
+</tr>
+</table>
+</center>
+</html>
 ==== Opções ====
 {{ :easycash:menu_opcoes.jpg |}}
@@ Linha 171: / Linha 240: @@
 Segue uma pequena descrição de cada comando e seu valor default para o servidor:
-  * **Associar Assinatura:** Comando para associar o CNPJ da empresa que utilizará o SAT e a empresa desenvolvedora para identificação perante a SEFAZ. Tempo default: **20 segundos**
+<html>
-  * **Ativar SAT:** Comando para poder efetuar a liberação do equipamento SAT junto a SEFAZ para utilização em produção. Neste processo o SAT recebe os parâmetros e diretrizes de trabalho. Tempo default: **300 segundos**
-  * **Atualizar Software:** Comando utilizado para receber uma nova versão do layout dos XML enviados para o webservice da SEFAZ caso exista algum disponível. Lembrando que o aplicativo comercial também deve ser compatível com a nova versão para comunicar com sucesso com o equipamento SAT. Tempo default: **1800 segundos**
+<center>
-  * **Bloquear SAT:** Permite bloquear o SAT impossibilitando efetuar venda. Geralmente utilizado quando o mesmo irá ficar desativado por um longo período de tempo. Tempo default: **300 segundos**
+<table style="width:100%">
-  * **Consultar SAT:** Comando para efetuar um teste rápido para sabermos se o SAT está em operação. Tempo default: **10 segundos**
+<tr>
-  * **Desbloquear SAT:** Comando para desbloquear o SAT caso o mesmo esteja no estado BLOQUEADO. Tempo default: **20 segundos**
+<td><b><center><font color="blue">Comando</font></center></b></td>
-  * **Enviar Dados Venda:** Comando para enviar os dados para o SAT, para que o mesmo possa autenticar e retornar uma resposta. Tempo default: **10 segundos**
+<td><b><center><font color="blue">Descrição</font></center></b></td>
-  * **Inicializado:** Comando utilizado pelo framework interno  do servidor para efetuar uma validação rápida se o componente do mesmo está habilitado. Tempo default: **30 segundos**
+<td><b><center><font color="blue">Tempo Default</font></center></b></td>
-  * **Configurar Interface de Rede:** Permite modificar as configurações de acesso a rede do SAT, como IP, Gateway, DNS, proxy, entre outros. Tempo default: **20 segundos**
+<tr>
-  * **Comunica Certificado ICP Brasil:** Comando utilizado caso o cliente quiser enviar o seu próprio certificado devidamente registrado e homologado por uma entidade certificadora. No caso do estado de São Paulo a própria SEFAZ no momento do cadastro disponibiliza um certificado gratuito para autenticação e transmissão dos XML de venda. Tempo default: **30 segundos**
+<td><b><center><font color="orange">Associar Assinatura</font></center></b></td>
-  * **Consultar Número Sessão:** Comando para poder efetuar uma consulta utilizando o número de sessão, para poder visualizar o status de determinado CF-e associado ao mesmo na SEFAZ. Tempo default: **20 segundos**
+<td>Comando para associar o CNPJ da empresa que utilizará o SAT e a empresa desenvolvedora para identificação perante a SEFAZ.</td>
-  * **Consultar Status Operacional:** Comando que permite obter um detalhamento completo das informações do SAT, como: Tipo de rede, IP, DNS, Gateway, número de série, data e hora do SAT, data e hora da última comunicação com a SEFAZ, data de validade do certificado, status de trabalho do SAT, último CF-e transmitido para a SEFAZ, entre outros. Tempo default: **20 segundos**
+<td><b><center>20 segundos</center></b></td>
-  * **Cancelar Última Venda:** Comando utilizado para poder efetuar o cancelamento de uma venda, respeitando o limite máximo de tempo de que o CF-e têm que ter sido emitido nos últimos 30 minutos. Tempo default: **10 segundos**
+</tr>
-  * **Teste Fim-a-Fim:** Comando utilizado para efetuar um teste completo de comunicação entre o aplicativo comercial, o SAT e a SEFAZ. Tempo default: **20 segundos**
+<tr>
-  * **Trocar Código de Ativação:** Comando que possibilita trocar o código de segurança do SAT cadastrado na ativação. Este código é utilizado em vários procedimentos no SAT. Tempo default: **20 segundos**
+<td><b><center><font color="orange">Ativar SAT</font></center></b></td>
-  * **Desinicializar:** Comando utilizado pelo framework interno  do servidor para desinicializar o componente de acesso ao SAT. Tempo default: **30 segundos**
+<td>Comando para poder efetuar a liberação do equipamento SAT junto a SEFAZ para utilização em produção. Neste processo o SAT recebe os parâmetros e diretrizes de trabalho.</td>
-  * **Inicializar:** Comando utilizado pelo framework interno  do servidor para inicializar o componente de acesso ao SAT. Tempo default: **30 segundos**
+<td><b><center>300 segundos</center></b></td>
-  * **Inicializa:** Comando utilizado pelo framework interno  do servidor para inicializar o componente de acesso ao SAT. É uma variação do comando anterior. Tempo default: **30 segundos**
+<tr>
-  * **Extrair Log:** Comando utilizado para extrair os logs de registro de atividade que o SAT mantêm, muito útil em caso de erro, onde é necessário saber informações detalhadas do procedimento. Tempo default: **20 segundos**
+<td><b><center><font color="orange">Atualizar Software</font></center></b></td>
+<td>Comando utilizado para receber uma nova versão do layout dos XML enviados para o webservice da SEFAZ caso exista algum disponível. Lembrando que o aplicativo comercial também deve ser compatível com a nova versão para comunicar com sucesso com o equipamento SAT.</td>
+<td><b><center>1800 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Bloquear SAT</font></center></b></td>
+<td>Permite bloquear o SAT impossibilitando efetuar venda. Geralmente utilizado quando o mesmo irá ficar desativado por um longo período de tempo.</td>
+<td><b><center>300 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Consultar SAT</font></center></b></td>
+<td>Comando para efetuar um teste rápido para sabermos se o SAT está em operação.</td>
+<td><b><center>10 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Desbloquear SAT</font></center></b></td>
+<td>Comando para desbloquear o SAT caso o mesmo esteja no estado BLOQUEADO.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Enviar Dados Venda</font></center></b></td>
+<td>Comando para enviar os dados para o SAT, para que o mesmo possa autenticar e retornar uma resposta.</td>
+<td><b><center>10 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Inicializado</font></center></b></td>
+<td>Comando utilizado pelo framework interno  do servidor para efetuar uma validação rápida se o componente do mesmo está habilitado.</td>
+<td><b><center>30 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Configurar Interface de Rede</font></center></b></td>
+<td>Permite modificar as configurações de acesso a rede do SAT, como IP, Gateway, DNS, proxy, entre outros.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Comunica Certificado ICP Brasil</font></center></b></td>
+<td>Comando utilizado caso o cliente quiser enviar o seu próprio certificado devidamente registrado e homologado por uma entidade certificadora. No caso do estado de São Paulo a própria SEFAZ no momento do cadastro disponibiliza um certificado gratuito para autenticação e transmissão dos XML de venda.</td>
+<td><b><center>30 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Consultar Número Sessão</font></center></b></td>
+<td>Comando para poder efetuar uma consulta utilizando o número de sessão, para poder visualizar o status de determinado CF-e associado ao mesmo na SEFAZ.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Consultar Status Operacional</font></center></b></td>
+<td>Comando que permite obter um detalhamento completo das informações do SAT, como: Tipo de rede, IP, DNS, Gateway, número de série, data e hora do SAT, data e hora da última comunicação com a SEFAZ, data de validade do certificado, status de trabalho do SAT, último CF-e transmitido para a SEFAZ, entre outros.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Cancelar Última Venda</font></center></b></td>
+<td>Comando utilizado para poder efetuar o cancelamento de uma venda, respeitando o limite máximo de tempo de que o CF-e têm que ter sido emitido nos últimos 30 minutos.</td>
+<td><b><center>10 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Teste Fim-a-Fim</font></center></b></td>
+<td>Comando utilizado para efetuar um teste completo de comunicação entre o aplicativo comercial, o SAT e a SEFAZ.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Trocar Código de Ativação</font></center></b></td>
+<td>Comando que possibilita trocar o código de segurança do SAT cadastrado na ativação. Este código é utilizado em vários procedimentos no SAT.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Desinicializar</font></center></b></td>
+<td>Comando utilizado pelo framework interno  do servidor para desinicializar o componente de acesso ao SAT.</td>
+<td><b><center>30 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Inicializar</font></center></b></td>
+<td>Comando utilizado pelo framework interno  do servidor para inicializar o componente de acesso ao SAT.</td>
+<td><b><center>30 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Inicializa</font></center></b></td>
+<td>Comando utilizado pelo framework interno  do servidor para inicializar o componente de acesso ao SAT. É uma variação do comando anterior.</td>
+<td><b><center>30 segundos</center></b></td>
+</tr>
+<tr>
+<td><b><center><font color="orange">Extrair Log</font></center></b></td>
+<td>Comando utilizado para extrair os logs de registro de atividade que o SAT mantêm, muito útil em caso de erro, onde é necessário saber informações detalhadas do procedimento.</td>
+<td><b><center>20 segundos</center></b></td>
+</tr>
+</table>
+</center>
+</html>
 .
@@ Linha 200: / Linha 356: @@
 <html><center><b><i style="color:#000000;font-size:12px;"></i></b></center></html>
-Veja esta funcionalidade através do link: [[http://wiki.intelliware.com.br/doku.php?id=easycash:manual_de_instrucao_sat#configuracoes_do_equipamento_sat|Manual de Instrução SAT#Configurações do Equipamento SAT]]
+Veja esta funcionalidade através do link: [[easycash:manual_de_instrucao_sat#dados_gerais|Manual de Instrução SAT#Dados Gerais]]
 ==== Aba Empresa ====
 {{ :easycash:servidor_aba_empresa.jpg |}}
@@ Linha 208: / Linha 363: @@
 <note important>Os dados informados nesta aba devem ser os mesmos utilizados para a ativação do SAT. Caso contrário os CF-e serão rejeitados pelo equipamento.</note>
-Nesta aba deve constar as seguintes informações fidedignas da empresa que irá utilizar o equipamento:
+Nesta aba deve constar as seguintes <html><mark>informações fidedignas da empresa</mark></html> que irá utilizar o equipamento:
   * **Razão Social**
   * **Unidade Federativa**
@@ Linha 223: / Linha 378: @@
 O valor default apresentado se refere ao __tempo máximo de timeout de processamento__ dos comandos básicos do PDV no servidor somado a dois segundos adicionais de segurança.
+===== Configurações do EasyCash =====
+Para que o PDV EasyCash trabalhe com o servidor, é necessário adicionar ou alterar as seguintes tags no arquivo 'EasyCash1.ini'. Seguem:
+<html>
+<b>[SAT]</b>
+<br>
+<center>
+<table style="width:100%">
+<tr>
+<td>Remoto=0</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Desabilita(0) ou habilita(1) o EasyCash para trabalhar com o servidor SAT. Mesmo que o servidor seja o próprio caixa que irá utilizá-lo deve-se setar esta opção.</i></b></td>
+</tr>
+<tr>
+<td>RemotoPorta=5060</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Porta em que o servidor do EasyCash está em modo LISTENING. A porta padrão é 5060.</i></b></td>
+</tr>
+<tr>
+<td>RemotoHost=192.168.0.14</td>
+<td><b><i style="color:#2370BC;font-size:12px;">IP do host onde o servidor está sendo executado.</i></b></td>
+</tr>
+<tr>
+<td>RemotoConnectionTO=10000</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Valor padrão em millisegundos do timeout de conexão.</i></b></td>
+</tr>
+<tr>
+<td>RemotoCommunicationTO=10000</td>
+<td><b><i style="color:#2370BC;font-size:12px;">Valor padrão em millisegundos do timeout de comunicação.</i></b></td>
+</tr>
+</table>
+</center>
+</html>
+===== Configurações da Retaguarda =====
+Deve-se no cadastro dos caixas que forem utilizar o servidor de compartilhamento de SAT, setar o **MESMO SERIAL** e habilitar a flag **REMOTO**, conforme a imagem abaixo:
+{{ :easycash:imagem_2023-07-12_152829781.png?650 |}}

Documentação de software

Ferramentas do usuário

Ferramentas do site

Diferenças

Ferramentas da página