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).
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.
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"}]}
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âmetro | Descrição |
|---|---|
tipo | nfe (padrão), cte, nfse ou nfce |
desde | Data/hora inicial de alterado_em, inclusiva (alterado_em >= desde): 2026-10-01 ou 2026-10-01T08:30:00 |
ate | Data/hora final, inclusiva (opcional). Só com a data (2026-10-31) inclui o dia inteiro, até 23:59:59. |
empresa | CNPJ de uma das empresas da conta (opcional) |
apos | Recomendado. 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. |
pagina | Pá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_pagina | Itens 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.
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
| Código | Quando |
|---|---|
| 400 | Parâmetro inválido (tipo, data, apos, pagina ou por_pagina) |
| 401 | Chave ausente ou inválida |
| 403 | Módulo API não contratado ou conta bloqueada |
| 404 | Documento ou empresa não encontrado, ou XML ainda indisponível |
| 429 | Mais de 120 chamadas por minuto |
Toda resposta de erro traz {"erro": "mensagem"}.
/documentos?tipo=nfe&por_pagina=500 (com desde, se quiser começar de uma data).tem_mais vier true, chame de novo com apos= o proximo_apos recebido (mantendo os mesmos tipo, desde e empresa).xml_completo: true, baixe o XML.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.