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:


api-rest-oobj

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



Comentários

35 respostas para “API REST: tudo sobre emissão fiscal via API”

  1. Avatar de DIEGO Souza
    DIEGO Souza

    Gostaria de maiores informações

    1. Avatar de Daniele Lima
      Daniele Lima

      Bom dia. Vamos entrar em contato por e-mail.

  2. Gostaria de mais informações.

    1. Avatar de Daniele Lima
      Daniele Lima

      Bom dia Marcelo, vamos entrar em contato com você por e-mail.

  3. Avatar de Gesimiel de Oliveira
    Gesimiel de Oliveira

    Entre em contato comigo, 69 9 81165010

    1. Avatar de Daniele Lima
      Daniele Lima

      Bom dia, entraremos em contato!

  4. gostaria de mais infos da api e precificação. Obg

    1. Avatar de Daniele Lima
      Daniele Lima

      Boa tarde, Davi.

      Vamos entrar em contato.

  5. Gostaria de mais informações

    1. Avatar de Daniele Lima

      Boa tarde, Victor. Iremos entrar em contato com você por e-mail.

  6. Solicito informações para integração da API com sistema próprio.
    Obrigado

    1. Avatar de Daniele Lima

      Olá, João. Entraremos em contato com você por e-mail.

  7. Quero mais informações para definir qual API iremos contratar

    1. Avatar de Daniele Lima

      Olá, Bruno. Entraremos em contato com você por email!

  8. Gostaríamos de mais informações

    1. Avatar de Daniele Lima
      Daniele Lima

      Olá, Orleans! Entraremos em contato!

  9. Posso usar como linguagem o Visual Basic 6 ?

    1. Avatar de Daniele Lima
      Daniele Lima

      Olá, Orlando. Você pode usar qualquer linguagem para fazer a comunicação com a nossa API. Desde que ela faça comunicação HTTP / HTTPs, é possível integrar com essa API

  10. Avatar de DAYSE MARINA DE CASTRO RODOLFO
    DAYSE MARINA DE CASTRO RODOLFO

    Gostaria de tirar dúvidas

    1. Avatar de Daniele Lima
      Daniele Lima

      Olá, Deise, vamos entrar em contato com você por e-mail!

  11. Avatar de Marcello Oliveira
    Marcello Oliveira

    Olá, preenchi o formulário de contato há cerca de 3 semanas mas ainda não tive retorno. Gostaria de mais informações sobre a API para emissão de NFCe.

    1. Avatar de Daniele Lima

      Olá, Marcello. Desculpe por não ter tido retorno, deve ter ocorrido alguma erro no nosso formulário 🙁 Passei o seu contato para a nossa equipe de consultores e eles irão entrar em contato com você.

  12. Boa tarde,

    Tenho um sistema com módulo de gestão de estoque, os funcionários muitas vezes têm preguiça de digitar todos os detalhes dos produtos ao cadastrar o produto no estoque.

    Nesse cenário, pensei em integrar o sistema à uma API em que eu forneço o número da nota fiscal e ela me retorna as informações dos produtos daquela nota para que o meu sistema já possa pré cadastrar as informações da compra e o funcionário possa apenas confirmar e cadastrar.

    Vocês fornecem esse serviço? podem me dar mais detalhes por favor?

    1. Avatar de Daniele Lima

      Boa tarde, Guilherme.

      A Oobj não possui esse serviço. Nós cuidamos apenas da mensageria de notas fiscais (emissão, recebimento e armazenamento), fazendo uma ponte da sefaz com a software house parceira e seus clientes. Se tiver interesse nessa parte, nesse link damos vários detalhes: https://www.oobj.com.br/pages/parceiros/

  13. Avatar de Paula Horn Peixoto
    Paula Horn Peixoto

    Oi Daniela.
    A Oobj possui alguma api que de impressão de DANFE, DACTE, DAMDFE, etc?

    Atenciosamente,

    Paula Peixoto

    1. Avatar de Daniele Lima

      Olá, Paula. Nós temos sim. Vou passar o seu contato para um de nossos consultores falarem com você por e-mail! Obrigada

  14. Por favor, fico no aguardo.

  15. Ola Gostaria de Mais Informações.

  16. Olá bom dia. Achei interessante, por favor entrar em contato.

    1. Avatar de Daniele Lima

      Olá, Elerton. Nossos consultores irão falar com você

  17. Boa tarde!

    Por favor gostaria mais informações. Se possível enviar um telefone para contato.

    1. Avatar de Daniele Lima

      Olá, Michelle. Iremos entrar em contato com você!

  18. Avatar de Antônio Arleudo da Costa
    Antônio Arleudo da Costa

    Olá, bom dia, podem entrar em contato comigo por favor, estou interessado.

    1. Avatar de Daniele Lima

      Olá, Antonio. Nossos consultores vão entrar em contato com você!

  19. Avatar de Adriano Marques
    Adriano Marques

    Gostaria de mais informações.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *