API REST: tudo sobre emissão fiscal via API

API REST é um termo que vem se tornando cada vez mais comum quando falamos sobre a migração de softwares para a nuvem, mas muita gente ainda tem dúvida de como integrar e utilizar essa API para emitir NFe. 

Preparamos esse artigo com tudo o que você precisa saber sobre a forma de emitir NFe com a integração e seus benefícios. Confira:

O que é API REST? 

API REST ou API RESTful é uma interface de programação de aplicações que está em conformidade com as restrições do estilo de arquitetura REST, permitindo a interação com serviços web RESTful. 

Ela é uma interface padrão, o que significa que a maioria das linguagens de programação possui bibliotecas e ferramentas para trabalhar com APIs REST.

Como funciona a API REST?

A API REST funciona como um canal de comunicação entre dois sistemas, permitindo que eles troquem informações de forma eficiente, automatizada e segura. 

Como funciona a API REST para emissão de NFe?

Emitir uma Nota Fiscal eletrônica pode ser complicado devido às constantes mudanças do governo, mas é possível fazer essa emissão de forma simples e rápida  via API REST.

A API REST para emissão de NFe permite a integração de sistemas para emissão e gerenciamento de NFe, independente da tecnologia que você utilize hoje (PHP,  Python, Ruby, Java, Delphi etc). 

A solução fornece métodos HTTP (como GET, POST, PUT e DELETE) para acessar e manipular recursos relacionados à NFe, como consulta de informações, geração de NFe, cancelamento,  entre outros. 

Já as requisições são feitas através de URLs que identificam os recursos desejados, e os dados são transmitidos em formato JSON ou XML.

Assim, toda vez que uma venda for realizada, o sistema envia uma mensagem através da API REST com as informações da venda para a Sefaz, que emite automaticamente a NFe e retorna a confirmação para o seu sistema.

Quais são os benefícios da integração API REST para o seu software?

Esse tipo de interação (API NFe REST) tem sido muito utilizada, principalmente por pessoas que possuem sistemas Web e Mobile. Abaixo você confere os principais benefícios da API REST:

Solução pronta de fácil implementação

Ao optar pela API REST, a implementação no seu software é simples e rápida, já que a solução é compatível com várias linguagens de programação, possibilitando a migração para a nuvem sem desamparar os clientes.

Redução de Custos

Criar um módulo fiscal do zero ou atualizar um que já existe é difícil,  consome muito tempo e dinheiro. 

Por outro lado, optar por uma integração  de API REST é mais barato, seguro e estratégico. Ao deixar a parte fiscal nas mãos de especialistas, você tem menos custos com a equipe, garante uma solução com qualidade elevada e ganha mais tempo para trabalhar na parte estratégica do negócio.

👉 Como a SIACON reduziu em 40% o custo de Suporte usando API Fiscal da Oobj

Especialização em gestão fiscal

A emissão de notas fiscais eletrônicas vem acompanhada de complexidades. A mudança constante na legislação, notas técnicas, atualização de versão do documento fiscal são alguns exemplos. E tudo isso custa caro: tempo e dinheiro.

Com uma solução API REST integrada ao seu software, a parte fiscal fica responsável por um sistema especialista, com uma equipe atenta a todas as mudanças e melhorias da área. Assim, você não precisa se preocupar com essa parte!

Agora que você já sabe sobre as funcionalidades, vamos entender a parte estrutural de como a emissão de NFe é feita via API REST:

Como emitir NFe via API REST?

Para realizar a emissão de NFe via API REST, basta enviar os detalhes da venda para o endpoint disponibilizado pela API. Por segurança, é necessário realizar a autenticação antes, mas, nesse artigo da nossa Base de Conhecimento você pode ver como autenticar na API REST.

Para emitir, a requisição é bem simples, confira o passo a passo abaixo: 

POST /api/empresas/{cnpj}/docs/{ambiente}/{codModelo}

Ex:

curl -X POST “http://rest-teste.oobj.com.br/api/empresas/07385111000102/docs/hom/55?layout=oobj” -H  “accept: */*” -H “x-auth-token: 9be58c65-7546-42e9-a5fb-f2bfe5ee0cb0” -H “Content-Type: application/xml” -d “{DETALHES_DA_VENDA}”

No corpo da requisição (body) você precisará inserir os detalhes da venda.

Para facilitar ainda mais, a API suporta diversos layouts. Você pode enviar os dados da venda no formato XML, TXT, JSON e diversos outros layouts. Ou seja, não é necessário criar conversões muito complexas para gerar um JSON.

Confira um exemplo com os dados da venda:

Dessa forma, a API vai receber essas informações, converter para o padrão definido pela Sefaz, assinar o XML com o certificado digital da empresa emitente, enviar para a Sefaz e pronto!

Assim que a nota fiscal é autorizada, você pode receber o XML PROC e o DANFE para impressão automática e até mesmo enviar automaticamente para o cliente.

Quais são os outros recursos importantes da API REST para NFe?

Aqui você confere uma série de recursos importantes sobre a API REST na hora de emitir a NFe: 

Emissão de Eventos

A API disponibiliza um endpoint para emitir todos os tipos de eventos: Cancelamento, Carta de Correção e até Manifestação do Destinatário.

Emissão de Inutilização

Através da API você também pode inutilizar as numerações que não foram utilizadas.

Consulta de status/disponibilidade da Sefaz

É possível consultar o status de cada Sefaz em tempo real. Mas vale lembrar que estamos falando da disponibilidade em tempo real que permite inclusive saber a taxa de autorização de documentos por minuto e não daquele serviço de consulta disponível do Portal Nacional.

👉 Leia mais: Como a Oobj utilizou uma tecnologia da Netflix para monitorar a saúde do serviço da Sefaz.

Ativação de Contingência

Caso haja alguma indisponibilidade ou lentidão é possível ativar a contingência para a empresa. A partir daí, a API automaticamente vai converter as notas fiscais para realizar a emissão em contingência.

Configuração do Certificado Digital

É possível configurar ou renovar o certificado digital (A1) através da API.

Consulta Cadastro de Contribuintes

Esse recurso da API é muito útil para empresas que precisam melhorar ou sanear o cadastro de clientes e possuem problema com nota fiscal denegada. Através da API NFe, você pode consultar a situação cadastral e outros dados da empresa a partir de um CNPJ antes de emitir o documento de fato.

Geração de Relatórios

Através da API você consegue obter diversos relatórios por período: notas emitidas, eventos, inutilizações e até notas fiscais recebidas.

Portal Whitelabel

Ao utilizar a API para emissão de nota fiscal eletrônica, você também tem a possibilidade de oferecer um portal web personalizado com o nome da sua empresa, domínio e logomarca. 

Nesse portal, seus clientes possuem acesso a dezenas de funcionalidades que são muito úteis no dia a dia. Conheça o portal clicando aqui.  

👉 Leia mais: Parceria – prós e contras da integração com Software Emissor

Dúvidas Frequentes sobre API REST para NFe

Aqui você confere um FAQ com as principais dúvidas sobre a integração:

Preciso adaptar meu sistema para gerar um JSON específico?

Não existe um padrão único. A API já suporta diversos layouts utilizados no mercado, por isso é  possível escolher o que seja mais simples para você.

Posso personalizar o DANFE?

Sim. Existe um layout padrão para o DANFE, mas se você preferir existe a possibilidade de configurar um modelo customizado.

Integração API REST para NFe na sua empresa de software

Quer ter uma solução de fácil implementação, reduzir custos, ter mais segurança e estratégia para o seu negócio? Fale com a gente e conheça a solução:

SOLICITAR UM CONTATO