Como Fazer a Emissão de NFe API com Certificado A3

Novo Método Permite Emissão de NFe API com Certificado A3

Exatamente como você leu no título, no post de hoje vamos falar sobre como emitir na NS NFe API com certificado A3. Abaixo, preparamos um conteúdo explicativo sobre como utilizar esse recurso para atender seus clientes que ainda não migraram para o certificado A1. Confira! 

Como funciona?

Todo o processo de comunicação com a Sefaz, para emissão de Documentos Fiscais eletrônicos, necessita do certificado digital. Ele é utilizado para criação do canal seguro para o protocolo SSL/TLS, e para assinatura dos XMLs enviados para os web services. Após estudos e testes realizados pela nossa equipe de desenvolvimento, identificamos que a Sefaz permite que o certificado utilizado no processo de comunicação não seja necessariamente o do emitente, desde que seja um certificado válido. Todavia, os XMLs enviados devem ser assinados com o certificado do contribuinte.

Desta forma, agora é possível utilizar nossa API para emissão de DFe por contribuintes que possuem certificado A3. Para que isto ocorra, é necessário que o XML seja enviado já assinado para a nossa aplicação, e então utilizaremos um certificado modelo A1 (que atenda aos padrões e seja válido para este fim) para realizar a comunicação segura com a Sefaz.

Atualmente, apenas a API de NFe está liberada para trabalhar desta forma. Para poder utilizá-la com A3, você precisa solicitar a liberação do CNPJ para a nossa equipe. Isto pode ser feito junto ao nosso setor de Suporte Técnico.

O que muda?

A única mudança em relação ao processo de emissão normal com certificado A1 é que os documentos devem ser enviados sempre assinados para nossa aplicação, em todos os endpoints (emissão, cancelamento, carta de correção, etc). O retorno da API e os passos que devem ser seguidos são exatamente iguais, por isso você encontrará uma única documentação da API para cada projeto.

Como utilizar?

Criamos um vídeo explicando todo o processo de autorização de uma NFe via API com Certificado A3, e logo abaixo um passo a passo detalhado sobre como realizar a comunicação com a API.

Passo 1 – Gerar os dados

A primeira etapa a ser feita é a geração do conteúdo (de emissão, cancelamento, inutilização, etc). Entretanto, como é preciso enviá-lo assinado para a API, é necessário que ele esteja em formato XML, pois não é possível assinar em outro formato. Mas não se assuste! Se você não trabalha com XML, ou gera seus dados em JSON ou TXT, não é necessário mudar nada. Nossa API possui endpoints para conversão destes formatos para XML, para facilitar o seu trabalho. Dito isto, existem dois cenários:

• Se você já gera o XML, o primeiro passo está pronto e você pode seguir para a segunda etapa;
• Se você ainda não gera, é necessário converter seus dados para o formato adequado. Para isso, você pode utilizar o endpoint da nossa API, ou outro meio que você prefira.

Caso opte por utilizar a nossa API, confira a documentação de como consumir este recurso:

• Gerar XML na NS NFe API

Passo 2 – Assinar o XML

Após ter o conteúdo do XML, você deve realizar a assinatura eletrônica com o certificado digital do emitente. Por isso, é necessário que o certificado A3 esteja corretamente instalado e conectado na máquina. Ela é realizada diretamente do seu código-fonte, e por esta razão vai variar a forma como será feita, pois depende da sua linguagem de desenvolvimento. Em nossa documentação de Exemplos de Comunicação, disponibilizamos exemplos de assinatura em várias linguagens de programação. Caso não encontre na sua, entre em contato com nossa equipe para podermos lhe auxiliar de alguma maneira.

Passo 3 – Enviar para a API

Feitos os passos 1 e 2, o processo de comunicação com a API é exatamente igual ao procedimento feito com certificado A1. A única diferença é que você enviará o XML com as tags de assinatura, e informará o Content-Type da requisição como application/xml. Confira na documentação de emissão de cada API os dados que devem ser enviados para cada respectivo serviço.Queremos facilitar pra você…

Para tornar mais fácil o entendimento do processo, preparamos um vídeo com um fluxograma que contém o processo geral. Confira:

Quer saber mais detalhes? Clique aqui e entre em contato com a nossa equipe.

Gostou do Post? Caso você não conheça nossa API entre em contato conosco!