# Latência da API fiscal

> Latência da API fiscal é o tempo que passa entre o momento em que um sistema envia uma requisição a uma API de emissão fiscal e o momento em que recebe a resposta. Ela inclui a transmissão pela rede, o processamento na API e, em alguns casos, a comunicação com a SEFAZ ou a prefeitura.

**Também conhecido como:** Tempo de resposta da API fiscal, Latência de emissão fiscal, Latência da API de emissão, Fiscal API latency

**Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** L

## O que compõe a latência de uma API fiscal?

A latência é a soma de várias etapas. Primeiro, a requisição viaja pela internet do sistema do cliente até a API. Depois, a API confere a autenticação, valida os dados enviados, monta o XML do documento e faz a assinatura digital. Por fim, a resposta volta pelo mesmo caminho.

Quando a API espera a resposta do órgão autorizador antes de responder, o tempo da SEFAZ ou do sistema da prefeitura também entra na conta. Essa parte não depende da API e pode variar bastante conforme o estado, o município, o horário e a estabilidade do autorizador naquele momento.

## Por que a latência importa na emissão de notas?

O impacto depende do tipo de operação. No varejo, a NFC-e costuma ser emitida com o cliente esperando no caixa ou no checkout da loja virtual, então cada segundo a mais é percebido como lentidão no atendimento.

Já um ERP que emite NF-e de pedidos faturados ou um sistema que gera NFS-e no fechamento do mês tolera tempos maiores, desde que o processo seja confiável. Por isso, mais importante do que buscar a menor latência possível é saber quanto tempo esperar e preparar o sistema para lidar com variações.

## Qual a diferença entre latência da API e tempo de autorização do documento?

A latência da API mede quanto tempo leva para a API responder a uma chamada. O tempo de autorização mede quanto leva até o documento ser aprovado ou rejeitado pelo órgão fiscal. Em integrações síncronas, os dois praticamente se confundem, porque a resposta só chega depois da autorização.

Em um fluxo assíncrono, a API responde rápido confirmando que recebeu o pedido e devolve um identificador. A autorização acontece em seguida, e o resultado chega por webhook ou é consultado por polling. Assim, a latência da chamada fica baixa mesmo quando o autorizador demora, e o sistema do cliente não fica travado esperando.

## Como medir a latência da API fiscal?

O jeito mais simples é registrar no próprio sistema o horário de envio e o de recebimento da resposta de cada requisição. Esses dados, guardados em logs, permitem acompanhar a evolução ao longo do dia e identificar picos.

A média sozinha engana, porque algumas chamadas muito lentas ficam escondidas. É comum olhar percentis, como o p95 e o p99, que mostram o tempo dentro do qual ficam 95% e 99% das requisições. Ferramentas de observabilidade e rastreamento de requisições ajudam a descobrir em qual etapa o tempo está sendo gasto.

## Como lidar com latência alta na integração fiscal?

Algumas práticas reduzem o tempo de cada chamada: reaproveitar conexões com keep-alive HTTP, evitar enviar dados desnecessários no payload e preferir o fluxo assíncrono quando o processo de negócio permitir.

Outras práticas protegem o sistema quando a lentidão vem de fora. Configurar um timeout adequado evita que o sistema espere indefinidamente. Fazer novas tentativas com backoff exponencial e chave de idempotência evita emitir a mesma nota duas vezes. E prever contingência ou fallback garante que a operação continue quando o autorizador estiver instável.

## Exemplos de Latência da API fiscal

- Uma loja virtual percebe que o checkout fica lento no horário de pico e descobre, pelos logs, que a latência da API fiscal ao emitir NFC-e sobe junto com a instabilidade da SEFAZ do seu estado.
- Um ERP passa a usar o fluxo assíncrono: envia a NF-e, recebe o identificador em poucos instantes e libera o usuário, enquanto o status final chega depois por webhook.
- Uma plataforma de serviços monitora o p95 da latência na emissão de NFS-e por município e identifica quais prefeituras respondem mais devagar.
- A equipe técnica de uma transportadora ajusta o timeout das chamadas de emissão de CT-e para evitar que requisições lentas travem a fila de documentos.

## Perguntas frequentes

### Qual é uma latência aceitável para uma API fiscal?

Não existe um número único. Depende do documento, do autorizador e do fluxo usado. Chamadas assíncronas tendem a responder rápido, enquanto chamadas síncronas dependem do tempo da SEFAZ ou da prefeitura. O ideal é medir, definir metas internas e preparar o sistema para variações.

### Latência alta sempre significa problema na API?

Não. A lentidão pode vir da rede do cliente, do próprio sistema que faz a chamada ou do órgão autorizador. Medir cada etapa com logs e rastreamento ajuda a descobrir onde o tempo está sendo gasto.

### Repetir a requisição quando a resposta demora é seguro?

Só se a integração usar idempotência. Sem ela, uma nova tentativa pode gerar documentos duplicados caso a primeira tenha sido processada. O recomendado é consultar o status antes ou reenviar com a mesma chave de idempotência.

## Termos relacionados

- [Timeout na emissão fiscal](https://conota.dev/glossario/timeout-na-emissao-fiscal.md)
- [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md)
- [Observabilidade da API fiscal](https://conota.dev/glossario/observabilidade-da-api-fiscal.md)
- [Polling de status fiscal](https://conota.dev/glossario/polling-de-status-fiscal.md)
- [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md)
- [Keep-alive HTTP](https://conota.dev/glossario/keep-alive-http.md)

---

Fonte: [Latência da API fiscal](https://conota.dev/glossario/latencia-da-api-fiscal/) · Atualizado em 2026-10-22