Blog Oobj

API NFe: tudo sobre emissão fiscal via API

32
Tempo de leitura: 4 minutos

API NFe: conheça os benefícios, forma de emitir e recursos dessa integração



Emitir Nota Fiscal eletrônica não é algo muito simples. O governo está sempre mudando alguma coisa ou publicando uma norma técnica exigindo adaptações nos sistemas emissores. Até existem alguns componentes gratuitos, mas nem sempre eles atendem as necessidades de todos, além de não ter nenhum suporte.

A boa notícia é que se você precisa documentos fiscais eletrônicos e não quer ter dor de cabeça, uma das maneiras mais simples e mais rápidas é fazer isso via API REST. Independente da tecnologia que você utilize hoje (PHP,  Python, Ruby, Java, Delphi etc) tudo fica muito simples com essa integração.

Esse tipo de interação (API NFe REST) tem sido muito utilizada principalmente por pessoas que possuem sistemas Web e Mobile.


Bom, vamos ver a seguir como emitir NFe dessa forma e seus benefícios.



Benefícios da integração API REST para o seu software


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

Optando por esse tipo de integração, a implementação no seu software ocorre de forma muito rápida e simples. Isso porque a API REST se mostra compatível com várias linguagens de programação. Ou seja, a migração para a nuvem acontece de forma ágil e não deixa seus clientes desamparados. Por exemplo, aqui na Oobj, temos uma solução robusta de emissão e recebimento de notas fiscais pronta para ser integrada.


Custos

Programar um módulo fiscal desde o começo não é tarefa simples. Além disso, manter um já existente, atualizando as leis, garantindo alta performance também não é fácil. Em ambos cenários, muito tempo é gasto, consequentemente o investimento é alto.

Optar por uma integração via API REST é mais barato, mais seguro e mais estratégico. Isso é possível porque deixando a parte fiscal com 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.

Para exemplificar essa opção com uma situação real, conheça o case da SIACON.


Especialização em gestão fiscal

Relacionando os dois pontos que eu já citei acima, chegamos no benefício da atualização constante.

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 à todas as mudanças e melhorias da área. Assim, você não precisa se preocupar com essa parte!

Ficou interessado nessa integração? Aqui, na Oobj, temos diversos parceiros que utilizam essa solução. Se quiser saber mais, é só solicitar um contato com a gente para podermos conversar:


Bom, agora vamos falar sobre a parte estrutural, de como a emissão de NFe é feita via API REST:



Como emitir NFe via API REST?

Para realizar esse tipo de emissão (API NFe), basta você enviar os detalhes da sua venda para o endpoint disponibilizado pela API. Por segurança, é necessário realizar a autenticação antes. Veja neste artigo como autenticar na API REST.

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

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.

Veja 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.



Outros recursos Importantes da API 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. Não se trata daquele serviço de consulta disponibilidade do Portal Nacional. Estamos falando da disponibilidade em tempo real que permite inclusive saber a taxa de autorização de documentos por minuto.

Veja nesse artigo: 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 um pouco mais esse portal aqui: Monitor Oobj.


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



Dúvidas Comuns

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

Não. Não existe um padrão único. A API já suporta diversos layouts utilizados no mercado. É possível escolher o layout 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 NFe para sua empresa de software

Preencha o formulário e saiba como a Oobj atua na integração API NFe e como podemos contribuir para o crescimento da sua empresa de software🚀. Clique no link abaixo:


PREENCHER FORMULÁRIO


32 Comentários

  1. Gostaria de maiores informações

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

  2. Gostaria de mais informações.

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

  3. Entre em contato comigo, 69 9 81165010

    • Bom dia, entraremos em contato!

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

    • Boa tarde, Davi.

      Vamos entrar em contato.

  5. Gostaria de mais informações

    • 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

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

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

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

  8. Gostaríamos de mais informações

    • Olá, Orleans! Entraremos em contato!

  9. Posso usar como linguagem o Visual Basic 6 ?

    • 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. Gostaria de tirar dúvidas

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

  11. 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.

    • 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?

    • 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. Oi Daniela.
    A Oobj possui alguma api que de impressão de DANFE, DACTE, DAMDFE, etc?

    Atenciosamente,

    Paula Peixoto

    • 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.

    • 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.

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

Deixe uma resposta

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

Ir para o topo