Entrar Testar 7 dias grátis

API do NFGuard

Com a API, o seu ERP ou sistema interno busca sozinho os documentos fiscais que o NFGuard baixou da SEFAZ e os XML de cada um. A API é um módulo contratado à parte (R$ 99,00 por mês, além do plano). Para ativar, entre no NFGuard em Integração (API).

Autenticação

Gere a chave em Integração (API) e envie em todas as chamadas, no cabeçalho:

Authorization: Bearer nfg_sua_chave_aqui

O cabeçalho X-API-Key: nfg_sua_chave_aqui também é aceito. Guarde a chave com segurança. Se ela vazar, gere outra: a antiga para de funcionar na hora.

Endereço base: https://nfguard.com.br/api/v1. Respostas em JSON (UTF-8), com exceção do XML. Limite: 120 chamadas por minuto por conta. Acima disso, a resposta é 429.

GET/empresas

Lista as empresas (CNPJs) cadastradas na conta.

curl -H "Authorization: Bearer SUA_CHAVE" https://nfguard.com.br/api/v1/empresas
{"empresas": [{"cnpj": "11222333000144", "razao_social": "EMPRESA EXEMPLO LTDA", "apelido": "Matriz",
  "uf": "PE", "ativa": true, "ultima_consulta_sefaz": "2026-10-26T09:03:16"}]}

GET/documentos

Lista os documentos da conta, do mais antigo para o mais novo pela data em que entraram ou foram alterados no NFGuard (empate: pela chave). É o jeito certo de sincronizar: guarde o proximo_apos da última resposta e mande como apos na próxima chamada (veja a rotina sugerida abaixo). Para não perder nada que ainda esteja sendo gravado, a lista só traz o que foi alterado até 2 minutos atrás (o campo alterado_ate da resposta mostra esse limite); o que mudou depois aparece na chamada seguinte.

ParâmetroDescrição
tiponfe (padrão), cte, nfse ou nfce
desdeData/hora inicial de alterado_em, inclusiva (alterado_em >= desde): 2026-10-01 ou 2026-10-01T08:30:00
ateData/hora final, inclusiva (opcional). Só com a data (2026-10-31) inclui o dia inteiro, até 23:59:59.
empresaCNPJ de uma das empresas da conta (opcional)
aposRecomendado. Cursor: o valor de proximo_apos da resposta anterior (formato alterado_em|chave). Traz só o que vem depois do último documento recebido, sem pular nem repetir, mesmo que documentos mudem entre as chamadas. Não use junto com pagina.
paginaPágina, de 1 a 1.000.000 (padrão 1). Mantida por compatibilidade: se documentos forem alterados enquanto você percorre as páginas, algum pode ser pulado ou repetido. Prefira apos.
por_paginaItens por página: de 1 a 500 (padrão 100)
curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://nfguard.com.br/api/v1/documentos?tipo=nfe&desde=2026-10-01&por_pagina=100"
{"tipo": "nfe", "pagina": 1, "por_pagina": 100, "total": 2, "proxima_pagina": null, "tem_mais": false,
 "proximo_apos": "2026-10-21T11:20:02.418731|26261006905487000138550010002398911013446193",
 "alterado_ate": "2026-10-21T14:58:00",
 "documentos": [{
   "tipo": "nfe", "chave": "26261006905487000138550010002398911013446193", "numero": "239891", "serie": "1",
   "emissao": "2026-10-16T11:13:15", "valor": 45964.75,
   "emitente": {"cnpj": "06905487000138", "nome": "FORNECEDOR EXEMPLO LTDA", "uf": "PE"},
   "destinatario": {"cnpj": "11222333000144", "nome": "EMPRESA EXEMPLO LTDA"},
   "empresa_cnpj": "11222333000144", "papel": "destinatario", "situacao": "autorizada",
   "manifestacao": "ciencia", "cfop": "5102", "natureza": "VENDA", "xml_completo": true,
   "alterado_em": "2026-10-21T11:20:02"}]}

xml_completo: na NF-e, false quer dizer que, por enquanto, só existe o resumo da SEFAZ. O XML completo chega depois da manifestação, e então o documento volta na lista com novo alterado_em. Cancelamentos (NF-e, CT-e, NFS-e e NFC-e) também atualizam o alterado_em, e o documento volta na lista com situacao nova. Os campos variam um pouco por tipo: CT-e traz tomador, NFS-e traz prestador e tomador.

GET/documentos/{chave}/xml

Baixa o XML do documento (application/xml). O cabeçalho X-NFGuard-XML-Completo vem sim ou nao (resumo).

curl -H "Authorization: Bearer SUA_CHAVE" -o nota.xml \
  https://nfguard.com.br/api/v1/documentos/26261006905487000138550010002398911013446193/xml

Erros

CódigoQuando
400Parâmetro inválido (tipo, data, apos, pagina ou por_pagina)
401Chave ausente ou inválida
403Módulo API não contratado ou conta bloqueada
404Documento ou empresa não encontrado, ou XML ainda indisponível
429Mais de 120 chamadas por minuto

Toda resposta de erro traz {"erro": "mensagem"}.

Rotina sugerida de sincronização

  1. Na primeira vez, chame /documentos?tipo=nfe&por_pagina=500 (com desde, se quiser começar de uma data).
  2. Enquanto tem_mais vier true, chame de novo com apos= o proximo_apos recebido (mantendo os mesmos tipo, desde e empresa).
  3. Para cada documento novo, ou que passou a ter xml_completo: true, baixe o XML.
  4. Guarde o último proximo_apos. A cada 15 a 60 minutos, continue dele com apos=: vêm só os documentos novos ou alterados desde então, cada um uma vez (um documento alterado de novo volta, com alterado_em novo). Repita para cte, nfse e nfce, se usar, cada tipo com o seu cursor.

Dúvidas na integração? Fale com o suporte pelo WhatsApp (11) 93212-3552 ou pelo e-mail henriquewc@gmail.com.

Fale conosco