APIs do NotaGuard
Três formas de levar os dados fiscais para fora do painel. A API NotaGuard entrega os documentos que a empresa recebeu e emitiu e manifesta NF-e na SEFAZ. A API de Transmissão envia à SEFAZ a NFS-e assinada no seu servidor, sem o certificado sair de lá. O servidor MCP liga a conta a um assistente de IA, sem escrever código.
API NotaGuard
Os documentos fiscais da empresa no seu sistema: NF-e, NFC-e e NFS-e recebidas e emitidas, com itens, eventos SEFAZ e tributos. Paginação por cursor e sincronização incremental por data de atualização.
- Consulta de notas
- Totais por período
- XML autorizado
- PDF (DANFE e DANFSe)
- Exportação em lote
- Manifestação de NF-e
- Etiquetas
URL base api.notaguard.com.br. Sem CORS: as chamadas partem do seu servidor.
- Consulta por id ou pela chave de acesso
- Exportação em lote: ZIP de até 5.000 XMLs
- Limite de 60 unidades de custo por minuto, por chave
API de Transmissão de NFS-e
Para emitir NFS-e sem entregar o certificado do emitente. Você assina a nota no seu servidor e o NotaGuard valida e transmite à SEFAZ como transmissor, sob o certificado dele. Na prática: preparar devolve o SignedInfo, você assina com RSA-SHA256 e emitir transmite o lote. A chave privada não sai da sua infraestrutura.
Hosts próprios, separados da API NotaGuard: api-emissao.notaguard.com.br (produção, nota com valor fiscal) e api-emissao-teste.notaguard.com.br (produção restrita, para integrar).
- Validação dos dados antes de tocar a SEFAZ
- Lote de até 10 notas, token válido por 24 horas
- Cancelamento e substituição com a mesma assinatura local
- Biblioteca Node de assinatura, com código-fonte público para auditoria
MCP para assistentes de IA
Não é REST: é um endereço que você cola no ChatGPT, no Claude, no Gemini, no Grok ou em outro assistente compatível para ele consultar, analisar e organizar as notas da empresa em linguagem natural. Com sua autorização, também manifesta NF-e na SEFAZ e emite NFS-e.
Endereço mcp.notaguard.com.br. Login por OAuth, sem chave para cadastrar e sem pacote para instalar.
- 34 ferramentas e 2 prompts prontos
- Permissões separadas para leitura, rascunho, emissão e manifestação
- Limite de 10 a 60 chamadas por minuto, conforme o plano
O que vale para as duas APIs
Autenticação por chave
Bearer token no header Authorization. A chave sai do painel, em Configurações > Integrações, criada por proprietário ou administrador da empresa. Cada chave abre uma empresa e um ambiente, e o token completo aparece só no momento da criação; depois disso, só o prefixo. Nenhuma das duas envia headers de CORS.
Erro com código estável
Toda resposta de erro traz um código, uma mensagem em português e o id_requisicao que o suporte usa para investigar. Códigos publicados não são renomeados nem removidos dentro de /v1.
O MCP não usa chave: a autorização é por OAuth, concedida na tela de permissões e revogável no painel. O limite das APIs é por chave, e ajustável. Para aumentá-lo, ou para pedir acesso à API de Transmissão, entre em contato.