Usando um Web Service num projeto do Visual Studio

O envio das Notas Fiscais Eletrônicas para a Receita Federal é feito através de Web Services disponibilizados pela própria Receita. Quando falei neste blog a respeito da assinatura digital do XML, não tinha entrado neste assunto. Agora, me perguntaram como é que isso pode ser feito.

Os Web Services são uma solução de chamada remota de funções (mais ou menos como o CORBA ou o RPC) baseada no protocolo SOAP definido pelo Consórcio para padrões na Internet, o W3C. O SOAP foi amplamente adotado por ser baseado em XML, ou seja, a estrutura das mensagens trocadas poder ser estendida com facilidade.

Um Web Service é descrito por um arquivo de extensão WSDL (Web Service Description Language), que é na verdade um XML com uma estrutura bem conhecida. É o WSDL quem estabelece quais são as operações disponíveis no Web Service, isto é, quais são as funções (ou Serviços) que estão disponíveis, quais são os nomes e os tipos dos parâmetros que devem ser passados para a função. O WSDL permite até mesmo a criação de tipos de dados complexos, baseados em definições XSD.

Cada chamada a uma operação de um Web Service é feita construindo um XML que inclui a identificação do computador remoto (em forma de um endereço Web, também chamado de URL). Esse XML também inclui o próprio nome da função que será chamada no computador remoto e a lista dos parâmetros exigidos para chamar tal função, com seus nomes, seus respectivos tipos de dados e os valores com os quais desejamos que a chamada seja feita. Da mesma maneira, o retorno produzido pela chamada remota à função é também um XML, o qual contem as informações devolvidas pelo computador remoto ou uma mensagem de erro, no caso de a comunicação não ter sido possível.

A boa notícia é que o Visual Studio .NET (e outros IDEs, como o Delphi) consegue tratar todo esse trâmite para você.

Em qualquer linguagem da plataforma .NET, você pode adicionar ao seu projeto uma referência ao WebService, do mesmo jeito que você faz quando adiciona um ActiveX (COM). Na versão que eu tenho do Visual Studio (Team System 2008), esta opção está no menu Project e chama-se Add Service Reference mas em algumas versões pode estar como Add Web Reference. Ao selecionar esta opção, o Visual Studio vai abrir um diálogo para você informar a URL onde o web service está publicado. No caso da Nota Eletrônica, há um Web Service para cada tipo de operação - enviar a Nota, verificar o status da Nota Enviada, Cancelar uma Nota, contingência, etc.

Ao dar OK nesse diálogo, o Visual Studio lerá o WSDL contido na URL e gerará algumas classes para você poder fazer as chamadas remotas. A maioria das classes geradas é usada internamente apenas para tratar o protocolo de envio e recebimento do Web Service - aí incluindo as tags para o protocolo SOAP.

Do ponto de vista de quem está programando, basta criar uma instância da classe principal para a operação (por exemplo, NfeRecepcao) e fazer chamadas às funções internas dela. A impressão é que funções locais estão sendo chamadas mas, na realidade, a plataforma .NET cuidará de moldar o nome da função e os valores de seus parâmetros no formato XML correto, acionará o protocolo IP para a chamada remota e aguardará até que o computador remoto execute a função. O retorno produzido, que também é um XML, será desempacotado automaticamente e o valor da função calculada remotamente será devolvido pela função local de modo que o seu programa não sabe que a execução foi feita em outro computador.

Mais Informações
Especificação do SOAP no W3C, Estrutura do WSDL