Blog

IA e automação

IA para emitir nota fiscal: como funciona a NFS-e pedida a um assistente por MCP

Como pedir ao ChatGPT ou ao Claude para emitir uma NFS-e pelo MCP: o que precisa estar configurado, o que o servidor confere, quanto custa e como cortar o acesso.

Kallef Alexandre
Kallef Alexandre

Fundador do Comando1

6 min

Dá para usar IA para emitir nota fiscal de serviço: com o sistema emissor conectado ao assistente por MCP, você escreve "emite a nota da fatura de outubro da Clínica Vale do Ipê" e o assistente encontra a fatura, chama a ferramenta de emissão e devolve o número da NFS-e. Quem transmite a nota não é a IA — é o servidor do sistema, com a configuração fiscal da sua empresa.

A IA não substitui a configuração fiscal nem decide o que a nota diz por conta própria: a classificação do serviço e os impostos vêm do cadastro da empresa, e o texto vem da fatura. O que ela tira de você é o caminho entre telas. Antes de pedir a primeira nota, três coisas precisam estar prontas, e é bom saber o que o servidor protege e o que não protege.

Se você ainda não sabe o que é MCP, comece por O que é MCP e o que ele muda para uma empresa de serviços. Aqui o assunto é o fluxo concreto da nota.

O que precisa estar configurado antes de pedir a nota à IA?

O assistente usa a mesma emissão que a tela usa. Se a tela não emitiria, a IA também não. No Comando1, o servidor recusa a emissão quando falta qualquer um destes itens:

  1. Integração de NFS-e da empresa, com um dos dois métodos: o login do Emissor Nacional (CPF ou CNPJ e senha do portal NFS-e) ou o certificado digital A1 (arquivo .pfx e a senha dele).
  2. Código IBGE do município da empresa, na aba Emitente. Dá para buscar pelo CEP.
  3. Uma fatura para o serviço. A NFS-e sai de uma fatura; o assistente pode criar a fatura antes, se o seu acesso permitir.

Quem emite pelo portal precisa também do município no endereço do cliente. A tela de configuração mostra o que falta antes do primeiro clique, para a recusa não aparecer só na hora de emitir.

A NFS-e emitida segue o padrão nacional da nota de serviço, descrito no portal da NFS-e do governo federal.

O que acontece quando eu peço "emite a nota"?

Imagine a Sabiá Climatização, empresa fictícia que faz manutenção de ar-condicionado. A dona pede ao assistente: "emite a nota da fatura de outubro da Clínica Vale do Ipê". Por baixo, o caminho é este:

  1. Achar o cliente e a fatura. O assistente procura o cliente (customers_list) e lista as faturas dele (customers_list_invoices ou invoices_list). Se houver duas faturas de outubro, um bom assistente pergunta qual.
  2. Conferir se a nota já existe. Com nfse_list, filtrando pela fatura, ele vê se já há nota autorizada, em transmissão ou rejeitada.
  3. Pré-visualizar, se você pedir. A ferramenta de emissão aceita dry_run: o servidor MCP devolve o pedido que seria enviado — a fatura e o texto da discriminação —, sem transmitir nada. Não é uma prévia do documento fiscal; serve para conferir fatura e texto antes de emitir.
  4. Emitir. O assistente chama nfse_emit com o identificador da fatura e, se você quiser controlar o texto que vai à prefeitura, a discriminação do serviço (até 2.000 caracteres). Sem ela, o texto é o número da fatura seguido da descrição de cada item.
  5. Ler a resposta certa. A nota volta como autorizada, em transmissão ou rejeitada. Rejeitada significa que não existe nota, e o motivo vem junto — o assistente não deve dizer que emitiu.
  6. Entregar os arquivos. Com nfse_files, ele pega os links do XML autorizado e do DANFSe, válidos por 30 minutos. Se a nota ficou em transmissão, nfse_sync atualiza a situação.

Pedidos em lote funcionam do mesmo jeito: "quais faturas de setembro ainda não têm nota? emite as que faltam" vira uma lista e uma emissão por fatura.

A IA pede confirmação antes de emitir?

Aqui vale ser preciso, porque é o ponto que mais importa. No Comando1, o servidor trata emitir e cancelar de formas diferentes:

  • Cancelar nota (nfse_cancel) é ação destrutiva. O servidor recusa o pedido se ele não vier com confirmação explícita, e a ferramenta aparece marcada como destrutiva para o assistente.
  • Emitir nota (nfse_emit) é ação de escrita, sem essa trava. O servidor não exige confirmação para emitir. O que existe é a pré-visualização (dry_run), que o assistente só usa se for pedido.

