Combien d'outils expose br.com.brasilnfe/fiscal ?

br.com.brasilnfe/fiscal expose 34 outil(s). Le coût de contexte pour les charger tous est d'environ 71896 tokens (coût unique au chargement, pas par appel).

accueil / serveurs / Fichiers & Documents / br.com.brasilnfe/fiscal

br.com.brasilnfe/fiscal

serveur MCP (Model Context Protocol) · BrasilNFe MCP 1.0.0

▸ Fichiers & Documents

[ Non encore testé ]

Verdict MCP Hub
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.

streamable-httpType / transport

directAccès

~71896 tokensCoût de contexte

34Outils

Est-ce que br.com.brasilnfe/fiscal est sûr ?

Au dernier audit MCP Hub, le serveur MCP « br.com.brasilnfe/fiscal » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 34 outils

arquivo_baixar≈ 226 tokens
Baixa o arquivo (XML ou PDF/DANFE) de uma NF-e/NFC-e/NFS-e por chave de acesso. Retorna conteúdo em base64.
Paramètres, retour & exemple (5)
Paramètres
- Chaves · array|null · optionnel
- ChaveNF · string|null · optionnel
- FileType · integer · optionnel · 1 | 2
  Tipo do documento fiscal (Padrão 1 - XML) Valores: 1 - XML; 2 - DANFE
- Base64Logo · string|null · optionnel
- TipoDocumentoFiscal · integer · optionnel · 0 | 1
  Tipo do documento fiscal (Padrão 1 - Saída) Valores: 0 - Entrada; 1 - Saída
Exemple d'appel
```
{"name": "arquivo_baixar", "arguments": {"Chaves": [], "ChaveNF": "texte", "FileType": 1, "Base64Logo": "texte", "TipoDocumentoFiscal": 0}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
arquivo_baixar_evento≈ 250 tokens
Baixa o arquivo de um evento (CC-e, cancelamento, manifestação, encerramento) por chave de acesso + número sequencial. Retorna conteúdo em base64.
Paramètres, retour & exemple (3)
Paramètres
- ChaveNF · string|null · optionnel
  Chave de acesso da Nota Fiscal (44 dígitos) à qual o evento está vinculado.
- NuProtocolo · string|null · optionnel
  Número do protocolo do evento (somente dígitos). Identifica o evento específico (ex.: Carta de Correção, Cancelamento) registrado para a nota fiscal.
- TipoArquivo · integer · optionnel · 1 | 2
  Tipo do arquivo do evento a ser retornado. Valores: 1 - XML do evento; 2 - PDF da Carta de Correção (CC-e)
Exemple d'appel
```
{"name": "arquivo_baixar_evento", "arguments": {"ChaveNF": "texte", "NuProtocolo": "texte", "TipoArquivo": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
arquivo_baixar_periodo≈ 584 tokens
Exporta múltiplos arquivos (XML/PDF) de um período em um único ZIP base64. Útil para backup, contabilidade ou auditoria.
Paramètres, retour & exemple (11)
Paramètres
- Type · integer · optionnel · 0 | 1 | 2
  Tipo do documento fiscal (Padrão 1 - XML) Valores: 0 - PDF; 1 - XML; 2 - EXCEL
- DtFim · string · optionnel
  Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)
- Chaves · array|null · optionnel
  Chaves pagar pegar notas fiscal especificas
- DtInicio · string · optionnel
  Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)
- TipoNota · integer · optionnel · 1 | 2 | 3
  Tipo de ambiente (Padrão 1 - Saída) Valores: 1 - Saídas; 2 - Entradas; 3 - Saídas e Entradas
- cpfCnpjs · array|null · optionnel
  CPFs ou CNPJs dos clientes das notas
- Situacoes · array|null · optionnel
  Filtra por situação. Vazio = todas (comportamento padrão). Combinável.
- incluirCCe · boolean · optionnel
  Incluir carta de correção emitidas no periodo
- TipoAmbiente · integer · optionnel · 1 | 2
  Tipo de ambiente (Padrão 1 - Produção) Valores: 1 - Produção; 2 - Homologação
- JuntarArquivosPDF · boolean · optionnel
  Anexar todas as notas fiscais retornadas em um unico arquivo PDF
- aplicarPlanoAjustes · boolean · optionnel
  Aplicar plano de ajustes de impostos
Exemple d'appel
```
{"name": "arquivo_baixar_periodo", "arguments": {"Type": 0, "DtFim": "texte", "Chaves": [], "DtInicio": "texte", "TipoNota": 1, "cpfCnpjs": []}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Quantidade": 1, "Base64FilesCompacted": "texte"}}
```
cadastro_consultar≈ 1095 tokens
Consulta a Inscrição Estadual (IE) de um contribuinte na SEFAZ estadual (mundo NF-e/ICMS), por CNPJ/CPF/IE + UF. ATENÇÃO: muitas UFs NÃO oferecem este serviço (ex: RJ) e prestadores de serviço normalmente NÃO têm IE - nesses casos a IE não vem, e ISSO NÃO SIGNIFICA QUE O CNPJ ESTEJA INATIVO. Quando a SEFAZ não retorna e o documento é CNPJ, há fallback automático na Receita Federal (campo 'fonte'='receita') trazendo razão social, situação cadastral e endereço - sempre leia o campo 'mensagem'. Para apenas saber se um CNPJ está ativo ou pegar seus dados cadastrais (sem precisar da IE), prefira cliente_consultar.
Paramètres, retour & exemple (2)
Paramètres
- uf · string|null · optionnel
  UF do CPF, CNPJ, IE
