A DarumaFramework faz o tratamento de retornos ficar simples.

A DarumaFramework faz o tratamento de retornos ficar simples.

Olá, todos fazem tratamento de retornos no sistema né?! Queremos acreditar que sim! Com impressoras fiscais, o tratamento é indispensável no sistema, ainda mais quando se pensa em homologar a aplicação. É vital para o sistema saber o que está acontecendo com a ECF. Imaginem só, você manda os comandos para emitir um cupom fiscal, ele não é emitido e o seu sistema não mostra nenhuma mensagem para o usuário?! Imaginaram que ruim seria isso, sendo que o motivo da não impressão era uma simples mensagem dizendo: “ECF sem papel”.

Outro cenário seria você que já começou o cupom e está registrando os itens, de repente os itens não são mais impressos. Seu cliente deve pensar: “O sistema travou”, mas na verdade a alíquota daquele item não está programada na impressora. Viram só como simples retornos podem gerar um novo suporte ou uma má impressão para seu cliente?! Anteriormente nós lançamos um Escovando Bits mostrando uma sugestão para tratamento de retornos, se alguém usa essa maneira, sem problemas. Não está errada. Só que nós queremos anunciar que melhoramos o processo, isso mesmo! Deixamos o que era fácil, mais fácil ainda. Acompanhem!

Entendendo o tratamento de retornos

Cada método executado na DarumaFramework possui um retorno.
Esse retorno é um número que possui um significado. Por exemplo, retorno 1 significa “Operação Realizada com sucesso”, retorno -2 “Parâmetro Incorreto” e assim por diante.
Consulte todos os possíveis retornos de métodos da ECF Daruma

Além dos retornos em cada método que já ajuda muito a identificar o que está acontecendo, nossas impressoras possuem Erros e Avisos, que nada mais são do que um retorno adicional da ECF. Por exemplo, você emite uma Leitura X e recebe o retorno 1 – “Operação Realizada com Sucesso”. Após receber o retorno 1, faz o tratamento e recebe o Aviso 1, que nada mais é do que “Papel acabando”.

Entendendo erro

O erro que a ECF retorna significa que existe uma condição que não está bacana na impressora fiscal. Em grande parte, um erro impede que o comando seja executado. Queremos incentivar vocês, escovadores de bits, a praticar o tratamento de retornos e entender porque X método não foi executado.

Por exemplo, nós enviamos um comando para totalizar o cupom fiscal, mas ele nem foi aberto. A impressora irá nos dizer “Não em fase de venda ou totalização” retornando o erro 115.
Consulte todos os possíveis números de erros

Entendendo aviso

Quando nós recebemos um aviso, não significa que existe algo errado, algo que impede o funcionamento da impressora. Apenas significa que a impressora quer manifestar um estado de atenção. Por exemplo, te avisando que o “Papel acabando” através do aviso 1. Com este aviso, você irá fazer tudo normalmente, mas apenas atente-se a ECF, pois qualquer hora o papel pode acabar.
Consulte todos os possíveis avisos

Escovadores de Bits, voltamos a pedir que vocês pratiquem o tratamento de retornos no sistema de vocês. Está na hora de sairmos da Introdução e partirmos pra ação. Vamos lá! 

Testando o tratamento de retornos

Chegou a hora de entendermos na prática como será o funcionamento do tratamento de retornos.

  • O primeiro passo é fazer o download do Executável em Delphi7.
  • Após o download, extraia o pacote e abra a pasta “DarumaFramework_Delphi7exe”.
  • Execute o “DarumaFramework_Delphi.exe” para começarmos os testes.

Exemplo

[Exemplo]

  • O exemplo foi aberto! Agora clique em “Impressoras Fiscal”.
  • Uma nova janela será aberta, clique no menu “Relatórios Fiscais” -> submenu “Leitura X” -> “Método iLeituraX_ECF_Daruma”.

Exemplo

[Exemplo]

  • O método será executado e você receberá um retorno na tela.

Exemplo