Muitos assistentes mostram a chamada e pedem sua aprovação antes de executar uma ferramenta, mas isso é comportamento do assistente, configurado nele, não uma garantia do servidor. Por isso, para as primeiras notas, peça de forma explícita: "mostra antes o que você vai enviar e só emite quando eu disser". Nota autorizada não se edita; errou o texto, é cancelar e emitir de novo.

O que o servidor garante, independentemente do assistente:

  • Não há segunda nota para a mesma fatura. Se já existe nota autorizada ou em transmissão, a emissão é recusada e a resposta traz o número da existente. Uma nova tentativa depois de queda de rede não gera nota duplicada.
  • Acesso de leitura não emite. A emissão exige a permissão nfse:emitir, e um token sem ela nem enxerga a ferramenta na lista.
  • Sem saldo, nada é transmitido. A carteira pré-paga é checada antes de a nota sair.

Quem pode autorizar a IA a emitir notas?

A conexão usa OAuth 2.1: você cola https://api.comando.one/mcp no assistente, uma tela do Comando1 abre no navegador e você escolhe a empresa e o perfil de acesso. O teto é o seu papel na empresa: um visualizador que pede "acesso total" sai com permissões de leitura, e o corte é feito no servidor. Operador e administrador podem conceder emissão.

Funciona com Claude (Desktop, claude.ai e Claude Code), ChatGPT (modo desenvolvedor, planos pagos), Gemini CLI, Cursor e VS Code. Há empresas que oferecem emissão de nota por MCP como integradoras, para quem já tem outro sistema; a diferença de emitir de dentro do ERP é que a nota sai da fatura, do cliente e da conciliação que já estão lá.

Quanto custa emitir NFS-e pela IA?

O mesmo que pela tela: R$ 0,99 por nota autorizada, segundo a tabela de preços. O servidor MCP vem incluso sem custo, junto com a API e o SDK. O uso do assistente — ChatGPT, Claude, Gemini — fica no plano que você já tem com ele.

Quais são os limites da IA fiscal?

  • Ela não escolhe a tributação. Código de serviço, alíquotas e regime vêm da configuração fiscal da empresa. Se o cadastro está errado, a nota sai errada pela IA e pela tela.
  • Ela depende do que você escreve. "A fatura da clínica" com três clínicas na base vira uma pergunta de volta, ou um engano se o assistente não perguntar. Nome do cliente e mês resolvem.
  • Ela não resolve indisponibilidade do emissor. Se o provedor fiscal falha, a resposta traz o motivo dele, e a nota não existe até ser emitida de novo.

Como cortar o acesso da IA?

Em Assistentes conectados, nas configurações, cada assistente aparece com a empresa, a conta que autorizou, a data e o último uso. O administrador revoga, e isso corta o acesso na hora, sem trocar senha; o assistente precisa pedir autorização de novo. Se quiser manter o assistente só para consultas, revogue e autorize outra vez com o perfil de leitura.

Para conectar o seu assistente e ver as perguntas frequentes sobre segurança, veja Conectar IA.

Criar conta grátis

Perguntas frequentes

A IA consegue emitir nota fiscal sozinha?
Consegue, se o sistema de emissão estiver conectado a ela por MCP e o acesso que você autorizou incluir emissão. No Comando1, o assistente localiza a fatura e chama a ferramenta nfse_emit; quem transmite a nota é o servidor, com a configuração fiscal da sua empresa.
O que preciso configurar antes de pedir a nota para a IA?
A integração de NFS-e da empresa, com um dos dois métodos — login do Emissor Nacional (CPF ou CNPJ e senha do portal) ou certificado digital A1 com a senha — e o código IBGE do município da empresa. Sem isso, o servidor recusa a emissão, venha o pedido da tela ou da IA.
Quanto custa emitir NFS-e pela IA no Comando1?
O mesmo que pela tela, R$ 0,99 por nota autorizada. O servidor MCP não é cobrado; o uso do assistente fica no plano que você tem com ele.
A IA pode emitir a mesma nota duas vezes?
Para a mesma fatura, não. Se já existe nota autorizada ou em transmissão, o servidor recusa a segunda e devolve o número da que existe. Para emitir outra, é preciso cancelar a anterior.
Como tiro o acesso da IA à emissão de notas?
Em Assistentes conectados, revogando a autorização. O acesso é cortado na hora e o assistente precisa pedir autorização de novo.

Fontes

No Comando1Conectar ChatGPT, Claude ou Gemini ao ERP

Leia também

Comece hoje mesmo

Sua empresa no comando

Junte-se às empresas que já gerenciam seu negócio de forma inteligente com o Comando1.

Sem cartão de crédito · Dados seguros · Suporte em português