Automação comercial: Conhecendo o assembly Bematech.Fiscal.dll

No artigo passado pudemos conhecer a nova ferramenta de conectividade da Bematech - o Bematech Flash Builder. Neste artigo, iremos "colocar a mão na massa" e iniciar o nosso primeiro projeto.

por André Luiz R. Munhoz

No artigo passado pudemos conhecer a nova ferramenta de conectividade da Bematech - o Bematech Flash Builder.

Vimos a sua diferença em relação a BemaFI32.dll e suas principais vantagens.

Vimos também, como esta ferramenta está estrutura e seus principais assemblies.

Neste artigo, iremos "colocar a mão na massa" e iniciar o nosso primeiro projeto. Mas antes, é importante sabermos que esta nova ferramenta possui tipos variados de tratamento de erro (exceptions), que são levantados quando ocorre algum erro. São eles:

• BematechException
Classe abstrata herdada por todas as exceções levantadas pelo Bematech Flash Builder.

• FiscalException
Erro de exceção levantado sempre que um comando enviado à impressora fiscal não for executado.

Através da exceção FiscalException, não é mais necessário verificar o estado da impressora após cada execução de comando. A própria ferramenta se encarrega de verificar isso para você.

• ParametroInvalidoException
É o erro de exceção levantado sempre quando um parâmetro de comando é inválido.

• ComunicacaoException
É o erro de exceção levantado quando ocorre alguma falha na comunicação com a impressora fiscal (erro de porta serial).

• FimPapelException
É o erro de exceção levantado quando há falta de papel na impressora fiscal.

Importante: Não existe uma exceção para o estado de "pouco papel", pois este estado não significa um erro e, sim, uma informação. Veremos este estado e outros que a impressora possui, na classe "StatusImpressora".

Observação: Veremos as demais exceções durante o desenvolvimento.

Quando ocorrer algum tipo de erro, podemos verificar onde este erro ocorreu (origem da exceção) e qual o seu código, podendo tratar e informar, de forma mais clara, o operador.

Você já pensou na agilidade que isso nos traz?

Referenciando o assembly ao projeto

Depois de conhecermos as exceptions levantadas pela ferramenta, vamos iniciar o nosso pequeno projeto de solução comercial, começando pela adição do(s) assembly(ies) que iremos utilizar.

Estaremos utilizando o Visual Studio .NET 2003 e os códigos estarão nas versões C# e VB.NET.

Iniciamos o nosso projeto com a impressora fiscal, então, os assemblies que iremos referenciar são: Bematech.dll e Bematech.Fiscal.dll.

Depois de criar o projeto e já estando com a tela de design aberta, clique com o botão direito do mouse na opção "References", da janela "Solution Explorer", e escolha "Add Reference...". Procure por Bematech.dll e Bematech.Fiscal.dll, e clique em OK.

Os dois assemblies aparecem na jabela "Solution Explorer".

O próximo passo é declarar os namespaces que iremos usar. Para isso, vá até o início do código e acrescente as seguintes linhas:

• para C#

• para VB.NET

Criando a Impressora Fiscal

Para podermos utilizar os métodos das classes referenciadas ao projeto, será necessário criarmos a impressora fiscal. No conceito de orientação a objetos, usaríamos "New()", mas como a impressora fiscal é única no PDV, usaremos o método "Construir()" da classe ImpressoraFiscal, que será o nosso "ponto de partida" para todas as operações envolvendo a impressora fiscal.

Vamos criá-la no public class do form principal.

• em C#

• em VB .NET

Onde:

ImpressoraFiscal é a classe que detém os métodos da impressora fiscal;
BematechFiscal é o objeto (variável) que receberá a instância dos métodos e;
ImpressoraFiscal.Construir() é o método construtor da classe.

A partir desta construção, todos os demais métodos serão exibidos através do nosso objeto BematechFiscal.

Não perca o próximo artigo!

Estaremos desenvolvendo o nosso primeiro cupom fiscal, através dos métodos "Abrir", "Vender", "Fechar", "Cancelar" e obter seu número (COO), além de conhecer os seus principais overloads e tratamentos de erros (exceções).

Até a próxima e boas implementações!