Você já conversa com a IA o dia todo. A nota ainda pede um portal.
Pedir a nota fiscal a o Gemini 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 Gemini 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 Gemini 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 o Gemini
Escolha um Gemini que chame APIs. O caminho que funciona em qualquer conta é o Gemini CLI, no computador. Se a sua versão do Gemini conecta APIs com chave (extensões, agentes ou automações), ela também serve.
Guarde a chave fora da conversa. No Gemini CLI, a chave vai numa variável de ambiente (NOTA_PLENA_KEY). Em uma automação, no campo de credencial. A chave np_live_ é gerada em Configurações → Integrações.
Cole o prompt e converse. O Gemini lê o roteiro da Nota Plena, confere o que falta, pede os dados da nota, mostra o resumo e emite depois do seu sim.
Copie e cole no Gemini
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ê (Gemini) 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".Pelo Gemini CLI, em quatro passos
- Instale o Gemini CLI (instruções no repositório oficial do Google, google-gemini/gemini-cli) e entre com a sua conta Google.
- No terminal: export NOTA_PLENA_KEY="np_live_..." (a chave gerada em Configurações → Integrações).
- Rode gemini e cole o prompt acima, acrescentando: "a chave está na variável NOTA_PLENA_KEY".
- Peça: "o que falta para eu emitir?". O Gemini chama a API e manda o link de cada passo pendente.
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: qualquer IA · ChatGPT · Claude. Documentação completa em /docs/api.
Perguntas frequentes
Dá para emitir nota fiscal com o Gemini?
Dá, com um Gemini que consiga chamar uma API com chave: o Gemini CLI no computador ou uma automação. Ele segue o roteiro da Nota Plena, confere o cadastro e emite cada nota depois do seu sim.
E pelo app do Gemini ou por um Gem?
Se a sua versão do app não chama APIs externas com chave, ela consegue ler o roteiro e explicar o processo, mas não emitir. Para emitir, use o Gemini CLI ou uma automação com a chave guardada como credencial.
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.