- cpfCnpjIe · string|null · optionnel
Exemple d'appel
```
{"name": "cadastro_consultar", "arguments": {"uf": "texte", "cpfCnpjIe": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"ie": "texte", "fonte": "texte", "status": 0, "Contato": {}, "cpfCnpj": "texte", "ieAtual": "texte", "ieUnica": "texte", "Endereco": {}, "mensagem": "texte", "situacao": 1, "razaoSocial": "texte", "nomeFantasia": "texte"}}
```
cliente_consultar≈ 750 tokens
Pesquisa unificada de cliente/fornecedor. Tenta primeiro o cadastro local da empresa logada e, se nao achar e o termo for um CNPJ valido, consulta a BrasilAPI (Receita Federal) - razao social, endereco, situacao cadastral. E a tool CORRETA pra saber se um CNPJ esta ativo e pegar seus dados (razao social, endereco) - nao confunda com cadastro_consultar, que so traz Inscricao Estadual (IE) da SEFAZ. Use ANTES de pedir CNPJ ao usuario; geralmente o usuario informa nome ou apelido (ex: 'TNT', 'Correios'). Obs: consulta na Receita so funciona por CNPJ - CPF nao tem base publica. Para obter a Inscricao Estadual (operacao com ICMS), use cadastro_consultar. PAGINACAO: Limite default 10 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar.
Paramètres, retour & exemple (7)
Paramètres
- Uf · string|null · optionnel
- Termo · string|null · optionnel
- Fontes · array|null · optionnel
- Limite · integer|null · optionnel
- Offset · integer|null · optionnel
- TipoBusca · string|null · optionnel
- IncluirInativas · boolean · optionnel
Exemple d'appel
```
{"name": "cliente_consultar", "arguments": {"Uf": "texte", "Termo": "texte", "Fontes": [], "Limite": 1, "Offset": 1, "TipoBusca": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Avisos": [], "Limite": 1, "Offset": 1, "Matches": [], "TotalGeral": 1, "TotalLocal": 1, "TipoDetectado": "texte", "TermoNormalizado": "texte", "ConsultouBrasilApi": true}}
```
cliente_criar≈ 684 tokens
Cadastra um novo Cliente no sistema da empresa logada (CNPJ ou CPF, razao social, endereco, IE). Use depois de cliente_consultar quando o usuario confirmar que quer salvar o cadastro. Se ja existir cliente com mesmo CpfCnpj devolve erro com Id existente - use cliente_editar.
Paramètres, retour & exemple (10)
Paramètres
- Id · integer|null · optionnel
- Ie · string|null · optionnel
- Im · string|null · optionnel
- Nome · string · requis
- Email · string|null · optionnel
- CpfCnpj · string · requis
- Endereco · object|null · optionnel
- Telefone · string|null · optionnel
- IndicadorIe · integer|null · optionnel
- ConsumidorFinal · boolean|null · optionnel
Exemple d'appel
```
{"name": "cliente_criar", "arguments": {"Nome": "texte", "CpfCnpj": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Id": 1, "Ok": true, "Erro": "texte", "Cliente": {}}}
```
cliente_editar≈ 712 tokens
Atualiza dados de um Cliente existente no cadastro. O campo Id e obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados, nao preservados. Para edicao parcial, faca cliente_consultar primeiro e mande os dados existentes mais o que muda. Valida ownership por UserCreate (cliente tem que pertencer ao usuario logado) e por empresa (IdEmpresa tem que ser a logada, 0 ou null - se for outra empresa sua, troque antes).
Paramètres, retour & exemple (10)
Paramètres
- Id · integer|null · optionnel
- Ie · string|null · optionnel
- Im · string|null · optionnel
- Nome · string · requis
- Email · string|null · optionnel
- CpfCnpj · string · requis
- Endereco · object|null · optionnel
- Telefone · string|null · optionnel
- IndicadorIe · integer|null · optionnel
- ConsumidorFinal · boolean|null · optionnel
Exemple d'appel
```
{"name": "cliente_editar", "arguments": {"Nome": "texte", "CpfCnpj": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Id": 1, "Ok": true, "Erro": "texte", "Cliente": {}}}
```
cte_desacordo≈ 493 tokens
Registra desacordo do tomador com um CT-e recebido (evento tipo 4 do CT-e). Prazo: 45 dias da emissão.
Paramètres, retour & exemple (4)
Paramètres
- Chave · string|null · optionnel
- Observacao · string|null · optionnel
- TipoAmbiente · integer · optionnel · 1 | 2
  Tipo do Documento Fiscal: Valores: 1 - Produção; 2 - Homologação
- NumeroSequencial · integer|null · optionnel
  Número sequencial do evento
Exemple d'appel
```
{"name": "cte_desacordo", "arguments": {"Chave": "texte", "Observacao": "texte", "TipoAmbiente": 1, "NumeroSequencial": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": 1, "DsEvento": "texte", "DsMotivo": "texte", "Base64Xml": "texte", "Base64File": "texte", "DsAmbiente": "texte", "NuProtocolo": "texte", "NumeroSequencial": 1, "CodStatusRespostaSefaz": 1}}
```
cte_emitir≈ 4366 tokens
Emite CT-e (Conhecimento de Transporte Eletrônico). Requer serviço CT-e habilitado no cadastro da empresa e certificado digital A1 ou A3 configurado.
Paramètres, retour & exemple (21)
Paramètres
- Cfop · integer · requis
  CFOP de 4 dígitos. Primeiro dígito: 1/2/3 = entrada, 5/6/7 = saída.
- Lote · integer|null · optionnel
- Carga · object · requis
  Dados da carga transportada (produto predominante, lista de detalhes, documentos fiscais que acompanham). OBRIGATÓRIO. Para Tipo de serviço 0/1/2/6/7/8 também exige Carga.Documentos com ao menos 1 NF-e referenciada.
- Modal · object · requis
  Modal de transporte (rodoviário, aéreo, aquaviário, ferroviário, dutoviário, multimodal). OBRIGATÓRIO. Tipo: 1=Rodoviário, 2=Aéreo, 3=Aquaviário, 4=Ferroviário, 5=Dutoviário, 6=Multimodal.
- Serie · integer|null · optionnel
- Codigo · integer|null · optionnel
- Numero · integer|null · optionnel
- Retira · boolean · optionnel
- Imposto · object|null · optionnel
- Servico · object · requis
  Dados do serviço prestado (Tipo, CodMunicipioInicio, CodMunicipioFim com 7 dígitos cada, MunicipioInicio/MunicipioFim, ValorPrestacao > 0, ValorReceber > 0). OBRIGATÓRIO. Tipo: 0=Normal, 1=Subcontratação, 2=Redespacho, 3=RedespachoIntermediario, 4=ServicoVinculadoMultimodal.
- TipoCte · integer · requis · 0 | 1 | 2 | 3
  Tipo do CT-e. Valores: 0 - CT-e Normal (caso mais comum); 1 - CT-e de Complemento de Valores; 2 - CT-e de Anulação; 3 - CT-e Substituto
- Tomador · object|null · optionnel
- DtEmissao · string|null · optionnel
  Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)
- Expedidor · object|null · optionnel
- Remetente · object|null · optionnel
- Observacao · string|null · optionnel
- Destinatario · object|null · optionnel
- TipoAmbiente · integer · requis · 1 | 2
  Identificação do ambiente da SEFAZ. Valores: 1 - Produção (emissão real, irreversível); 2 - Homologação (teste, sem valor fiscal)
- ModeloDocumento · integer · requis · 57 | 67
  Modelo do Conhecimento de Transporte Eletrônico. Valores: 57 - CT-e (Conhecimento de Transporte Eletrônico); 67 - CT-e OS (Outros Serviços de transporte)
- NaturezaOperacao · string · requis
  Descrição da natureza da operação (ex: "Prestação de serviço de transporte").
- IdentificadorInterno · string|null · optionnel
Exemple d'appel
```
{"name": "cte_emitir", "arguments": {"Cfop": 1, "Carga": {}, "Modal": {}, "Servico": {}, "TipoCte": 0, "TipoAmbiente": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"chave": "texte", "erros": [], "serie": 1, "avisos": [], "numero": 1, "status": 1, "base64Xml": "texte", "base64DACTe": "texte", "tipoAmbiente": "texte"}}
```
dce_emitir≈ 1804 tokens
Emite DC-e (Declaração de Conteúdo Eletrônica) para transporte de itens não-fiscais por pessoa física ou MEI. Requer serviço DC-e habilitado no cadastro.
Paramètres, retour & exemple (20)
Paramètres
- Lote · integer|null · optionnel
- Itens · array · requis
  Itens/produtos declarados no conteúdo (mínimo 1, máximo 999). Cada item exige Descricao (até 120 chars) e ValorTotal > 0. NCM opcional (2 ou 8 dígitos quando informado).
- Serie · integer|null · optionnel
- Codigo · integer|null · optionnel
- Numero · integer|null · optionnel
- UfFisco · string|null · optionnel
  Sigla da UF do órgão fiscalizador (obrigatório quando TipoEmitente=0). Se não preenchido, usa a UF da empresa emissora.
- Remetente · object · requis
  Pessoa física/jurídica que está enviando o pacote. OBRIGATÓRIO. Exige Endereco completo (validado por ValidaPessoaDCe).
- ValorTotal · number|null · optionnel
  Valor total declarado da DC-e. Se omitido, soma dos ValorTotal dos itens. Deve ser > 0.
