API Notas fiscais de serviços tomados - Ambiente Nacional 

O que é a API? 

API - Notas fiscais de serviços tomados automatiza a importação das NFSe com eficiência para seu ERP. Receba automaticamente os documentos fiscais emitidos contra os seus CNPJ's, de forma segura e completa independente do envio do arquivo XML pelo Fornecedor. Integre, consulte, baixe e gerencie suas Notas Fiscais de Serviços (NFS-e) de forma automática. 

O que é a NFS-e Nacional? 

Segundo o próprio site GOV.BR:

"A Nota Fiscal de Serviços Eletrônica (NFS-e) é um documento de existência digital, gerado e armazenado eletronicamente em Ambiente Nacional pela RFB para documentar as operações de prestação de serviços.

O projeto visa o benefício para os contribuintes e administrações tributárias padronizando e melhorando a qualidade das informações, racionalizando os custos e gerando maior eficácia, bem como o aumento da competitividade das empresas brasileiras pela racionalização das obrigações acessórias (redução do custo-Brasil), em especial a dispensa da emissão e guarda de documentos em papel, como também reduzindo a burocracia."

Por que a Receita Federal criou um padrão nacional? 

A ideia surgiu a partir da necessidade de integrar todos os sistemas municipais ao governo federal, já que cada um dos 5.570 municípios possui o seu próprio modelo para a emissão — algumas cidades, inclusive, ainda emitem no papel. Isso quer dizer que ainda há muita ineficiência e muitos custos adicionais. Sendo assim, a NFSe Nacional busca padronizar o layout e também a forma de emissão desse documento tão importante, tornando o processo mais simples e prático para todos os envolvidos. 

Quais os benefícios da NFSe Nacional? 

Há vários benefícios para todos os agentes envolvidos nesse processo.

Para os prestadores de serviços, a emissão ficou mais simples, pois é feita em um único sistema — reduzindo custos, burocracia e melhorando a gestão financeira com informações completas sobre as receitas.

Já para os tomadores de serviços há mais facilidade para acessar as notas e melhorias nas auditorias internas.

As prefeituras se beneficiam com a redução da burocracia e até aumento da arrecadação com informações completas e unificadas.

Até a sociedade se beneficia, pois o sistema pode auxiliar na redução da sonegação, dificultando vários tipos de fraudes, como a emissão de notas fiscais frias, e também verão melhoria da transparência fiscal.

Consulte os municípios aderentes 

Diferenciais da API 

• Suporte técnico via Whatsapp

• Consulta realizada em tempo real na fonte pública oficial.

• Acesso seguro via https em servidor Oracle Cloud Brasil, com alta performance e baixa latência. Seguro e criptografado, atendendo as boas práticas de segurança da informação de acordo com a legislação vigente.

• Painel de controle web para configurações, consultas, download de XML e acompanhamento das integrações via API

• API amigável e flexível para integração com qualquer linguagem de programação via WebService.

Benefícios da API 

• Otimize tempo da área fiscal e financeira

• Reduza custos e esqueça protestos por serviços pontuais

• Redução de riscos junto ao Fisco

• Aperfeiçoamento e automação dos processos da área fiscal

• Redução de custos operacionais

• A integração poderá ser realizada utilizando os protocolos REST com retorno no formato JSON.

• Alta disponibilidade e escalabilidade com garantia de baixa latência na hospedagem Oracle Cloud Brasil.

Como utilizar? 

1 - Cadastre-se grátis para avaliação

2 - Configure o certificado digital da sua empresa. Requerido pela Sefaz para o acesso ao ambiente NFE. O que é certificado A1? Para que ele serve? O certificado tipo A1 é um arquivo eletrônico instalado diretamente no computador do interessado, que se enquadra no grupo de certificações de assinatura digital, e é válido por 1 ano. E para que serve o certificado digital tipo A1? Ele possui diversas finalidades, entre as quais acessar ambientes virtuais de forma segura; Validar operações online que demandam essa identificação;

3. Consulta integração e notas via portal web : 

Uso da API 

Chamada 1 ) Webservice para consulta do último NSU integrado via API https://g120c7c9d7b60c3-mnt.adb.sa-vinhedo-1.oraclecloudapps.com/ords/wksp_mnt/nfse/nfse_ult_nsu_integrado através de requisição HTTPS com método GET e parâmetros de entrada enviados na url  - query string (URL) . Ao contrário dos demais parâmetros, o TOKEN deve ser enviado no cabeçalho Authorization - padrão de autenticação do tipo Bearer token.

O que é NSU? 

O Número Sequencial Único (NSU) é de um código numérico gerado pela Sefaz (Secretaria da Fazenda) para distinguir e identificar um tipo de Nota Fiscal eletrônica, uma Carta de Correção eletrônica, um Evento da NF-e ou até mesmo um conjunto destes documentos.

Em outras palavras, esse número existe para identificar um evento no ambiente dos documentos fiscais eletrônicos que referenciam um CNPJ.

Vale dizer que, o processo de distribuição de documentos fiscais eletrônicos pela Sefaz é efetuado por meio do NSU.

Exemplo de chamada da API utilizando a ferramenta cUrl 

cUrl é uma ferramenta para transferir dados de/para um servidor, usando um dos protocolos suportados, por exemplo o HTTPS. A integração da API com seu sistema ERP é feita de forma semelhante. 

Chamada 2 ) Webservice para consulta da Nota fiscal com base no NSU desejado via API https://g120c7c9d7b60c3-mnt.adb.sa-vinhedo-1.oraclecloudapps.com/ords/wksp_mnt/nfse/nfse_nsu através de requisição HTTPS com método GET e parâmetros de entrada enviados no cabeçalho da requisição.  

Chamada 2 ) Webservice para consulta da Nota fiscal com base no NSU desejado via API https://g120c7c9d7b60c3-mnt.adb.sa-vinhedo-1.oraclecloudapps.com/ords/wksp_mnt/nfse/nfse_nsu através de requisição HTTPS com método GET e parâmetros de entrada enviados na url  - query string (URL). Ao contrário dos demais parâmetros, o TOKEN deve ser enviado no cabeçalho Authorization - padrão de autenticação do tipo Bearer token.