APIs do NotaGuard
Duas APIs REST, com especificação OpenAPI e referência em português. A de leitura devolve os documentos fiscais que a sua empresa recebeu e emitiu. A de emissão transmite NFS-e à SEFAZ sem custodiar o certificado do emitente.
API de leitura
Somente leitura. Lista NF-e, NFC-e e NFS-e recebidas e emitidas pela empresa, com itens, eventos SEFAZ e tributos, baixa o XML autorizado e gera o PDF (DANFE ou DANFSe). Paginação por cursor e sincronização incremental por data de atualização.
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 emissão de NFS-e
Emite NFS-e pelo Padrão Nacional com emitente e transmissor em CNPJs diferentes. A chave privada não sai da sua infraestrutura: preparar devolve o SignedInfo a assinar, você assina localmente com RSA-SHA256, emitir transmite o lote à SEFAZ sob o certificado do NotaGuard.
Host próprio, api-emissao-teste.notaguard.com.br, separado da API de leitura. A emissão roda hoje em produção restrita, o ambiente da SEFAZ sem valor fiscal.
- Validação dos dados antes de tocar a SEFAZ
- Lote de até 10 notas, token válido por 24 horas
- Biblioteca Node de assinatura, com código-fonte público para auditoria
O que vale para as duas
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 limite de uso é por chave, e ajustável. Para aumentá-lo, ou para pedir acesso à API de emissão, fale com a gente.