- XOrgaoFisco · string|null · optionnel
  Nome do órgão fiscalizador (obrigatório quando TipoEmitente=0)
- Destinatario · object · requis
  Destinatário do pacote. OBRIGATÓRIO. Exige Endereco completo.
- TipoAmbiente · integer · requis · 1 | 2
  Tipo de ambiente. Valores: 1 - Produção (emissão real); 2 - Homologação (teste)
- TipoEmitente · integer · optionnel · 0 | 1 | 2 | 3 | 4
  Tipo do emitente: Valores: 0 - App Fisco; 1 - Marketplace; 2 - Emissor próprio; 3 - Transportadora; 4 - ECT (Correios)
- SiteMarketplace · string|null · optionnel
  URL do site do marketplace (obrigatório quando TipoEmitente=1)
- CnpjTransportadora · string|null · optionnel
  CNPJ da transportadora que leva a carga. Opcional. Quando informado, é usado no XML; quando vazio, mantém o CNPJ da empresa emissora.
- IdentificadorInterno · string|null · optionnel
- ModalidadeTransporte · integer · optionnel · 0 | 1 | 2
  Modalidade de transporte: Valores: 0 - Correios; 1 - Conta própria; 2 - Transportadora
- DeclaracaoCrimeTributario · string · requis
  Texto da declaração de crime tributário (xObs2). OBRIGATÓRIO, até 5000 caracteres. Texto padrão sugerido: "Declaro, sob as penas da lei, que o conteúdo desta declaração é verdadeiro e que não estou cometendo crime contra a ordem tributária."
- InformacoesComplementares · string|null · optionnel
  Informações complementares (opcional, até 5000 caracteres).
- DeclaracaoContribuinteICMS · string · requis
  Texto da declaração de contribuinte ICMS (xObs1). OBRIGATÓRIO, até 2000 caracteres. Texto padrão sugerido: "Declaro, sob as penas da lei, que não sou contribuinte do ICMS."
- InformacoesAdicionaisFisco · string|null · optionnel
  Informações adicionais de interesse do fisco (opcional, até 2000 caracteres).
Exemple d'appel
```
{"name": "dce_emitir", "arguments": {"Itens": [], "Remetente": {}, "Destinatario": {}, "TipoAmbiente": 1, "DeclaracaoCrimeTributario": "texte", "DeclaracaoContribuinteICMS": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"chave": "texte", "erros": [], "serie": 1, "avisos": [], "numero": 1, "status": 1, "base64Xml": "texte", "protocolo": "texte", "base64DACE": "texte", "tipoAmbiente": "texte"}}
```
evento_cancelar≈ 1030 tokens
Cancela um documento fiscal autorizado (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e). Informe a chave de 44 dígitos e a justificativa (mínimo 15 caracteres). Para NFS-e use TipoDocumento=1 e informe NumeroNFSe ao invés de chave. Prazo SEFAZ NF-e: 24h após autorização (algumas UFs mais).
Paramètres, retour & exemple (10)
Paramètres
- ChaveNF · string · requis
  Chave de acesso de 44 dígitos da NF-e/NFC-e/CT-e/MDF-e/DC-e a cancelar. Obrigatório quando TipoDocumento = 0 (documentos NFe-family). Para NFS-e (TipoDocumento = 1) use NumeroNFSe.
- DataEvento · string|null · optionnel
  Data do evento de cancelamento do documento (Caso não for enviado é considerada a data e hora atual)
- NumeroNFSe · string|null · optionnel
  Número da NFS-e a ser cancelada
- TipoAmbiente · integer · requis · 1 | 2
  Ambiente do documento original (DEVE bater com o ambiente onde a nota foi emitida). IMPORTANTE: passe explicitamente. Se a nota foi emitida em homologação (testes), use 2. Valores: 1 - Produção; 2 - Homologação
- Justificativa · string · requis
  Motivo do cancelamento. MÍNIMO 15 caracteres, MÁXIMO 1000. NÃO use texto genérico como "cancelamento" ou "erro" - descreva o motivo real (ex: "Erro no valor unitário do produto X"). Obrigatório para TipoDocumento = 0 (NFe-family).
- TipoDocumento · integer · requis · 0 | 1
  Tipo do documento fiscal a cancelar. Valores: 0 - NF-e, NFC-e, CT-e, MDF-e, DC-e (usa ChaveNF de 44 dígitos); 1 - NFS-e (usa NumeroNFSe + CodCancelamentoNFSe + TipoAmbiente)
- NumeroProtocolo · string|null · optionnel
  Número do protocolo de autorização original do documento (obrigatório quando a nota foi emitida por OUTRO sistema externo). Se o documento foi emitido pelo próprio BrasilNFe, o protocolo é localizado automaticamente.
- NumeroSequencial · integer|null · optionnel
  Número sequencial do evento
- CodCancelamentoNFSe · integer · optionnel · 1 | 2 | 3 | 9
  Código do motivo de cancelamento da NFS-e (Padrão 1) Valores: 1 - Erro na emissão; 2 - Serviço não prestado; 3 - Duplicidade da nota; 9 - Outros
- CpfCnpjRemetenteDCe · string|null · optionnel
  CPF ou CNPJ do Usuário Emitente (Remetente) da DC-e original. Obrigatório no cancelamento de DC-e quando a nota não está cadastrada no sistema (caso esteja, o valor é lido da própria NotaFiscal).
Exemple d'appel
```
{"name": "evento_cancelar", "arguments": {"ChaveNF": "texte", "TipoAmbiente": 1, "Justificativa": "texte", "TipoDocumento": 0}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": 1, "DsEvento": "texte", "DsMotivo": "texte", "Base64Xml": "texte", "Base64File": "texte", "DsAmbiente": "texte", "NuProtocolo": "texte", "NumeroSequencial": 1, "CodStatusRespostaSefaz": 1}}
```
evento_carta_correcao≈ 788 tokens
Envia Carta de Correção (CC-e) para uma NF-e ou CT-e já autorizada (evento tipo 2). Não pode corrigir: valores, datas de emissão/saída, partes envolvidas (CNPJ/CPF), regimes tributários ou número/série do documento. Limite: 20 CC-e por NF-e.
Paramètres, retour & exemple (5)
Paramètres
- ChaveNF · string · requis
  Chave de acesso de 44 dígitos da NF-e ou CT-e a corrigir.
- Correcao · string|null · optionnel
  Texto da correção (mínimo 15, máximo 1000 caracteres). Obrigatório para NF-e (modelo 55). Não pode corrigir variáveis que afetam tributos (valores, quantidades, base de cálculo, alíquotas) nem dados de remetente/destinatário, nem data de emissão. Para CT-e use a lista Correcoes em vez deste campo.
- Correcoes · array|null · optionnel
  Lista de correções estruturadas (campo, grupo, valor). Usado SOMENTE para CT-e (modelo 57). Para NF-e/NFC-e use o campo Correcao acima.
- TipoAmbiente · integer · requis · 1 | 2
  Ambiente do documento original (DEVE bater com o ambiente onde a nota foi emitida). IMPORTANTE: passe explicitamente. Se a nota foi emitida em homologação, use 2. Valores: 1 - Produção; 2 - Homologação
- NumeroSequencial · integer|null · optionnel
  Número sequencial do evento (1 a 20). Se omitido, o sistema usa o próximo disponível.
