---
title: "Manutenção administrativa da captura de NFS-e"
description: "Endpoints administrativos para forçar captura, consultar notificações e estatísticas e reativar empresas — restritos ao papel Management."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-manutencao/
last_updated: 2026-07-30
---

# Manutenção administrativa da captura de NFS-e

Há um conjunto de endpoints operacionais sob `.../inbound/nfse/maintenance`. Eles exigem o papel **`Management`** — chamadas sem ele retornam `403`.

> Todas as rotas abaixo são prefixadas por `https://api.nfse.io/v2/companies/{companyId}/inbound/nfse/maintenance`.

## Forçar captura imediata

```bash
curl -X POST ".../maintenance/fetch-now" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"
```

Dispara um ciclo de captura fora da cadência normal de *polling*.

## Consultar notificações operacionais

```bash
curl ".../maintenance/notifications?severity=Critical" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"
```

Filtros: `severity` (`Info` / `Warning` / `Critical`) e `type`.

## Estatísticas

```bash
curl ".../maintenance/statistics" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"
```

Retorna contadores operacionais da empresa.

## Reativar empresa

Empresas desativadas automaticamente pelo *circuit breaker* (ex.: falhas consecutivas) podem ser reativadas:

```bash
curl -X POST ".../maintenance/reactivate" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"
```

## Veja também

- [Troubleshooting](../reference/troubleshooting.md)
- [Tipos e enums](../reference/tipos-e-enums.md)
- [Autenticação](../../comum/autenticacao.md)