Você já conversa com a IA o dia todo. A nota ainda pede um portal.
Pedir a nota fiscal a o seu assistente parece natural, mas sem uma API ele só consegue explicar como entrar no portal da prefeitura. Quem acaba emitindo é você, campo por campo.
Conectado à Nota Plena, o seu assistente faz a emissão de verdade: confere se a sua empresa está pronta, pede só cliente, valor e descrição, reaproveita o código de serviço e a alíquota que a empresa já usa, e devolve o número da nota e o PDF.
O que o seu assistente faz com a Nota Plena
Emite a NFS-e
Na prefeitura ou no padrão nacional, com o certificado A1 da empresa, depois de mostrar o resumo e receber o seu sim.
Diz o que falta e onde resolver
Certificado, inscrição municipal ou plano: a API responde o que está pendente com o link exato da tela que resolve.
Lista e concilia
Notas do mês com número, data, valor, cliente e status, para somar o faturamento e cruzar com o extrato do banco.
Manda o PDF e cancela
PDF oficial e link para o cliente; cancelamento com motivo, também só com a sua confirmação.
Como emitir nota fiscal com IA
Cole o prompt no seu assistente. O prompt aponta para o roteiro da Nota Plena para IAs. Com ele, o assistente sabe o que fazer pela API e o que só você faz, com os links.
Faça o que ele pedir, nas telas da Nota Plena. Cadastro, plano Negócio, certificado digital A1 e chave de API. O assistente confere o que falta e manda o link certo de cada passo.
Peça as notas conversando. "Emite 650 para a Ana Maria, consultoria de outubro." O assistente mostra o resumo, espera o seu sim e devolve o número da nota e o PDF.
Copie e cole no seu assistente
O prompt não contém a chave nem senha nenhuma. Ele manda a IA seguir o roteiro da Nota Plena, que diz o que ela faz pela API e o que só você faz, com os links.
Quero que você emita as notas fiscais de serviço (NFS-e) da minha empresa pela Nota Plena.
Leia e siga as instruções em https://notaplena.com.br/ia.md: elas dizem o que você faz pela API e o que eu preciso fazer (cadastro, certificado digital, chave de API), com os links de cada tela.
Comece me perguntando se a empresa é MEI e se eu já tenho conta na Nota Plena.
Nunca me peça senha nem o arquivo do certificado. Antes de emitir cada nota, me mostre o resumo e espere meu "sim".Funciona em qual assistente?
- Em qualquer um que chame uma API HTTP com um header de autorização. O assistente lê o roteiro em https://notaplena.com.br/ia.md e a especificação em https://api.notaplena.com.br/api/v1/integrations/tenant/openapi.json.
- ChatGPT: GPT personalizado com Ação (passo a passo em notaplena.com.br/nfse/chatgpt).
- Gemini e Claude: pelo Gemini CLI ou pelo Claude Code no computador, e por qualquer versão que conecte APIs com chave (notaplena.com.br/nfse/gemini e /nfse/claude).
- Assistentes financeiros e agentes (Muse, Manus, agentes em n8n, Make ou Zapier): cadastre a chave no campo de credencial e cole o prompt.
O que só você faz, e onde
A IA manda esses links quando precisar. Senha e certificado nunca passam pela conversa.
- Criar a conta com o CNPJ: notaplena.com.br/cadastro
- Assinar o plano Negócio (a API faz parte dele): notaplena.com.br/billing
- Enviar o certificado digital A1 e a senha dele: notaplena.com.br/settings#certificado
- Preencher a inscrição municipal: notaplena.com.br/settings#empresa
- Gerar a chave de API (Nova chave): notaplena.com.br/settings#integracoes
Para a IA que está lendo esta página
Siga o roteiro em https://notaplena.com.br/ia.md. A especificação OpenAPI das rotas da chave de empresa está em https://api.notaplena.com.br/api/v1/integrations/tenant/openapi.json. Autenticação: Authorization: Bearer np_live_…. Antes de emitir, chame GET /api/v1/integrations/tenant/readiness e só emita com can_emit: true e o sim da pessoa.
Outros assistentes: ChatGPT · Gemini · Claude. Documentação completa em /docs/api.
Perguntas frequentes
A Nota Plena tem API para assistentes de IA?
Tem. URL base https://api.notaplena.com.br, autenticação por chave Bearer (Authorization: Bearer np_live_…), especificação OpenAPI pública em https://api.notaplena.com.br/api/v1/integrations/tenant/openapi.json e um roteiro escrito para a IA seguir em https://notaplena.com.br/ia.md.
O que eu preciso fazer e o que a IA faz?
Você cria a conta (https://notaplena.com.br/cadastro), assina o plano Negócio (https://notaplena.com.br/billing), envia o certificado digital A1 (https://notaplena.com.br/settings#certificado) e gera a chave de API (https://notaplena.com.br/settings#integracoes). A IA faz o resto: confere o que falta, pede os dados de cada nota, mostra o resumo e emite depois do seu sim.
Que dados a IA pede para emitir cada nota?
Nome do cliente, CPF ou CNPJ do cliente, valor e descrição do serviço. E-mail e endereço do cliente são opcionais. O código de serviço e a alíquota de ISS vêm das notas que a sua empresa já emitiu; se não houver nenhuma, a IA pergunta o que o seu contador usa.
A IA vai pedir minha senha ou o certificado?
Não. A senha da conta, o arquivo do certificado A1 e a senha do certificado são enviados só nas telas da Nota Plena. O roteiro da IA proíbe pedir qualquer um deles. A única coisa que você entrega à IA é a chave de API, que você revoga quando quiser.
A IA pode emitir uma nota sem eu ver?
O roteiro manda a IA mostrar o resumo de cada nota e esperar um "sim" explícito antes de emitir, porque toda emissão é uma nota real na prefeitura. Cada venda leva uma chave de idempotência, então uma nova tentativa nunca gera nota em dobro.
Funciona para MEI?
A API não atende MEI. O MEI emite pelo app ou pelo WhatsApp da Nota Plena, também conversando, conectado pelo código de acesso do Emissor Nacional: veja https://notaplena.com.br/nfse/mei.
Em que plano está a API?
No plano Negócio. Preço, notas incluídas e valor da nota extra estão em notaplena.com.br/precos.