Exemple d'appel
```
{"name": "evento_carta_correcao", "arguments": {"ChaveNF": "texte", "TipoAmbiente": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": 1, "DsEvento": "texte", "DsMotivo": "texte", "Base64Xml": "texte", "Base64File": "texte", "DsAmbiente": "texte", "NuProtocolo": "texte", "NumeroSequencial": 1, "CodStatusRespostaSefaz": 1}}
```
evento_inutilizar≈ 714 tokens
Inutiliza uma faixa de numeração não utilizada na SEFAZ. Útil quando há quebra de sequência por erro de emissão. Não pode ser desfeito. Operação rara - confirme com o usuário antes.
Paramètres, retour & exemple (6)
Paramètres
- Serie · integer · requis
  Série referente ao modelo do documento. Deve ser > 0.
- TipoAmbiente · integer · requis · 1 | 2
  Identificação do Ambiente. IMPORTANTE: passe explicitamente. Inutilização em produção é IRREVERSÍVEL. Valores: 1 - Produção (faixa fica DEFINITIVAMENTE inutilizada na SEFAZ); 2 - Homologação (teste)
- Justificativa · string · requis
  Justificativa da inutilização. Mínimo 15, máximo 255 caracteres. Descreva o motivo real (ex: "Erro de digitação - série pulada por engano no sistema interno").
- NumeracaoFinal · integer · requis
  Final da faixa numérica a inutilizar. Deve ser >= NumeracaoInicial.
- ModeloDocumento · integer · requis · 55 | 65 | 57
  Código do modelo do Documento Fiscal a inutilizar. Valores: 55 - NF-e; 65 - NFC-e; 57 - CT-e
- NumeracaoInicial · integer · requis
  Início da faixa numérica a inutilizar. Deve ser > 0 e <= NumeracaoFinal.
Exemple d'appel
```
{"name": "evento_inutilizar", "arguments": {"Serie": 1, "TipoAmbiente": 1, "Justificativa": "texte", "NumeracaoFinal": 1, "ModeloDocumento": 55, "NumeracaoInicial": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": 1, "DsEvento": "texte", "DsMotivo": "texte", "Base64Xml": "texte", "Base64File": "texte", "DsAmbiente": "texte", "NuProtocolo": "texte", "NumeroSequencial": 1, "CodStatusRespostaSefaz": 1}}
```
evento_manifestar≈ 694 tokens
Registra a manifestação do destinatário sobre uma NF-e. TipoEvento: 0=ciência da operação, 1=confirmação da operação, 2=desconhecimento, 3=operação não realizada.
Paramètres, retour & exemple (5)
Paramètres
- Chave · string · requis
  Chave de acesso de 44 dígitos da NF-e a manifestar.
- TipoAmbiente · integer · requis · 1 | 2
  Ambiente do documento original (DEVE bater com o ambiente onde a nota foi emitida). IMPORTANTE: passe explicitamente. Manifestação de NF de prod precisa ser ambiente 1. Valores: 1 - Produção; 2 - Homologação
- Justificativa · string|null · optionnel
  Justificativa. OBRIGATÓRIA quando TipoManifestacao = 4 (mínimo 15 caracteres). Para outros tipos pode omitir.
- NumeroSequencial · integer|null · optionnel
  Número sequencial do evento (1 a 20). Se omitido, o sistema usa o próximo disponível.
- TipoManifestacao · integer · requis · 1 | 2 | 3 | 4
  Tipo da manifestação do destinatário. Valores: 1 - Confirmação da Operação; 2 - Ciência da Operação; 3 - Desconhecimento da Operação; 4 - Operação não Realizada (exige Justificativa com 15+ caracteres)
Exemple d'appel
```
{"name": "evento_manifestar", "arguments": {"Chave": "texte", "TipoAmbiente": 1, "TipoManifestacao": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": 1, "DsEvento": "texte", "DsMotivo": "texte", "Base64Xml": "texte", "Base64File": "texte", "DsAmbiente": "texte", "NuProtocolo": "texte", "NumeroSequencial": 1, "CodStatusRespostaSefaz": 1}}
```
fci_gerar≈ 474 tokens
Gera o arquivo FCI (Ficha de Conteúdo de Importação) requerido para produtos com conteúdo importado em operações interestaduais.
Paramètres, retour & exemple (3)
Paramètres
- Produtos · array|null · optionnel
  Produtos para gerar os registros do arquivo FCI
- Transmitir · boolean · optionnel
  Quando verdadeiro, além de gerar o arquivo, assina e transmite a mídia via programa TED. Requer certificado e-CNPJ configurado na empresa.
- ValidarCodigos · boolean · optionnel
  Quando verdadeiro retorna erro caso envie produtos com código repetido
Exemple d'appel
```
{"name": "fci_gerar", "arguments": {"Produtos": [], "Transmitir": true, "ValidarCodigos": true}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
health≈ 92 tokens
Verifica a saúde da API BrasilNFe (status, timestamp, versão). Não recebe parâmetros.
Paramètres, retour & exemple (0)
Exemple d'appel
```
{"name": "health", "arguments": {}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
imposto_calcular≈ 441 tokens
Simula o cálculo de impostos (ICMS, PIS, COFINS, IPI, ST) sobre uma lista de produtos sem emitir nota. Útil para precificação.
Paramètres, retour & exemple (2)
Paramètres
- Count · integer · optionnel
- Capacity · integer · optionnel
Exemple d'appel
```
{"name": "imposto_calcular", "arguments": {"Count": 1, "Capacity": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Total": {}, "Avisos": [], "Impostos": {}}}
```
mdfe_emitir≈ 3852 tokens
Emite MDF-e (Manifesto Eletrônico de Documentos Fiscais), agrupando vários CT-e/NF-e em um único transporte. Obrigatório para transportadores com vários DFs no mesmo veículo.
Paramètres, retour & exemple (24)
Paramètres
- lote · integer|null · optionnel
- peso · number · requis
  Peso bruto total das mercadorias em KG. DEVE ser > 0.
- Aereo · object|null · optionnel
- serie · integer|null · optionnel
- valor · number · requis
  Valor total das mercadorias transportadas. DEVE ser > 0.
- codigo · integer|null · optionnel
- numero · integer|null · optionnel
- seguros · array|null · optionnel
- Aquaviario · object|null · optionnel
- Rodoviario · object|null · optionnel
  Dados do transporte rodoviário (placa 7 caracteres, condutores com CPF/nome, UF do veículo). OBRIGATÓRIO quando modalidade = 1.
- modalidade · integer · requis · 1 | 2 | 3 | 4
  Modalidade de transporte. Valores: 1 - Rodoviário (exige objeto Rodoviario com placa, condutores e percurso); 2 - Aéreo (exige objeto Aereo); 3 - Aquaviário (exige objeto Aquaviario); 4 - Ferroviário (exige objeto Ferroviario)
- observacao · string|null · optionnel
- DataEmissao · string|null · optionnel
  Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)
- Ferroviario · object|null · optionnel
- percursoUfs · array|null · optionnel
- tipoAmbiente · integer · requis · 1 | 2
  Tipo de ambiente. IMPORTANTE: passe explicitamente. Para testes use 2. Valores: 1 - Produção; 2 - Homologação
- tipoEmitente · integer · requis · 1 | 2
  Tipo de emitente. Valores: 1 - Prestador de Serviço de Transporte (transportadora); 2 - Transportador de carga própria (mais comum - empresa transportando seus próprios produtos)
- carregamentos · array|null · optionnel
- ufCarregamento · string · requis
  UF de carregamento (origem). Sigla de 2 letras (SP, RJ, MG...).
