How to consume EFD-Reinf Webservice in C#? (Sending Events)

Question

I am initiating the EFD-Reinf Information Submission Tests in C#.
By Visual Studio, I added a Service Reference in my project with the URL:

https://preprodefdreinf.receita.fazenda.gov.br/wsreinf/RecepcaoLoteReinf.svc?singleWsdl

I have the digital certificate installed on my machine.
He requests permission to use the key:

It loads the available services, click OK and the service is available to me. I can instantiate, etc.

I ask, how should I proceed from there?

Because with other Webservices, like the Post Office, I did this way: instantiated, passed the parameters and WS returned me with the answer, and with the EFD-Reinf I do not know how to pass such parameters.

For those who have already developed, this is the best way to send the events of EFD-Reinf?

Answer 1

The main code to access the EFD-Reinf Webservice is this:

using System.Net;
using System.ServiceModel;
using System.Security.Cryptography.X509Certificates;
using System.Xml.Linq;

public void EnviarLoteReinf()
{
   // Carrega o certificado digital a partir de um arquivo PFX, informando a senha.
   X509Certificate2 x509Cert = new X509Certificate2(caminhoArquivoPfx, senhaArquivoPfx);
   // Carrega o XML de lote a partir de um arquivo.
   // Mas os XMLs dos eventos devem ser assinados digitalmente antes de inseridos no XML de lote.
   // Para isso é possível usar a função SignXmlDoc() disponível na resposta abaixo:
   // /a/277476/
   XDocument loteEventosXDoc = XDocument.Load(caminhoArquivoXml);

   var urlServicoEnvio = @"https://preprodefdreinf.receita.fazenda.gov.br/wsreinf/RecepcaoLoteReinf.svc";
   var address = new EndpointAddress(urlServicoEnvio);
   // BasicHttpsBinding está disponível somente a partir do .NET Framework 4.5.
   // Se estiver usando uma versão anterior, use a linha comentada abaixo.
   //var binding = new BasicHttpBinding(BasicHttpsSecurityMode.Transport);
   var binding = new BasicHttpsBinding();

   // Informa que será usado um certificado digital para acessar o serviço.
   binding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Certificate;

   // Veja essa pergunta para mais detalhes:
   // /q/318351/
   ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls;

   // Cria o objeto cliente (do tipo System.ServiceModel.ClientBase) para acesso ao WebService.
   var wsClient = new ServiceReference2.RecepcaoLoteReinfClient(binding, address);
   // Passa o certificado digital para o objeto do tipo System.ServiceModel.ClientBase.
   wsClient.ClientCredentials.ClientCertificate.Certificate = x509Cert;

   // Veja: https://stackoverflow.com/a/49303859/
   wsClient.Open();
   // Chama o WebService de fato, passando o XML do lote.
   // O método espera um objeto do tipo XElement, e retorna outro objeto XElement.
   var retornoEnvioXElement = wsClient.ReceberLoteEventos(loteEventosXDoc.Root);
   wsClient.Close();
}

---

Some important points (and others not so much) that are partially commented on in the code, or are related:

• The XML that will be sent to the service is a batch file that will contain one or more EFD-Reinf events. These event Xmls must be signed individually before they are inserted into the lot. reply there is an example of function to sign XML using digital certificate;
• The class System.ServiceModel.BasicHttpsBinding is only available from . NET Framework 4.5, if you are using a previous version, use the class BasicHttpBinding;
• For more details about the line ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls, see that question;
• For interesting information on System.ServiceModel.ClientBase.Open() see that answer;
• If you want to see an example of handling exceptions returned by a WCF Webservice, see that answer.

---

Here are some useful links to work with EFD-Reinf:

• Readouts EFD-Reinf;
• XSD schemes;
• Guide to the Developer.