ReceitaNet • API + Inteligência Artificial
Sua ideia.Conectada ao ReceitaNet.
A inteligência artificial que você escolhe. As ferramentas que sua empresa precisa. Uma API para conectar tudo isso à sua operação.
Liberdade para integrar, inovar e crescer.
Documentação disponível · Integrações com acesso autorizado.
Não indica uma conexão em tempo real.
Uma nova etapa para criar com o ReceitaNet.
Tecnologia que abre possibilidades para provedores, empresas e desenvolvedores.
A inteligência artificial ganha utilidade quando pode apoiar as rotinas reais de uma empresa. Com essa visão, o ReceitaNet apresenta sua API de integração, pensada para empresas, desenvolvedores e profissionais que desejam criar softwares, assistentes e automações conectados à gestão do provedor.
Com essa iniciativa, o ReceitaNet reforça seu compromisso com a inovação e abre espaço para que outras empresas desenvolvam soluções que gerem valor. Atendimento, financeiro e operação podem fazer parte desses projetos, conforme os recursos documentados e as permissões concedidas.
Sua empresa escolhe o que quer desenvolver, quem será o parceiro e qual tecnologia de IA deseja utilizar. A API oferece o caminho de integração com os recursos do ReceitaNet.
Você escolhe a IA.
A API faz a ponte.
Uma API é uma ponte de comunicação entre sistemas. Ela permite que uma aplicação consulte informações ou solicite ações ao ReceitaNet, seguindo regras de acesso.
Seu projeto pode utilizar um serviço comercial de IA, um modelo aberto ou uma solução própria, desde que implemente a comunicação com a API e respeite as condições de uso das tecnologias escolhidas.
Sua ideia
Escolha uma necessidade real: agilizar o atendimento, organizar a operação ou criar uma nova ferramenta.
Sua aplicação
O desenvolvedor combina a IA escolhida com as regras, validações e autorizações do seu projeto.
ReceitaNet
A API conecta a aplicação às consultas e às ações permitidas no sistema.
IA para desenvolver
Use a documentação para apoiar a criação do software, entender as integrações e preparar testes com dados fictícios. O código gerado precisa de revisão e validação.
IA para operar
Desenvolva assistentes que interpretem solicitações, consultem dados autorizados e apoiem a execução das rotinas previstas na integração.
Como isso se torna realidade: sua equipe ou um parceiro desenvolve a aplicação, conecta a IA e configura a integração. A publicação da API, por si só, não instala um assistente pronto.
Veja uma ideia
ganhar forma.
Os exemplos abaixo são possibilidades de desenvolvimento para sua equipe ou seus parceiros. Cada projeto precisa implementar sua própria lógica e seus controles.
Mais espaço para empresas e desenvolvedores crescerem.
Para o provedor, isso amplia a liberdade de criar ferramentas adequadas à sua operação. Para empresas de software, integradores e desenvolvedores, abre possibilidades de oferecer soluções conectadas aos recursos do ReceitaNet.
Da gestão ao atendimento.
Da ideia à integração.
A documentação reúne recursos de diferentes áreas do ReceitaNet. Veja alguns exemplos do que ela permite conectar:
Clientes e atendimento
Consultar dados cadastrais, contratos e informações de consumo; abrir chamados e registrar respostas e informações do atendimento.
Faturas e cobranças
Consultar faturas e cobranças, solicitar envio pelos canais previstos e registrar promessa de pagamento, conforme as regras do sistema.
Documentos fiscais
Consultar notas fiscais e obter arquivos PDF e XML quando disponíveis. Esses recursos tratam da consulta de documentos.
Ordens de serviço
Criar, consultar, agendar e cancelar ordens de serviço; consultar técnicos e equipes e registrar ocorrências.
Operação de rede
Consultar informações do acesso, ONU e elementos de rede; solicitar ações autorizadas, como reinicialização de equipamento.
Integração com a OLTNet
Consultar informações e sinal do cliente e solicitar sincronização quando a integração OLTNet estiver disponível na empresa.
Observe o alcance de cada recurso: algumas consultas usam dados cadastrados localmente, e uma solicitação de sincronização pode depender de processamento posterior. A documentação informa as condições de cada operação.
Consultar é uma coisa.
Agir é outra.
A documentação prevê um token principal, que identifica a integração, e um token delegado, que limita as funções que ela pode utilizar. Esses acessos são organizados por permissões específicas, chamadas de escopos.
Configure a autonomia com critério. Para ações que alterem o atendimento, a cobrança ou o serviço do cliente, implemente validações e defina quando será necessária a confirmação de uma pessoa autorizada.
As permissões da API são uma parte da proteção. A aplicação também precisa controlar quais informações serão exibidas a cada usuário e como os dados serão enviados à IA.
Inove com os dados.
Não com a confiança do cliente.
Uma integração pode acessar dados pessoais e informações importantes da operação. Conforme a função autorizada, isso pode incluir nome, CPF, telefone, endereço, contratos, faturas e registros de atendimento.
⚠️ Antes de liberar acesso, saiba quem receberá os dados, para qual finalidade e quais ações poderá executar. Uma credencial de API deve ser tratada como uma chave de acesso à sua operação.
A LGPD exige uma base legal aplicável ao tratamento e o respeito a princípios como finalidade, necessidade, transparência e segurança. A autorização técnica para acessar a API não substitui esses cuidados. 🔗 Consulte a LGPD, especialmente os arts. 6º, 7º e 46.
Antes de colocar uma integração em uso
-
Defina o objetivo e o responsável. Escolha parceiros confiáveis e formalize finalidade, responsabilidades e regras de tratamento dos dados.
-
Compartilhe apenas o necessário. Envie à aplicação e à IA somente os dados indispensáveis à tarefa. Confira as condições de armazenamento, retenção, compartilhamento e eventual uso para treinamento.
-
Proteja as credenciais. Guarde os tokens no ambiente protegido da aplicação. Evite incluí-los em conversas com IA, código público, páginas abertas ou grupos de mensagens.
-
Confirme quem está solicitando. A integração deve verificar a identidade do solicitante e sua autorização antes de revelar informações ou executar ações.
-
Acompanhe e revise os acessos. Mantenha registros das ações na solução desenvolvida, revise permissões e revogue credenciais que deixarem de ser necessárias.
Comece pequeno.
Construa com critério.
Escolha uma rotina que valha a pena melhorar. Transforme essa necessidade em um projeto, valide o resultado e só então amplie.
-
Escolha uma necessidade concreta. Comece por uma rotina, como consultar faturas durante o atendimento.
-
🔗 Consulte a documentação oficial. Confira os recursos, as permissões, os parâmetros e as respostas esperadas.
-
Defina a aplicação e a IA. Avalie o desenvolvedor responsável, os custos do projeto e as condições de uso e proteção dos dados.
-
Desenvolva e valide. Prepare testes com dados fictícios e execute as validações de integração em um ambiente controlado, com acessos restritos.
-
Amplie com acompanhamento. Comece com poucas funções, acompanhe o resultado e expanda as permissões somente quando houver necessidade.
O próximo passo está na documentação.
Acesse a documentação oficial da API ReceitaNet para desenvolvedores e integradores. A documentação descreve os recursos, os formatos de envio e retorno, a autenticação, as permissões e os limites de utilização.
Consulte o material técnico e planeje sua integração com o ReceitaNet.
🔗 Acessar documentação da APIPara desenvolvedores: um exemplo da estrutura
O trecho abaixo é uma referência didática de consulta. Os valores de credenciais são marcadores, não tokens reais.
GET /clientes/{idCliente}/faturas
token: SEU_TOKEN_PRINCIPAL
token-rota: SEU_TOKEN_DELEGADO
Escopo necessário: faturas.read
Na especificação enviada, o token principal e o token delegado devem pertencer à mesma integração. A exceção é GET /ping, que exige somente o token principal. As credenciais devem ficar no ambiente protegido da aplicação, nunca no HTML público.
Uma resposta de solicitação aceita nem sempre significa que a ação remota foi concluída. Confira na documentação o comportamento e as condições de cada operação.
Referência técnica deste artigo: especificação da API ReceitaNet versão 0.3.0, em OpenAPI 3.0.3, com 57 operações documentadas. O uso depende das permissões concedidas e das condições de cada recurso. 🔗 Consulte sempre a versão vigente da documentação.
Dúvidas, sem complicação.
A API já vem com uma inteligência artificial pronta?
Não. A API é o caminho de comunicação com o ReceitaNet. Sua equipe ou um parceiro precisa criar a aplicação, conectar a IA escolhida e implementar as regras de acesso e de funcionamento.
Sou obrigado a escolher uma IA específica?
O projeto pode utilizar um serviço comercial de IA, um modelo aberto ou uma solução própria. A escolha precisa ser compatível com a aplicação, com as condições de uso da tecnologia e com a proteção dos dados envolvidos.
Preciso ser programador para aproveitar essa possibilidade?
Você pode definir a necessidade e trabalhar com uma equipe técnica ou um parceiro de desenvolvimento. A documentação ajuda na integração, mas não substitui o desenvolvimento, os testes e a manutenção do projeto.
Posso liberar todas as permissões para facilitar?
O caminho recomendado é o contrário: liberar somente o que o projeto precisa, para pessoas e empresas avaliadas. Mesmo uma permissão de consulta pode revelar dados pessoais. Revise o acesso quando a finalidade mudar ou a parceria terminar.
✅ Pronto!
Você já conhece a proposta: mais liberdade para criar soluções com inteligência artificial conectadas ao ReceitaNet, com responsabilidade no uso dos dados. Escolha uma necessidade da sua operação e transforme essa ideia em um projeto de integração.