- observacaoFisco · string|null · optionnel
- descarregamentos · array|null · optionnel
- ufDescarregamento · string · requis
  UF de descarregamento (destino). Sigla de 2 letras (SP, RJ, MG...).
- produtoPredominante · object|null · optionnel
  Produto predominante transportado. Opcional.
- identificadorInterno · string|null · optionnel
Exemple d'appel
```
{"name": "mdfe_emitir", "arguments": {"peso": 1, "valor": 1, "modalidade": 1, "tipoAmbiente": 1, "tipoEmitente": 1, "ufCarregamento": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "chave": "texte", "Avisos": [], "numero": 1, "status": 1, "base64Xml": "texte", "base64DAMDFe": "texte", "tipoAmbiente": "texte", "codRespostaSefaz": 1}}
```
mdfe_encerrar≈ 606 tokens
Encerra um MDF-e já autorizado (evento tipo 3). Obrigatório ao final de cada transporte. Sem encerramento, novos MDF-e podem ser bloqueados pela SEFAZ.
Paramètres, retour & exemple (4)
Paramètres
- chave · string · requis
  Chave de acesso de 44 dígitos do MDF-e a encerrar.
- protocolo · string|null · optionnel
  Protocolo de autorização do MDF-e original. Opcional - se omitido, o sistema localiza pela chave.
- tipoAmbiente · integer · requis · 1 | 2
  Ambiente do MDF-e original (DEVE bater com o ambiente onde o manifesto foi emitido). IMPORTANTE: passe explicitamente. ATENÇÃO: encerramento é DEFINITIVO - revise os dados antes. Valores: 1 - Produção; 2 - Homologação
- numeroSequencial · integer|null · optionnel
  Número sequencial do evento. Se omitido, o sistema usa o próximo disponível.
Exemple d'appel
```
{"name": "mdfe_encerrar", "arguments": {"chave": "texte", "tipoAmbiente": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": 1, "DsEvento": "texte", "DsMotivo": "texte", "Base64Xml": "texte", "Base64File": "texte", "DsAmbiente": "texte", "NuProtocolo": "texte", "NumeroSequencial": 1, "CodStatusRespostaSefaz": 1}}
```
nfe_emitir≈ 10347 tokens
Emite uma NF-e (modelo 55) ou NFC-e (modelo 65) na SEFAZ. Use modeloDocumento=55 para NF-e (B2B com destinatário CPF/CNPJ) ou modeloDocumento=65 para NFC-e (consumidor final). Retorna chave de acesso (44 dígitos), número, protocolo, status e XML/DANFE em base64. Operação síncrona (pode levar 5-30s). Use tipoAmbiente=2 (homologação) para testes. TRANSMITE DE VERDADE: só chame depois que o usuário aprovou a pré-visualização final (nfe_previsualizar) e confirmou a emissão; envie confirmacaoUsuario=true (conexões OAuth são recusadas sem ele).
Paramètres, retour & exemple (36)
Paramètres
- Lote · integer|null · optionnel
  Lote da Nota Fiscal
- Serie · integer|null · optionnel
  Série da nota Fiscal
- Codigo · string|null · optionnel
  B03 - Código numérico que compõe a Chave de Acesso. Número aleatório gerado pelo emitente para cada NF-e.
- Numero · integer|null · optionnel
  Número da nota fiscal
- Cliente · object|null · optionnel
  Destinatário da nota. OBRIGATÓRIO para NF-e (modelo 55). Para NFC-e (modelo 65) só é obrigatório quando IndicadorPresenca = 4 (entrega a domicílio). Quando informado para NF-e mod 55, exige: CpfCnpj, NmCliente, IndicadorIe (1/2/9), Endereco com Logradouro e UF (e CEP/Município/Bairro quando não exportação).
- Entrega · object|null · optionnel
- Exporta · object|null · optionnel
- Cobranca · object|null · optionnel
- Produtos · array · requis
  Itens da nota fiscal. Mínimo 1 item.
- Retencoes · object|null · optionnel
  Retenções federais totais da nota (IRRF, PIS/COFINS/CSLL retidos, Previdência). Gera a tag retTrib no XML.
- TipoDanfe · integer|null · optionnel · 0 | 1 | 2 | 3 | 4 | 5 | 6 | None
  Formato de impressão do DANFE (tag tpImp da NF-e). Não informado = padrão atual (1-Retrato para NF-e, 4 para NFC-e). Valores: 0 - Sem geração de DANFE; 1 - DANFE normal, Retrato (padrão NF-e); 2 - DANFE normal, Paisagem; 3 - DANFE Simplificado; 4 - DANFE NFC-e (padrão NFC-e; somente modelo 65); 5 - DANFE NFC-e em mensagem eletrônica (somente modelo 65); 6 - DANFE Simplificado Tipo 2 (NT 2026.002/2026.003, Ajuste SINIEF 13/26; somente modelo 55) - NF-e de varejo em operação típica de NFC-e, impressa em bobina com QR Code. Exige operação interna (CFOP 5xxx), consumidor final, finalidade 1-Normal, saída, sem notas referenciadas e IndicadorPresenca 1, 4 ou 5.
- Finalidade · integer · requis · 1 | 2 | 3 | 4 | 5 | 6
  Finalidade da emissão da NF. Valores: 1 - Normal (caso mais comum); 2 - Complementar (referenciando NF anterior em NFReferencia); 3 - Ajuste; 4 - Devolução; 5 - Nota de crédito; 6 - Nota de débito
- Observacao · string|null · optionnel
- Pagamentos · array|null · optionnel
  Formas de pagamento. OBRIGATÓRIO quando Finalidade = 1 (Normal). Para finalidades 2/3/4/5/6 pode ficar vazio. Para NFC-e (mod 65) deve haver pelo menos um pagamento com FormaPagamento diferente de "90" (sem pagamento).
- TpNFDebito · integer|null · optionnel · 1 | 2 | 3 | 4 | 5 | 6 | 7 | None
  Tipo de Nota de Débito. Obrigatório quando Finalidade = 6. Código SEFAZ: Valores: 1 - Transferência de créditos para Cooperativas; 2 - Anulação de Crédito por Saídas Imunes/Isentas; 3 - Débitos de notas fiscais não processadas na apuração; 4 - Multa e juros; 5 - Transferência de crédito de sucessão; 6 - Pagamento antecipado; 7 - Perda em estoque
- Transporte · object|null · optionnel
- ValorFrete · number|null · optionnel
  Valor total do frete da nota. Quando informado, é distribuído proporcionalmente entre os itens (proporção pelo ValorTotal de cada item), SUBSTITUINDO o ValorFrete informado em cada produto. Não informado (nulo) = o frete de cada item é usado como enviado.
- ValorTotal · number|null · optionnel
  Valor total esperado da nota (vNF), usado apenas para validação. Quando informado e diferente do valor total calculado (produtos - descontos + frete + seguro + outras despesas + impostos que compõem o total), a emissão é bloqueada e o erro detalha o cálculo. Não informado (nulo) = sem validação.
- DataEmissao · string|null · optionnel
  Data e Hora da saída ou de entrada da produto/serviço (Envia a data atual caso não informada)
- EnviarEmail · boolean · optionnel
- TpNFCredito · integer|null · optionnel · 1 | 2 | 3 | 4 | 5 | 6 | None
  Tipo de Nota de Crédito. Obrigatório quando Finalidade = 5. Código SEFAZ: Valores: 1 - Multa e juros; 2 - Apropriação de crédito presumido de IBS sobre saldo devedor na ZFM; 3 - Retorno por recusa total na entrega ou por não localização do destinatário; 4 - Redução de valores; 5 - Transferência de crédito na sucessão; 6 - Retorno por recusa parcial na entrega
