---
title: "Manutenção administrativa da captura de NFS-e"
description: "Endpoints operacionais sob .../inbound/nfse/maintenance: forçar captura (fetch-now, acessível pela própria empresa), consultar notificações/estatísticas e reativar empresas (papel Management)."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-manutencao/
last_updated: 2026-08-19
---

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

Há um conjunto de endpoints operacionais sob `.../inbound/nfse/maintenance`:

- **`fetch-now`** — força a captura imediata da **própria empresa**. Acessível com uma **API Key de cliente** (papel `Nota Fiscal` / `NFSeDist`) **ou** com o papel `Management` (ops). O disparo é escopado ao próprio *tenant*: a empresa precisa pertencer à conta da API Key, senão retorna `404`.
- **`notifications`**, **`statistics`**, **`reactivate`** — administrativos, restritos ao 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"
```

Dispara um ciclo de captura fora da cadência normal de *polling*, continuando do `currentNsu` da empresa. Resposta `202 Accepted`.

:::danger Risco de NOVAS COBRANÇAS ao alterar o NSU
O corpo opcional aceita **`forcedStartNsu`**, que **reposiciona o cursor de NSU** da empresa. Informar um NSU **menor** que o `currentNsu` faz o sistema **re-capturar documentos já processados — e cada documento re-capturado é COBRADO NOVAMENTE** (a bilhetagem do NFS-e Inbound é por documento capturado).

Para uma busca normal, **não envie `forcedStartNsu`** — o sistema continua a partir do `currentNsu` e não re-cobra o que já foi capturado. Use `forcedStartNsu` apenas quando souber exatamente o efeito.
:::

```bash
# ⚠️ forcedStartNsu reposiciona o cursor de NSU — pode gerar novas cobranças (ver aviso acima)
curl -X POST ".../maintenance/fetch-now" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "forcedStartNsu": 10000 }'
```

## 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)