Question 1

Qual a diferença entre Consulta Avulsa e Monitoramento?

Accepted Answer

Consulta Avulsa é uma chamada pontual à SEFAZ — R$ 0,20, retorna a situação atual e pronto. Monitoramento custa R$ 0,35 por XML e segue acompanhando a nota durante 30 dias, de hora em hora nas primeiras 24 horas e depois uma vez por dia.

Question 2

Por que a cadência é horária nas primeiras 24 horas?

Accepted Answer

O prazo regular para o emitente cancelar uma NF-e é de até 24 horas após a autorização. Por isso, nas primeiras 24 horas de monitoramento a consulta é de hora em hora; se a nota entra logo após a emissão, esse prazo fica coberto. Depois, a checagem é diária até o 30º dia, porque alguns estados ainda aceitam cancelamento fora do prazo em casos excepcionais.

Question 3

A duplicata escritural substitui a consulta na SEFAZ?

Accepted Answer

Não — as duas respondem perguntas diferentes. O registro da duplicata escritural na registradora prova quem é o titular do crédito e evita que o mesmo título seja cedido duas vezes. Ele não confirma que a NF-e que lastreia o título continua autorizada: na convenção das registradoras, o cancelamento da nota é informado pelo próprio emitente. O VigiaXML consulta a SEFAZ diretamente e avisa quando o status muda. Complementa a registradora, não substitui.

Question 4

Como recebo os alertas?

Accepted Answer

No painel web (sempre disponível), por e-mail (opcional) e por webhook HTTPS. O e-mail vem desligado: o dono da conta liga na aba Alertas do painel e escolhe até 10 destinatários. Ele avisa quando uma nota monitorada é cancelada, não é encontrada na SEFAZ ou recebe manifestação negativa do sacado (só SP, MS e AM devolvem esse evento), num resumo a cada 15 minutos no máximo; o que for detectado entre 1h e 7h chega às 7h. No webhook, cadastre um callbackUrl no monitoramento e receba o evento webhook.status_mudou a cada mudança de status, com status anterior e novo. Cada entrega traz um id único no header X-VigiaXML-Delivery pra dedup, com retry em 5/10/15min. Lotes de importação disparam job.concluido. A assinatura HMAC-SHA256 do payload está planejada, sem data pública.

Question 5

Quais documentos fiscais são suportados?

Accepted Answer

Hoje a plataforma consulta e monitora NF-e (modelo 55), CT-e (57), MDF-e (58) e NFC-e (65) — os quatro documentos eletrônicos transacionados na SEFAZ. NFS-e municipais ainda não estão cobertos (são 5.500+ prefeituras com layouts próprios); fale com a gente se for prioridade pra sua operação.

Question 6

Tenho fidelidade ou volume mínimo?

Accepted Answer

Nenhum dos dois. Você paga só pelo que usar — R$ 0,20 por consulta avulsa e R$ 0,35 por XML colocado em monitoramento. Cancela quando quiser e os XMLs em vigilância continuam até o fim dos 30 dias contratados.

Question 7

Como funciona a integração?

Accepted Answer

REST com header X-Api-Key (chave prefixada com vxml_). Você manda a chave de acesso por POST e recebe a resposta em JSON em 1-3s. Para volume, use o endpoint /v1/importar (até 1.000 chaves por chamada) ou suba CSV no painel. Webhooks chegam em qualquer URL HTTPS sua quando jobs em lote concluem.

Question 8

Qual o SLA da plataforma?

Accepted Answer

Target de 99,5% mensal — equivale a até 3h35min de downtime por mês. Stack roda em Azure Container Apps + Postgres Flex em Brazil South, com health checks contínuos. Status do SEFAZ é monitorado em tempo real por UF; quando a SEFAZ principal cai, fazemos fallback automático pra SVC-AN/SVC-RS.

Question 9

Como funciona a cobrança?

Accepted Answer

Pay-per-use: você só paga pelo que consumir. Faturamento mensal acumula consultas avulsas (R$ 0,20/consulta) + XMLs em monitoramento (R$ 0,35/XML por janela de 30 dias) + consultas cadastrais de CNPJ (R$ 0,70 por CNPJ/UF, cache de 24h sem custo). Sem mensalidade, sem fidelidade, sem volume mínimo. Trial de 30 dias ou 5.000 consultas (o que vier primeiro) gratuito pra testar.

Question 10

Consigo conectar com meu ERP?

Accepted Answer

Sim. Qualquer ERP que faça chamada REST consegue integrar — endpoints documentados em /v1, header X-Api-Key, JSON e exemplos cURL e TypeScript. Para ERPs que não têm como fazer chamada HTTP, há upload CSV no painel e webhooks para conclusão de importação. SDKs oficiais estão planejados, sem data pública.

Question 11

Vocês precisam do meu certificado digital?

Accepted Answer

Não. A consulta funciona com a chave de acesso da NF-e — o certificado fica do lado do VigiaXML, não do seu. Isso simplifica a integração e elimina o risco de o seu certificado A1 expirar e quebrar a operação.

Question 12

O que acontece com meus dados?

Accepted Answer

Cada consulta fica logada para auditoria por 24 meses. Não vendemos dados, não compartilhamos com terceiros fora dos provedores de infraestrutura, e não cruzamos dados de uma carteira com outra. Detalhes na nossa página de Privacidade & LGPD.

Pague só pelo que usar

Pague só pelo que usar

Trial

Consulta Avulsa

Monitoramento

Perguntas frequentes

Antecipe sabendo o que está comprando.