- CalcularIBPT · boolean · optionnel
  Calcula o valor aproximado dos tributos (vTotTrib, tabela IBPT, Lei 12.741/2012). Padrão: verdadeiro.
- NFReferencia · array|null · optionnel
  Notas fiscal de Referência
- TipoAmbiente · integer · requis · 1 | 2
  Identificação do ambiente da SEFAZ. Valores: 1 - Produção (emissão REAL, com valor fiscal, irreversível); 2 - Homologação (teste, sem valor fiscal - use durante desenvolvimento e testes)
- Intermediador · object|null · optionnel
  Dados do intermediador/marketplace (site ou plataforma de terceiros).
- Justificativa · string|null · optionnel
  Utilizar quando o tipo de emissão for diferente normal
- ValorDesconto · number|null · optionnel
  Valor total do desconto da nota. Quando informado, é distribuído proporcionalmente entre os itens (proporção pelo ValorTotal de cada item), SUBSTITUINDO o ValorDesconto informado em cada produto. Não informado (nulo) = o desconto de cada item é usado como enviado.
- ConsumidorFinal · boolean · optionnel
  Indica operação com Consumidor final (NFCe de ser 1 Validar!)
- ModeloDocumento · integer · requis · 55 | 65
  Código do modelo do Documento Fiscal. Valores: 55 - NF-e (B2B / com destinatário CPF/CNPJ identificado); 65 - NFC-e (consumidor final / varejo)
- ObservacaoFisco · string|null · optionnel
- DataEntradaSaida · string|null · optionnel
  Data e Hora da saída ou de entrada da produto/serviço
- NaturezaOperacao · string · requis
  Descrição da natureza da operação (máx 60 caracteres). Exemplos: "Venda de mercadoria", "Remessa para industrialização", "Devolução de venda".
- IndicadorPresenca · integer · requis · 0 | 1 | 2 | 3 | 4 | 5 | 9
  Indicador de presença do comprador no estabelecimento comercial no momento da operação. Padrão sugerido para NF-e B2B = 9 (operação não presencial, outros). Para NFC-e varejo = 1 (presencial). Valores: 0 - Não se aplica; 1 - Operação presencial;; 2 - Operação não presencial, pela Internet;; 3 - Operação não presencial, Teleatendimento;; 4 - NFC-e em operação com entrega a domicílio;; 5 - Presencial fora do estabelecimento;; 9 - Operação não presencial, outros.
- confirmacaoUsuario · boolean · optionnel
  Envie true SOMENTE depois que o usuário viu a pré-visualização final e confirmou explicitamente a emissão nesta conversa. Obrigatório em conexões OAuth.
- IdentificadorInterno · string|null · optionnel
- NFPagamentoAntecipado · array|null · optionnel
  Grupo de notas de antecipação de pagamento (gPagAntecipado - Reforma Tributária).
Exemple d'appel
```
{"name": "nfe_emitir", "arguments": {"Produtos": [], "Finalidade": 1, "TipoAmbiente": 1, "ModeloDocumento": 55, "NaturezaOperacao": "texte", "IndicadorPresenca": 0}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "ReturnNF": {}, "Base64Xml": "texte", "Base64File": "texte"}}
```
nfe_emitir_complementar≈ 7597 tokens
Emite uma NF-e complementar referenciando uma NF-e já autorizada. Usado para complementar valores, impostos ou itens (finalidade=2). Informe a chave da nota original em NFReferencia.
Paramètres, retour & exemple (16)
Paramètres
- CFOP · integer · optionnel
  CFOP
- Lote · integer|null · optionnel
  Lote da Nota Fiscal
- Serie · integer|null · optionnel
  Série da nota Fiscal
- Codigo · string|null · optionnel
  Código numérico que compõe a Chave de Acesso. Número aleatório gerado pelo emitente para cada NF-e.
- Numero · integer|null · optionnel
  Número da nota fiscal
- Cliente · object|null · optionnel
- Cobranca · object|null · optionnel
- Produtos · array|null · optionnel
- Observacao · string|null · optionnel
- Transporte · object|null · optionnel
- NFReferencia · string|null · optionnel
  Notas fiscal de Referência
- TipoAmbiente · integer · optionnel · 1 | 2
  Identificação do Ambiente Valores: 1 - Produção; 2 - Homologação
- ObservacaoFisco · string|null · optionnel
- TipoComplemento · integer · optionnel · 0 | 1
  Tipo de complemento Valores: 0 - Complementar quantidade ou valor; 1 - Complementar impostos
- NaturezaOperacao · string|null · optionnel
  Descrição da Natureza da Operação
- ImpostoComplementar · object|null · optionnel
Exemple d'appel
```
{"name": "nfe_emitir_complementar", "arguments": {"CFOP": 1, "Lote": 1, "Serie": 1, "Codigo": "texte", "Numero": 1, "Cliente": {}}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "ReturnNF": {}, "Base64Xml": "texte", "Base64File": "texte"}}
```
nfe_previsualizar≈ 23410 tokens
Gera o DANFE em PDF e o XML como pré-visualização, sem enviar para a SEFAZ. Envie a nota completa em 'notaFiscal' (mesmo formato de nfe_emitir) com TipoEnvio=1 e TipoArquivo=2 (PDF + XML juntos). O resultado abre num painel ao lado da conversa: chame de novo a cada alteração pedida pelo usuário (CFOP, itens, destinatário, valores) para o painel refletir a nota atual. Erros de validação voltam em 'Error'/'Avisos'.
Paramètres, retour & exemple (9)
Paramètres
- cte · object|null · optionnel
  CT-e (modelo 57/67). Usado quando TipoEnvio = 1. Gera o DACTE/XML de pré-visualização.
- dce · object|null · optionnel
  DC-e (modelo 99). Usado quando TipoEnvio = 1. Gera o DACE/XML de pré-visualização.
- mdfe · object|null · optionnel
  MDF-e (modelo 58). Usado quando TipoEnvio = 1. Gera o DAMDFE/XML de pré-visualização.
- nfse · object|null · optionnel
  NFS-e. Usado quando TipoEnvio = 1. Gera o DANFSe/XML de pré-visualização (sem validade jurídica).
- Base64Xml · string|null · optionnel
- TipoEnvio · integer · optionnel · 0 | 1
  Tipo do envio no qual será convertido para o tipo do arquivo informado (Padrão - 0) Valores: 0 - Base64 contendo as informações do XML; 1 - Objeto contendo as informações das notas fiscais
- notaFiscal · object|null · optionnel
  NF-e / NFC-e (modelo 55/65). Usado quando TipoEnvio = 1. Gera o DANFE/XML de pré-visualização.
- TipoArquivo · integer · optionnel · 0 | 1 | 2
  Tipo do arquivo que deseja pré-visualizar (Padrão - 0) Valores: 0 - XML; 1 - PDF; 2 - PDF em Base64File e XML em Base64Xml na mesma chamada
- mostrarTarjaPreVisualizacao · boolean · optionnel
  Mostrar tarja "SEM VALOR FISCAL - PRÉ-VISUALIZAÇÃO" (Padrão - Verdadeiro) Somente para o tipo de arquivo PDF e se um dos serviços de emissão estiver ativo para a empresa
