FireMonkey e NFe 2.0 - Revista ClubeDelphi 138 - Parte 1

A Nota Fiscal Eletrônica se tornou uma obrigatoriedade na maioria das aplicações comerciais e industriais da atualidade no país. Ela surgiu com o propósito de substituir a emissão de notas fiscais em papel por um documento eletrônico, devidamente baseado em um padrão constituído de várias regras e que deve ser assinado digitalmente pelo emitente através de um certificado digital para garantir sua autenticidade. Tal documento deve ser elaborado, validado, transmitido, autorizado e por fim, consultado através da Internet, possibilitando assim um acompanhamento fiscal das movimentações comerciais praticamente em tempo real pela Secretaria da Fazenda - SEFAZ. Entretanto, para o transporte das mercadorias presentes na nota e a facilidade de consulta, existe o DANFE (Documento Auxiliar da Nota Fiscal Eletrônica), que pode ser impresso em uma folha de papel comum, porém que não substitui o documento eletrônico e tampouco é considerado uma nota fiscal.

Há alguns anos atrás quando surgiu, a Nota Fiscal Eletrônica fez com que muitas empresas e desenvolvedores tivessem que se adaptar e adotar um novo padrão na elaboração de seus projetos e alimentação dos dados nas bases.

Além do executável da aplicação comercial, suas informações também devem estar coerentes e compostas pelos objetos que estão presentes na nota fiscal, como os impostos, para que os mesmos possam ser futuramente calculados. Também é importante ressaltar que para a emissão das notas fiscais, a empresa deve entrar em contato com um órgão responsável para a obtenção do certificado digital, possibilitando assim a futura assinatura da nota. É evidente que esta se torna a primeira fase da implantação do Projeto de NF-e, ou seja, a base necessária para que uma nota possa ser gerada e assinada pela aplicação.

Uma vez que a base para o Projeto está concluída, os dados das notas fiscais devem ser sujeitos a uma validação ainda na aplicação do cliente, permitindo assim a detecção de erros antes do envio das mesmas. Tal validação deve ser feita através dos schemas disponibilizados pela Secretaria da Fazenda. Os schemas (arquivos XSD – XML Schema Definition) são documentos baseados em XML (Extensible Markup Language) que possuem regras de validação para serem aplicadas em arquivos XML, uma vez que a nota fiscal eletrônica é um documento baseado nesta linguagem. Algumas regras de validação que devem ser bem observadas durante a elaboração da nota fiscal eletrônica, pois podem causar “dores de cabeça” no momento da validação, tratam da existência de espaços no início e no fim das informações presentes nos elementos, bem como a utilização de quebras de linha no arquivo XML com a intenção de efetuar uma formatação no arquivo texto, dentre várias outras.

Com o documento eletrônico elaborado, assinado e validado, o próximo passo é efetuar sua transmissão para um Web Service da Secretaria da Fazenda. Um Web Service é um serviço automatizado que disponibiliza as mais variadas funções através da Internet, permitindo assim a troca de informações entre diversas aplicações e plataformas, sendo baseado em XML e HTML. Em suma, ele “simplesmente” recebe uma solicitação, processa e devolve uma resposta para o solicitante. Para que exista tal comunicação, uma implementação do protocolo SOAP (Simple Object Access Protocol) pode ser efetuada, disponibilizando assim a independência necessária para o funcionamento do Web Service. Contudo, para que se possa acessar e utilizar os recursos de um Web Service, há a necessidade de se conhecer sua estrutura. Tal estrutura pode ser obtida através de um arquivo XML sob a padronização WSDL (Web Service Description Language) ou, muitas vezes, através de um manual de utilização do mesmo, como é o caso dos Web Services da Secretaria da Fazenda. Para o ambiente da Nota Fiscal Eletrônica são disponibilizados vários Web Services, sendo destinados para homologação (testes) e produção. Estes possibilitam o envio, cancelamento, inutilização e diversas consultas das notas fiscais eletrônicas emitidas através da aplicação cliente. Vale à pena lembrar que os Web Services também são constituídos de serviços síncronos e assíncronos, onde neste último, a aplicação cliente deve fazer futuras consultas até obter a resposta almejada. No que diz respeito ao FireMonkey, a mais recente plataforma de desenvolvimento de aplicações presente no Delphi XE 2, também pode ser utilizada para a elaboração das notas fiscais eletrônicas. Vale a pena lembrar que vários objetos e recursos presentes na VCL também estão presentes no FireMonkey, como é o caso do XML Data Binding, que será abordado posteriormente, possibilitando assim a estrutura para a elaboração de uma aplicação NF-e.

XML Data Binding

O recurso XML Data Binding é muito útil e se torna essencial para a elaboração de uma aplicação NF-e, obtendo assim uma alta produtividade, uma vez que a Secretaria da Fazenda disponibiliza os XML Schemas para geração e validação das notas fiscais.

O assistente para utilização deste recurso pode ser facilmente acessado no Delphi XE 2 através do menu File>New>Other>XML>XML Data Binding. Vale à pena evidenciar que o XML Data Binding também está disponível em versões anteriores do Delphi. Através dele é possível gerar classes originadas de XML Schemas (XSD), arquivos DTD (Document Type Definition), Data Reduced XML (XDR) e etc.

Ao utilizar o assistente, a primeira etapa é a seleção do esquema ou documento XML para que futuramente uma Unit possa ser gerada automaticamente de acordo com o Schema informado, permitindo também que possam ser especificadas as estratégias de nomes para a geração das interfaces e classes. A Figura 1 demonstra a tela inicial do assistente de XML Data Binding do Delphi XE 2.

Figura 1. Tela inicial do assistente de XML Data Binding

No próximo passo, é possível visualizar e fornecer informações detalhadas para cada nó e seus elementos (se existirem) no esquema ou documento. Também pode ser gerada uma função global que utiliza um objeto do tipo TXMLDocument, possibilitando o retorno da interface do nó raiz pertencente a hierarquia de dados. O TXMLDocument é um objeto que pode ser utilizado para a construção de um arquivo XML (novo ou existente), bem como possibilitar sua leitura, podendo ser futuramente gravado em um arquivo.

Com a conclusão do assistente, o documento XML é abstraído para um grupo de interfaces que permitem a definição de valores finais, em outras palavras, a representação de um objeto (documento XML) é feita na memória, não necessitando que a aplicação utilize DOM (Document Object Model), SAX (Simple API for XML) ou outro recurso para acesso aos dados. Ao utilizar tal recurso, o código do nó raiz é uma interface derivada de TXMLDocument, como mencionado anteriormente, e seus nós filhos podem ser derivados de qualquer IXMLNode ou interface gerada à partir do tipo do nó. Após a obtenção das classes, a leitura e a criação de arquivos do tipo XML se torna muito mais fácil e rápida, permitindo uma maior produtividade e flexibilidade na manipulação dos dados. Vale à pena evidenciar também que, como o XML foi mapeado em uma Unit, a mesma pode ser facilmente gravada em conjunto com o projeto. Como pode ser observado, na elaboração das classes o Delphi utiliza interfaces para a geração dos métodos públicos, podendo assim utilizar o mecanismo denominado contagem de referência para que a instância seja liberada da memória de uma maneira automática, sendo assim, um método que utilize a interface não necessita que sua referência seja removida de forma explicita.