Tutorial DLLSAT.DLL for Windows


  1. Introdução
  2. Chamando a DLL
  3. Instanciando uma função da DLL
  4. Acessando a porta de Comunicação
  5. Funções da DLL


1. Introdução

Esta DLL implementaas funções de comunicação entre o aplicativo AC e o equipamento SAT através de chamadas de funções de alto nível. A API desta biblioteca, segue as definições da especificação de requisitos do SAT publicado pela SEFAZ-SP. A DLL detecta de forma automática a porta serial em que o SAT etá conectado, entretanto caso se deseje espeficicar a porta, pode-se utilizar a função AbreSerialSAT.

1.1. Limitações atuais

Esta DLL foi testada nas seguintes versões de Windows:

1.2. Tempos de Respostas

Os tempos de respostas da DLL seguem a especificação de requisitos que define o tempo máximo de timeout para cada função da API, portanto, nada precisa ser feito em relação a gerencia de timeout que fica totalmente a cargo da DLL.

1.3. Codificação do XML de Entrada

É muito importante atentar para que os xmls de entrada gerados pelo aplicativo de automação (AC) codifiquem os XMLs sempre em UTF-8. Arquivos XMLs coficados em outro formato poderá ser rejeitado pela retaguarda da SEFAZ. A DLL não consiste estes aqruivos de entrada, portanto é de responsabilidade do AC garantir a correta codificação dos mesmos.

1.4. Bibliotecas Adicionais

A DLLSAL.DLL necessita da biblioteca zlib.dll que realiza a compressão e descompressão de dados. É essencial a sua instalação para o correto funcionamento da DLL de comunicação, entretanto não há necessidade de nenhuma referencia a zlib.dll pela aplicação, ficando seu uso restrita a DLLSAT.DLL.

2. Chamando a DLL

A DLL pode ser chamada em qualquer linguagem de programação através de chamadas especificas para o carregamento da DLL em memória. Abaixo um exemplo de chamada da DLL em C++:

3. Instanciando uma função da DLL

De forma geral as funções da DLL podem ser facilmente instanciadas em diversas linguagens, abaixo um exemplo de chamada de uma função da DLL em C++:

4. Acessando a porta de Comunicação

A DLL possui três formas de acesso a porta de comunicação com o SAT:

É importante deixar claro que apenas um dos métodos acima deve ser utilizado para definir a porta de comunicação com o SAT.

5. Funções da DLL

O arquivo de header define os protótipos das funções exportadas pela DLL. Abaixo o corpo do arquivo de definições:


DIMEP Sistemas Ltda. <