Exemple d'appel
```
{"name": "nfe_previsualizar", "arguments": {"cte": {}, "dce": {}, "mdfe": {}, "nfse": {}, "Base64Xml": "texte", "TipoEnvio": 0}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Avisos": [], "Status": true, "Base64Xml": "texte", "Base64File": "texte"}}
```
nfenercom_emitir≈ 1690 tokens
Envia a NF-EnerCom (Nota Fiscal de Energia Comercializada) para autorização na SEFAZ.
Paramètres, retour & exemple (12)
Paramètres
- serie · string|null · optionnel
  Série da nota fiscal. Quando não informado é controlado pelo Painel
- numero · integer|null · optionnel
  Número da nota fiscal. Quando não informado é controlado pelo Painel
- energia · object|null · optionnel
  Informações referente a nota de Energia
- produtos · array · requis
  Itens da nota (mínimo 1). Cada item exige codigo, descricao, unidadeMedida, quantidade, valor, CFOP.
- situacao · integer · optionnel · 1 | 2 | 3 | 4
  Situação do documento (Padrão 4) Valores: 1 - documento fiscal cancelado dentro do mesmo período de apuração;; 2 - documento fiscal emitido em substituição a um documento fiscal cancelado dentro do mesmo período de apuração; 3 - documento fiscal complementar; 4 - demais casos
- comunicao · object|null · optionnel
  Informações referente a nota de comunicação e Telecomunicação
- dataEmissao · string · requis
  Data de emissão do documento. Obrigatória.
- destinatario · object · requis
  Informações do destinatário (cliente). OBRIGATÓRIO.
- tipoAmbiente · integer · requis · 1 | 2
  Tipo de ambiente. Valores: 1 - Produção; 2 - Homologação
- modeloDocumento · integer · requis · 6 | 21 | 22
  Modelo do documento. Valores: 6 - Energia elétrica; 21 - Comunicação; 22 - Telecomunicação
- valorTotalFatura · number · requis
  Valor total da fatura comercial. Deve ser > 0.
- identificadorInterno · string|null · optionnel
  Código de controle interno unico da venda. Evita duplicidades, caso configurado.
Exemple d'appel
```
{"name": "nfenercom_emitir", "arguments": {"produtos": [], "dataEmissao": "texte", "destinatario": {}, "tipoAmbiente": 1, "modeloDocumento": 6, "valorTotalFatura": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"erros": [], "avisos": [], "status": 1}}
```
nfenercom_gerar_arquivo≈ 1708 tokens
Gera o arquivo da Nota Fiscal de Energia (NF-EnerCom). Pré-requisito para nfenercom_emitir.
Paramètres, retour & exemple (5)
Paramètres
- ano · integer|null · optionnel
  Ano de emissão das notas (4 dígitos). Obrigatório quando tipoGeracao = 1.
- mes · integer|null · optionnel
  Mês de emissão das notas (1-12). Obrigatório quando tipoGeracao = 1.
- notas · array|null · optionnel
  Notas Fiscais de Energia/Comunicação/Telecomunicação a incluir no arquivo. Obrigatório quando tipoGeracao = 2.
- tipoGeracao · integer · requis · 1 | 2
  Tipo de geração do arquivo. Valores: 1 - Gera o arquivo a partir das notas já emitidas no período (mes + ano informados); 2 - Gera o arquivo a partir da lista de notas informada em "notas"
- tipoAmbiente · integer · requis · 1 | 2
  Tipo de ambiente. Valores: 1 - Produção; 2 - Homologação
Exemple d'appel
```
{"name": "nfenercom_gerar_arquivo", "arguments": {"tipoGeracao": 1, "tipoAmbiente": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```

nfse_consultar≈ 1041 tokens

Consulta status e dados de uma NFS-e já enviada por número, série e ambiente.

Paramètres, retour & exemple (2)

Paramètres

Rps · array|null · optionnel
Rps para retornar (Se não enviar retorna todos)
codLote · string|null · optionnel
Código do lote

Exemple d'appel

{"name": "nfse_consultar", "arguments": {"Rps": [], "codLote": "texte"}}

Exemple de retour

