- MCP e agentes de IA
- Emissão de NF-e pelo agente
MCP e agentes de IA
Emissão de NF-e pelo agente
Fluxo recomendado, ferramentas de NF-e e exemplos de pedidos para o agente.
Com o MCP conectado, você pede a nota em linguagem natural e o agente chama as ferramentas da Treeunfe. Por baixo, elas usam as mesmas rotas da API de NF-e.
Fluxo recomendado
Confira se a empresa está pronta
get_nfe_checklist verifica certificado, configurações de série e numeração e regras fiscais.
Minha empresa está pronta para emitir NF-e?
Garanta a regra fiscal do NCM
A emissão calcula os tributos pela regra fiscal que cobre o NCM do item.
Existe regra fiscal para o NCM 85176241 em venda para GO?
Peça a nota
Informe destinatário, itens e operação. O agente preenche o emitente com os dados da empresa e deixa a Treeunfe calcular os tributos (calculateTaxes: true).
Emita uma NF-e de venda para o cliente 11222333000181, com 2 unidades
do produto PROD-001 a R$ 500,00 cada, sem frete. Antes de enviar,
me mostre destinatário, itens, CFOP e total para eu confirmar.
Confira o resultado
Depois de emitir, o agente consulta a nota com get_nfe e, se ela foi autorizada, busca o DANFE com get_nfe_danfe_url.
A nota foi autorizada? Me passe a chave de acesso e o link do DANFE.
Peça sempre para o agente mostrar os dados antes de emitir. Em homologação, use uma série e um número novos para evitar rejeição por duplicidade.
Ferramentas de NF-e
| Ferramenta | O que faz | Rota da API |
|---|---|---|
get_nfe_checklist | Verifica se a empresa está pronta para emitir. | Checklist de NF-e |
emit_nfe | Emite uma NF-e modelo 55. | Emitir NF-e |
list_nfe | Lista as NF-e da empresa. | Listar NF-e |
get_nfe | Consulta uma NF-e e a situação dela. | Buscar NF-e |
get_nfe_items | Lista os itens com os tributos calculados. | Itens da NF-e |
get_nfe_xml | Retorna o XML da nota. | XML da NF-e |
get_nfe_danfe_url | Retorna o link do DANFE de uma nota autorizada. | |
cancel_nfe | Cancela uma NF-e autorizada. | Cancelar NF-e |
create_nfe_cce | Registra uma carta de correção. | Emitir CC-e |
list_nfe_cce | Lista as cartas de correção da nota. | Consultar CC-e |
create_nfe_inutilization | Inutiliza uma faixa de numeração. | |
list_nfe_inutilizations | Lista as inutilizações. |
Ferramentas de apoio
O agente também acessa os dados que a emissão usa:
| Grupo | Ferramentas |
|---|---|
| Empresa e configurações | get_current_organization, get_settings_nfe, update_settings_nfe |
| Regras fiscais | list_tax_rules, list_default_tax_rules, get_tax_rule, create_tax_rule, update_tax_rule, delete_tax_rule |
| Clientes | list_customers, get_customer, create_customer, update_customer, delete_customer |
| Produtos | list_products, get_product, create_product, update_product, delete_product |
| Transportadoras | list_carriers, get_carrier, create_carrier, update_carrier, delete_carrier |
| Certificado | get_current_certificate, upload_certificate, delete_certificate |
| Consulta de CNPJ | lookup_cnpj_rfb |
| Webhooks | list_webhooks, get_webhook, create_webhook, update_webhook, delete_webhook |
Eventos
Cancele a NF-e 006f917a-21a5-491d-90b4-f745d96385e7.
Justificativa: valor incorreto informado na nota.
Registre uma carta de correção na última NF-e emitida: o endereço
de entrega correto é Rua das Flores, 100.
Inutilize os números 15 a 20 da série 1. Justificativa: falha no sistema
que pulou a numeração.
As regras são as mesmas da API: justificativa de 15 a 255 caracteres no cancelamento e na inutilização, e correção de 15 a 1000 caracteres na CC-e. Veja Eventos de NF-e.
Cancelamento, CC-e e inutilização são enviados à SEFAZ e não dão para desfazer. Confirme o ID da nota e o texto antes de autorizar o agente.
Consultas úteis
Liste as NF-e emitidas hoje, com número, destinatário, valor e situação.
Por que a última NF-e foi rejeitada? Mostre o motivo e o que corrigir.
Mostre os tributos calculados em cada item da NF-e 006f917a-21a5-491d-90b4-f745d96385e7.