[Exemplo]

  • Note que nosso retorno foi 1, isso significa que tudo ocorreu com sucesso.
  • O objetivo agora é tentar simular um retorno diferente de 1, vamos tentar?!
  • Desligue sua impressora fiscal.
  • Clique novamente no menu “Relatórios Fiscais” -> submenu “Leitura X” -> “Método iLeituraX_ECF_Daruma”.

Exemplo

[Exemplo]

  • Escovadores de bits, o retorno foi o mesmo? O meu não foi. 

Exemplo

[Exemplo]

  • Vocês também receberam o retorno -6 né?! Ele significa que a impressora estava desligada, exatamente o que pretendíamos obter.
  • Viram só como o tratamento de retornos nos ajuda a saber mais sobre a impressora?
  • Vamos continuar, agora testando erros.

Testando o números de erros

Vamos continuar usando o Executável em Delphi7 para fazer os testes com números de erros.

  • Na janela com vários menus, clique no menu “Cupom Fiscal” -> submenu “Abertura de Cupom Fiscal” -> “Método iCFAbrirPadrao_ECF_Daruma”.

Exemplo

[Exemplo]

  • O comando de abertura de cupom fiscal será executado e nós vamos receber um retorno.

Exemplo

[Exemplo]

  • O cupom fiscal foi aberto normalmente como realmente deve ser.
  • Vamos simular um erro? Para isso é simples, basta enviar novamente o comando de abertura de cupom fiscal.
  • Então, clique novamente no menu “Cupom Fiscal” -> submenu “Abertura de Cupom Fiscal” -> “Método iCFAbrirPadrao_ECF_Daruma”.

Exemplo

[Exemplo]

  • O retorno que tivemos foi 78, significa que já existe um Cupom Fiscal Aberto.

Exemplo

[Exemplo]

  • Escovadores de Bits, olhem que fantástico esse recurso: saber exatamente o porque seu cupom fiscal não foi aberto. Não deixem de usar isso, pode ter certeza que sua aplicação será outra após a implementação do tratamento de retornos.
  • Como o objetivo era só mostrar o erro, vamos cancelar nosso cupom fiscal e seguir o escovando.

Testando os avisos da Impressora Fiscal

Estamos na etapa final de nossos testes, vamos testar agora como receber um aviso da ECF. Lembrando que aviso não impede o funcionamento do comando, é apenas uma forma de te avisar de algum estado da impressora.

  • Vamos continuar com nosso bom e atualizado Executável em Delphi7.
  • Na janela de menus Impressoras Fiscal, clique no menu “Relatórios Fiscais” -> submenu “Leitura X” -> “Método iLeituraX_ECF_Daruma”.

Exemplo

[Exemplo]

  • O método será executado e você receberá um retorno na tela.

Exemplo

[Exemplo]

  • Já que nosso objetivo é simular o número de aviso. Vamos deixar apenas um pedaço pequeno de papel dentro da impressora.
  • Deixe o equivalente ao tamanho de umas três Leituras X, isso é só para simularmos.
  • Após remover a bobina e deixar apenas um pedaço de papel térmico, vamos fazer outra Leitura X.
  • Então clique novamente no menu “Relatórios Fiscais” -> submenu “Leitura X” -> “Método iLeituraX_ECF_Daruma”.

Exemplo

[Exemplo]

  • A Leitura X será impressa e você receberá um retorno na tela.

Exemplo

[Exemplo]

  • Olha só quem apareceu por aqui! Nosso esperado “Aviso”. Viram só que bacana essa funcionalidade?
  • A Leitura X foi impressa normalmente, mas a impressora nos diz que o papel está acabando.

Escovadores de Bits, o recado que tenho para dar é: façam o tratamento de retorno, sua aplicação vai mudar depois disso.

Vamos escovar bits de fato?!

Escovando o tratamento de retornos

DELPHI

C#

VISUAL BASIC 6

VB.NET

JAVA

PHP

Curtiram o escovando? Espero que sim!

Assistam ao vídeo completo mostrando passo a passo como funciona o Tratamento de Retornos na ECF Daruma.

[Vídeo]Se tiver alguma dúvida e/ou dificuldade, entre em contato com a nossa equipe de suporte ao desenvolvedor.

 

Fonte: Portal Desenvolvedores Daruma

Deixe uma resposta