{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Lote": 1, "Error": "texte", "Notas": [], "Avisos": [], "CodLote": "texte", "Protocolo": "texte", "StatusLote": 1, "Base64XmlLote": "texte", "DsTipoAmbiente": "texte", "MunicipioEnvio": "texte", "CodTipoAmbiente": 1, "DataRecebimento": "texte"}}

nfse_emitir≈ 4811 tokens
Emite NFS-e (Nota Fiscal de Serviços Eletrônica). Cada município brasileiro tem regras e webservices próprios - confira o município emissor antes. Pode usar Portal Nacional NFS-e ou prefeitura específica conforme cadastro da empresa.
Paramètres, retour & exemple (3)
Paramètres
- Lote · integer|null · optionnel
- nFSInfo · array · requis
  Lista de NFS-e a emitir no lote. Mínimo 1 item.
- TipoAmbiente · integer · requis · 1 | 2
  Identificação do ambiente da prefeitura/portal nacional. Valores: 1 - Produção (emissão REAL, com valor fiscal); 2 - Homologação (teste)
Exemple d'appel
```
{"name": "nfse_emitir", "arguments": {"nFSInfo": [], "TipoAmbiente": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Lote": 1, "Error": "texte", "Notas": [], "Avisos": [], "CodLote": "texte", "Protocolo": "texte", "StatusLote": 1, "Base64XmlLote": "texte", "DsTipoAmbiente": "texte", "MunicipioEnvio": "texte", "CodTipoAmbiente": 1, "DataRecebimento": "texte"}}
```
nota_listar≈ 878 tokens
Lista NF-e/NFC-e/NFS-e emitidas ou recebidas pela empresa em um intervalo de datas. Suporta filtros por chave, número, status e tipo.
Paramètres, retour & exemple (6)
Paramètres
- DtFim · string · optionnel
  Data final da busca
- DtInicio · string · optionnel
  Data inicial da busca
- TipoAmbiente · integer · optionnel · 1 | 2
  Tipo de ambiente (Padrão 1 - Produção) Valores: 1 - Produção; 2 - Homologação
- TipoParticipacao · integer · optionnel · 0 | 1 | 2
  Como a empresa participa das notas de entrada (Padrão 0 - Destinatário). Somente para TipoDocumentoFiscal = 0. Valores: 0 - Destinatário (comportamento padrão); 1 - Transportadora (NF-e onde a empresa é citada como transportadora ou terceiro autorizado); 2 - Ambos
- TipoDocumentoFiscal · integer · optionnel · 0 | 1
  Tipo do documento fiscal (Padrão 0 - Entrada) Valores: 0 - Entradas; 1 - Saídas
- IdentificadorInterno · string|null · optionnel
  Busca notas que possui o código interno informado (somente saídas)
Exemple d'appel
```
{"name": "nota_listar", "arguments": {"DtFim": "texte", "DtInicio": "texte", "TipoAmbiente": 1, "TipoParticipacao": 0, "TipoDocumentoFiscal": 0, "IdentificadorInterno": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Error": "texte", "Notas": [], "Avisos": []}}
```
produto_consultar≈ 466 tokens
Pesquisa produto no cadastro da empresa logada. Aceita codigo interno, NCM (8 digitos), GTIN/EAN (8/12/13/14 digitos) ou descricao parcial. Use ANTES de criar produtos novos para evitar duplicatas. PAGINACAO: Limite default 20 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar.
Paramètres, retour & exemple (4)
Paramètres
- Termo · string|null · optionnel
- Limite · integer|null · optionnel
- Offset · integer|null · optionnel
- TipoBusca · string|null · optionnel
Exemple d'appel
```
{"name": "produto_consultar", "arguments": {"Termo": "texte", "Limite": 1, "Offset": 1, "TipoBusca": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Avisos": [], "Limite": 1, "Offset": 1, "Matches": [], "TotalGeral": 1, "TotalLocal": 1, "TipoDetectado": "texte", "TermoNormalizado": "texte"}}
```
produto_criar≈ 442 tokens
Cadastra um novo Produto na empresa logada. Validacao de duplicata por Codigo. NCM aceito com 7 ou 8 digitos (zero-pad automatico). EAN/GTIN validado por digito verificador.
Paramètres, retour & exemple (11)
Paramètres
- Id · integer|null · optionnel
- Ean · string|null · optionnel
- Ncm · string|null · optionnel
- Cest · string|null · optionnel
- Codigo · string · requis
- Descricao · string · requis
- FatorConversao · number|null · optionnel
- QuantidadeEstoque · number|null · optionnel
- ValorUnitarioVenda · number · requis
- UnidadeMedidaVendaSigla · string · requis
- UnidadeMedidaCompraSigla · string|null · optionnel
Exemple d'appel
```
{"name": "produto_criar", "arguments": {"Codigo": "texte", "Descricao": "texte", "ValorUnitarioVenda": 1, "UnidadeMedidaVendaSigla": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Id": 1, "Ok": true, "Erro": "texte", "Produto": {}}}
```
produto_editar≈ 499 tokens
Atualiza um Produto existente. Id obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados. Faca produto_consultar antes pra ter os dados atuais, depois envie tudo + o que muda. Valida ownership por UserCreate (produto tem que pertencer ao usuario logado) e por empresa (IdEmpresa tem que ser a logada ou 0 - se for outra empresa sua, troque antes).
Paramètres, retour & exemple (11)
Paramètres
- Id · integer|null · optionnel
- Ean · string|null · optionnel
- Ncm · string|null · optionnel
- Cest · string|null · optionnel
- Codigo · string · requis
- Descricao · string · requis
- FatorConversao · number|null · optionnel
- QuantidadeEstoque · number|null · optionnel
- ValorUnitarioVenda · number · requis
- UnidadeMedidaVendaSigla · string · requis
- UnidadeMedidaCompraSigla · string|null · optionnel
Exemple d'appel
```
{"name": "produto_editar", "arguments": {"Codigo": "texte", "Descricao": "texte", "ValorUnitarioVenda": 1, "UnidadeMedidaVendaSigla": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Id": 1, "Ok": true, "Erro": "texte", "Produto": {}}}
```
sefaz_status≈ 470 tokens
Consulta o status do serviço de autorização da SEFAZ para uma UF e ambiente. Use antes de uma emissão em lote ou quando suspeitar de instabilidade.
Paramètres, retour & exemple (1)
Paramètres
- ModeloDocumento · integer · optionnel · 55 | 65
  Modelo do documento fiscal usado para determinar o webservice de status da SEFAZ (Padrão 55). Valores: 55 - NF-e; 65 - NFC-e
Exemple d'appel
```
{"name": "sefaz_status", "arguments": {"ModeloDocumento": 55}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"erros": [], "Versao": "texte", "avisos": [], "status": 1, "DsTipoAmbiente": "texte", "CodTipoAmbiente": 1, "DsEstadoEmitente": "texte", "CodEstadoEmitente": 1, "DsStatusRespostaSefaz": "texte", "CodStatusRespostaSefaz": 1}}
```
tributacao_consultar≈ 529 tokens
Lista regras de tributacao da empresa (CFOP, CST, aliquotas ICMS/PIS/COFINS/IPI/IBS/CBS). Filtra por Tipo (1=NFe, 2=NFCe, 3=Energia/Comunicacao), CFOP especifico ou termo na descricao. Use antes de criar nota fiscal pra LLM saber quais tributos aplicar. PAGINACAO: Limite default 20 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar.
Paramètres, retour & exemple (5)
Paramètres
- Cfop · integer|null · optionnel
- Tipo · integer|null · optionnel
- Termo · string|null · optionnel
- Limite · integer|null · optionnel
- Offset · integer|null · optionnel
Exemple d'appel
```
{"name": "tributacao_consultar", "arguments": {"Cfop": 1, "Tipo": 1, "Termo": "texte", "Limite": 1, "Offset": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Total": 1, "Avisos": [], "Limite": 1, "Offset": 1, "Matches": [], "TotalGeral": 1}}
```
tributacao_criar≈ 614 tokens
Cadastra uma nova regra de tributacao (CFOP + CSTs + aliquotas). Tipo 1=NFe, 2=NFCe, 3=Energia/Comunicacao. CstIbsCbs e obrigatorio (Reforma Tributaria).
Paramètres, retour & exemple (23)
Paramètres
- Id · integer|null · optionnel
- Cfop · integer · requis
- Tipo · integer · optionnel
- CstIpi · string|null · optionnel
- CstPis · string|null · optionnel
- AliqCbs · number|null · optionnel
- AliqIpi · number|null · optionnel
- AliqPis · number · optionnel
- ApiCode · string|null · optionnel
- CstIcms · string|null · optionnel
- AliqIcms · number · optionnel
- AutoAliq · boolean · optionnel
- AliqIbsUf · number|null · optionnel
- CstCofins · string|null · optionnel
- CstIbsCbs · string|null · optionnel
- Descricao · string · requis
- AliqCofins · number · optionnel
- AliqIbsMun · number|null · optionnel
- Observacao · string|null · optionnel
- AliqReducao · number|null · optionnel
- AliqDiferimento · number|null · optionnel
- EnquadramentoIpi · string|null · optionnel
- CodBeneficioFiscal · string|null · optionnel
Exemple d'appel
```
{"name": "tributacao_criar", "arguments": {"Cfop": 1, "Descricao": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Id": 1, "Ok": true, "Erro": "texte", "Tributacao": {}}}
```
tributacao_editar≈ 639 tokens
Atualiza uma regra de tributacao existente. Id obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados. Faca tributacao_consultar antes pra ter os dados atuais, depois envie tudo + o que muda. Valida ownership por IdEmpresa.
Paramètres, retour & exemple (23)
Paramètres
- Id · integer|null · optionnel
- Cfop · integer · requis
- Tipo · integer · optionnel
- CstIpi · string|null · optionnel
- CstPis · string|null · optionnel
- AliqCbs · number|null · optionnel
- AliqIpi · number|null · optionnel
- AliqPis · number · optionnel
- ApiCode · string|null · optionnel
- CstIcms · string|null · optionnel
- AliqIcms · number · optionnel
- AutoAliq · boolean · optionnel
- AliqIbsUf · number|null · optionnel
- CstCofins · string|null · optionnel
- CstIbsCbs · string|null · optionnel
- Descricao · string · requis
- AliqCofins · number · optionnel
- AliqIbsMun · number|null · optionnel
- Observacao · string|null · optionnel
- AliqReducao · number|null · optionnel
- AliqDiferimento · number|null · optionnel
- EnquadramentoIpi · string|null · optionnel
- CodBeneficioFiscal · string|null · optionnel
Exemple d'appel
```
{"name": "tributacao_editar", "arguments": {"Cfop": 1, "Descricao": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"Id": 1, "Ok": true, "Erro": "texte", "Tributacao": {}}}
```

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://api.brasilnfe.com.br/services/Mcp