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.
====== Versão 1.5.003.000 ======

''**Versão liberada dia: 06/12/2024**\\
**Versão Intellicash: Mínima 3.1.019.000 **\\
**Versão Executável: 1.5.003.000 **\\
**Versão EcUpdater: 1.0.0.54 **\\
**Versão IWS Notify: 1.0.7.0 **\\ 
**Versão EcAutoUpdater: 1.0.0.3 **\\
**Servidor EasyCash: 2.0.13.0 **\\
**WatchDog: 1.0.0.5 **\\
**[[https://wiki.iws.com.br/doku.php?id=intellicash:atualizacoes:3.1.018.000|IntelliCash: 3.1.019.000 ]]**
''\\

===== Funcionalidades =====


==== Quantidade de vias recarga de celular ====
Foi adicionada uma nova configuração que permite ao usuário definir o comportamento da **impressão dos comprovantes de recarga de celular**.

Essa configuração oferece **três opções de impressão** e **duas opções de foco padrão** para a pergunta exibida na tela, conforme ilustrado abaixo:


{{ :easycash:versoes:ConfigImpRecCel.png?450 |}}

**Comportamento conforme a configuração escolhida:**

  - **Sempre imprime** - Imprime automaticamente **as duas vias** do comprovante (cliente e estabelecimento), sem exibir nenhuma pergunta.
  -  **Perguntar se deseja imprimir as duas vias** - Uma mensagem é exibida com a pergunta: "Deseja imprimir as duas vias?"  
    - Se o usuário clicar em **SIM**, ambas as vias serão impressas.  
    - Se clicar em **NÃO**, **nenhuma via** será impressa.
  -  **Perguntar se deseja imprimir a via do cliente** - A pergunta exibida será: "Deseja imprimir a via do cliente?"  
    - Se o usuário clicar em **SIM**, ambas as vias serão impressas.  
    - Se clicar em **NÃO**, **apenas a via do estabelecimento** será impressa.

**Foco padrão**

Além das opções acima, é possível definir qual botão terá o **foco inicial na pergunta de confirmação**:  
  * **Foco no SIM**
  * **Foco no NÃO**

==== Envio da data de vencimento do Certificado Digital para o IWB ====
O sistema EasyCash agora envia automaticamente a **data de vencimento do certificado digital** instalado na máquina para o IWB, seguindo os critérios abaixo:

  - A data só será enviada se:
    - A **data de vencimento** capturada for **maior que a data atual**, e;
    - O **CNPJ do certificado digital** corresponder ao **CNPJ** armazenado no banco de dados local.
  - Para clientes com estrutura **matriz e filial** que utilizam o mesmo certificado digital, é feita a **validação pela raiz do CNPJ** (ou seja, os 8 primeiros dígitos), permitindo compatibilidade entre as lojas.
  - O envio dessas informações é feito de forma automática via **API integrada com o IWB**.


==== Abrir gaveta para sangria ====
Foi adicionada uma nova **configuração** que permite abrir automaticamente a **gaveta de dinheiro ao realizar uma sangria** no PDV.


{{ :easycash:versoes:SangriaAbreGav.png?450 |}}

Essa função visa agilizar o processo e garantir praticidade na operação de retirada de valores.

==== Promoção especial (com ou sem forma de pagamento) ====
Agora é possível configurar **promoções especiais** que:
  * Exigem uma **forma de pagamento específica**, ou;
  * **Não exigem forma de pagamento**, permitindo maior flexibilidade na aplicação de campanhas e descontos.

Essa funcionalidade amplia as possibilidades de estratégia comercial, permitindo campanhas direcionadas conforme a necessidade do negócio.










===== Melhorias =====
==== Saldo de autorizado no frente de caixa ====
Para aprimorar o processo de finalização da venda, especialmente em casos em que o cliente possua **autorizados vinculados**, foi implementada uma melhoria que permite:
  * Visualizar o **saldo disponível** e o **limite de crédito** de cada autorizado no momento da seleção;
  * Realizar essa consulta **mesmo quando a retaguarda estiver offline**, garantindo mais autonomia ao EasyCash e evitando interrupções nas vendas.  
{{ :easycash:versoes:Saldo.png?450 |}}

==== Duplicar Cupom de Datas Anteriores ====
oi aprimorada a funcionalidade de **duplicação de cupons**, permitindo agora replicar cupons emitidos até **7 dias anteriores** à data atual do pedido — superando o limite anterior de apenas 2 dias.
{{ :easycash:versoes:pedidosDuplicarCupom.png?450 |}}

Na imagem acima, é possível visualizar a nova melhoria do sistema, que agora permite duplicar cupons mesmo após vários dias da venda original.

==== Aumento da tela de configuração ====
A tela de configurações do sistema foi expandida para facilitar a usuabilidade.

{{ :easycash:versoes:expansaoTelaConfig.png?450 |}}

==== SAT - Retirar validação do ini IgnoraStatusFinalizacao ====
Foi implementada uma nova validação no processo de comunicação com o **SAT**, com o objetivo de **evitar a geração de cupons no PDV que não sejam efetivamente enviados ao equipamento**.

Essa melhoria garante maior segurança na emissão fiscal, tratando situações em que o SAT não responde de forma adequada.

**Alterações realizadas:**
  * O sistema agora valida a comunicação com o SAT **antes de gerar o cupom**, prevenindo inconsistências fiscais;
  * A antiga configuração `IgnoraStatusFinalizacao` (presente no arquivo `.ini`) foi **removida** do sistema, pois não é mais necessária com a nova abordagem;
  * A leitura e o uso dessa tag foram completamente descontinuados.

==== Liberação de contingência no fim de semana ====
Com o objetivo de **facilitar o atendimento do Suporte e garantir a continuidade das operações dos clientes**, foi aprimorado o processo de **liberação emergencial ou offline do EasyCash (via Intelliweb)**.

**O que mudou:**
  * Quando a liberação emergencial for feita em **finais de semana**, a licença **só irá expirar no próximo dia útil**, evitando bloqueios em horários críticos e fora do expediente;
  * A validade da liberação emergencial offline agora é **fixada em 3 dias corridos**, proporcionando um tempo seguro para regularização da licença sem interrupções no funcionamento do caixa.

Essa melhoria garante maior estabilidade nas operações e reduz a necessidade de suporte imediato em dias não úteis.

==== Foco do botão na Pré-Venda ====
Foi adicionada uma nova configuração que permite ao usuário definir qual botão receberá o **foco inicial** ao abrir a tela de **Pré-Venda**.

{{ :easycash:versoes:TelaPreVenda2.png?450 |}}

Essa personalização oferece mais agilidade no atendimento, permitindo escolher entre:

  * **Botão OK**: foco inicial na confirmação.
  * **Botão Localizar**: foco inicial na busca de cupons.

{{ :easycash:versoes:ConfigFocoBotaoPreVenda.png?450 |}}


==== Solicitação de Ajuste na Mensagem de Erro no Sistema TEF ====

A mensagem exibida atualmente em casos de falha na comunicação com o //TEF// era:
**"Sem conexão com o servidor"**.

Para evitar ambiguidades e tornar a informação mais clara para o usuário, a mensagem foi atualizada para:
**"Sem conexão com o TEF"**.

Essa alteração visa facilitar a identificação do problema, já que o termo **“servidor”** é genérico e pode gerar dúvidas quanto à origem da falha. Com a nova mensagem, o sistema deixa evidente que a instabilidade está relacionada ao //TEF// (Transferência Eletrônica de Fundos), otimizando o suporte e a experiência do operador.

==== Melhoria no fluxo do troco digital ====
Foi implementada uma melhoria no processo de **troco digital**, visando garantir maior continuidade e confiabilidade mesmo em situações de **ausência de conexão com a internet**.

Como funciona:
  * Ao identificar que **não há conexão ativa com a internet**, o sistema passa a **consultar o saldo do cliente diretamente na retaguarda**.
  * Para permitir essa operação offline, foi criada uma **nova permissão específica**, que deve ser ativada para liberar o uso do saldo nesse cenário.
  * O valor utilizado como troco digital será marcado como **pendente de exportação**, e será automaticamente enviado à API assim que a conexão for restabelecida.
  * Durante esse processo, o **saldo utilizado é armazenado em tempo real na retaguarda**, no momento da finalização do cupom, garantindo rastreabilidade e consistência dos dados.

==== Segunda via: Incluir Informações ====
Foi adicionada uma nova configuração que permite incluir informações adicionais na impressão da segunda via do cupom fiscal. Agora, é possível exibir os seguintes dados ao final do documento:
  * Quantidade de itens vendidos
  * Total de unidades vendidas

A imagem abaixo ilustra onde a nova configuração pode ser habilitada:

{{ :easycash:versoes:PDV: Segunda via.png?450 |}}

Entenda os campos:
  * Quantidade de itens vendidos: Refere-se ao número de produtos distintos.
Exemplo: Se foram vendidas 5 unidades do item A e 5 unidades do item B, o total de itens vendidos será 2.
  * Total de unidades vendidas: Soma de todas as unidades de produtos comercializados.
Exemplo: Com os mesmos dados acima, o total de unidades vendidas será 10.

==== Tela de configurações do PDV ====

A tela de Configurações do PDV foi aprimorada para evitar a abertura múltipla de janelas do mesmo tipo.

A partir desta versão, o sistema permite abrir apenas uma instância da tela de configurações por vez, evitando duplicidade e possíveis conflitos ao editar as configurações simultaneamente.

==== Vale troca que gera troco virar outro vale ====
Foi adicionada uma nova configuração que permite transformar o **troco de uma troca em uma nova troca residual**. Essa funcionalidade oferece mais flexibilidade no processo de finalização de compras com cupons de troca.

> **Importante:**  
> Para que a troca residual funcione, a configuração de **troco digital deve estar desabilitada**.

Na imagem abaixo, é possível visualizar as opções disponíveis quando a funcionalidade está ativada:

{{ :easycash:versoes:ConfigTrocaResidual.png?450 |}}

Como Funciona:
Quando um **cupom de troca ou residual** é utilizado e seu valor **excede o valor da compra**, o sistema permite gerar um novo **cupom de troca residual** com o valor restante.

Ao finalizar a venda, será exibida a seguinte pergunta ao operador:

{{ :easycash:versoes:perguntaTrocaResidual.png?450 |}}

  * Se a opção **"SIM"** for selecionada, o sistema imprimirá um novo **cupom residual** com o saldo remanescente.
  * Caso a opção **"NÃO"** seja escolhida, apenas o cupom fiscal da venda será impresso.

==== Cbenef - cadastro do produto ====
Foi adicionado um novo campo chamado **"Código do Beneficiário"** na tela de cadastro de produto.

A nova informação pode ser utilizada futuramente para integrações, filtros ou relatórios relacionados ao beneficiário do produto.

{{ :easycash:versoes:TelaCadProd.png?450 |}}

==== CBenef - Gerenciamento do Servidor com opção alterar o Cbenef no XML ====
Foi aprimorada a funcionalidade de **alteração de XML** dentro do gerenciamento do Servidor, permitindo agora também **incluir ou alterar o campo "CBenef" (Código de Beneficio Fiscal)**, da mesma forma como já ocorre com os campos **NCM** e **CEST**.

Além da edição manual, o sistema agora também permite consultar e obter o CBenef diretamente da retaguarda.

{{ :easycash:versoes:CbenefXML.png?450 |}}

Regras e Validações:
  * A exibição e exigência do campo CBenef respeita as regras fiscais conforme:
    * O CST do item (caso exija CBenef).
    * O estado emissor do documento, considerando os estados que obrigam a inclusão do código.
  * O sistema não permitirá a geração do XML se as informações alteradas não forem aplicadas e salvas previamente no banco de dados, evitando inconsistências fiscais ou operacionais.

==== Opção de imprimir a observação do orçamento ====


===== Correções =====
==== Mensagem de erro ====
A mensagem de erro agora informa se o problema está relacionado ao **EasyCash Server** ou ao **Notify**, especificando qual serviço não está conectando. Além disso, orienta o que deve ser feito para solucionar a falha.

==== Tela Sobre: Atualizar data licença ====
Atualização no campo que exibe a data de vencimento do contrato de licença.

{{ :easycash:versoes:datalicenca.png?450 |}}

==== Configuração do notify ====
Foi identificado que, ao instalar um novo caixa, ocorria um erro de conexão com o servidor. Esse problema foi tratado para evitar que aconteça novamente.

==== Troca de mercadoria desfeita ====
Ao remover uma troca com a retaguarda offline, o sistema agora exibe mensagens solicitando confirmação para tentar reconectar. Caso a conexão não seja restabelecida, o sistema informa que o cupom será cancelado.  
Isso evita que a troca seja removida do cupom sem que tenha sido efetivamente desfeita.

==== Detalhamento dos Descontos Automáticos ====
As informações de desconto estavam trocadas na exibição. O problema foi identificado e corrigido.

==== Erro ao iniciar o sistema com certificado inexistente ====
Durante os testes, foi constatado que, ao tentar iniciar o sistema com um certificado ausente na máquina, eram exibidas mensagens de erro e o sistema não abria.

{{ :easycash:versoes:ErroMensagem.png?450 |}}

Agora, os erros são exibidos normalmente, e o sistema pode ser iniciado, permitindo que o novo certificado seja cadastrado diretamente na aplicação. No caminho **Configurações -> PDV -> NFC-e -> Certificado**. Após configurar o novo certificado é necessário reiniciar o sistema.

**Processo falho na abertura do EC esperando impressora**
Ao iniciar o sistema, foi identificada a necessidade de validar a presença da impressora de forma mais rápida, permitindo que a mensagem relacionada ao arquivo `.ini` seja exibida imediatamente.

Essa melhoria visa acelerar a inicialização do sistema, reduzindo o tempo de espera até a exibição da tela de vendas.

**Soluções implementadas:**
  - Inclusão de parâmetros no arquivo `.ini` para controle de comunicação com a impressora: `Timeout`, `DeviceRetry` e `DelayStatus`.
  - Implementação de um status de configuração chamado **"Ignorar status da impressora"**, que permite pular a validação inicial.

{{ :easycash:versoes:StatusImpressora.png?450 |}}

==== Identificação do consumidor na troca ====
Foi detectado que, ao desfazer uma troca, a identificação do cliente permanecia ativa, desativando o botão **F6 - Identificação** e impedindo a troca do consumidor.

O problema foi corrigido e agora o botão volta a ser habilitado, permitindo a substituição do cliente sem necessidade de cancelar o cupom.

==== Processo de importação entre vendas no caixa de Pré-Venda ====
Implementada a funcionalidade de importação de produtos entre cupons quando o caixa está operando no modo **Pré-Venda**.

==== Motivo de sangria/suprimento não excluído ====
Foi identificado que, ao alterar os motivos de **Sangria** e **Suprimento** na retaguarda e realizar a importação para o Frente de Caixa, os motivos antigos não estavam sendo removidos. 

A lógica foi corrigida: agora, antes de importar os novos motivos, os antigos são automaticamente excluídos.

==== Liberação indevida do frente de caixa ====
O sistema estava permitindo o uso do Frente de Caixa mesmo sem uma licença válida disponível. 

{{ :easycash:versoes:mensagemErro.png?450 |}}

O comportamento foi ajustado para que, na ausência de licença, todas as funcionalidades de abertura do caixa sejam corretamente desabilitadas, mesmo que haja uma licença cadastrada no banco de dados.

{{ :easycash:versoes:LiberacaoSemLicenca.png?450 |}}

==== Desconto no item ====
Foi corrigido o problema em que a janela de desconto permanecia aberta mesmo após clicar em "Cancelar" ou "OK".

Agora, se ambos os campos (percentual e valor) estiverem zerados e o usuário clicar em **OK**, uma mensagem será exibida solicitando o preenchimento de pelo menos um dos campos.

{{ :easycash:versoes:descontoItem.png?450 |}}

==== Troco em forma de pagamento não permitida ====
Ao selecionar uma forma de pagamento que **não permite troco**, o sistema agora exibe um aviso de erro adequado.

Para configurar corretamente, acesse:  
**"Cadastro de Item da Forma de Pagamento / Recebimento"** e habilite a opção **"Permitir troco"**.

{{ :easycash:versoes:PermitirTrico.png?450 |}}

==== Erro ao desativar entrega ====
Foi identificado que, ao desmarcar a opção de entrega durante a finalização do cupom, a tela não era atualizada corretamente. 

A lógica foi ajustada para que, ao desativar a entrega, o frete seja **removido imediatamente e refletido na tela de forma correta**, garantindo maior clareza para o operador.

==== Erro na impressão de parcelamento ====
Correção aplicada na rotina de **impressão do parcelamento**, garantindo que as informações apareçam corretamente nos comprovantes gerados.

====  Falha ao finalizar uma comanda sem o agente no frente ====
Foi detectado que, ao finalizar uma comanda cujo agente é um **fornecedor** (e não está cadastrado como cliente no Frente de Caixa), ocorria falha no processo.  

Foi implementado um tratamento que, na ausência do agente no Frente, o sistema assume automaticamente o consumidor padrão. 

Esse mesmo comportamento se aplica caso o agente seja um cliente, mas não esteja sincronizado no Frente.

==== DAV duplicado ====
Ocorriam erros ao tentar processar um DAV já em andamento. Além disso, ao pressionar **ESC** na mensagem de aviso, os itens estavam sendo **duplicados**.

A falha foi corrigida na procedure responsável pela alimentação da tabela, impedindo a duplicidade de itens mesmo em situações de cancelamento da operação.

==== EasyCash server com acess violation ====
Foi identificado um erro do tipo **Access Violation** ao iniciar o **servidor do EasyCash** em determinados caixas. Após a análise ser realizada, constatou o problema.

O erro não era recorrente em todas as máquinas, mas afetava de forma crítica a inicialização do serviço em alguns ambientes específicos, impedindo o funcionamento adequado do sistema.

A aplicação foi estabilizada, e o erro de *Access Violation* não ocorre mais.
Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página
