---
title: "Erros HTTP — NFS-e Inbound"
description: "Códigos de status HTTP retornados pela API de recepção de NFS-e, formato do corpo de erro e como reagir a cada um."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-http-errors/
last_updated: 2026-07-30
---

# Erros HTTP — NFS-e Inbound

## Formato do corpo de erro

```json
{ "errors": [ { "code": 404, "message": "string" } ] }
```

## Códigos

| Status | Significado | Ação |
|---|---|---|
| `200` | OK | — |
| `201` | Criado (cadastro de empresa) | — |
| `202` | Aceito (operação assíncrona: manifestação, reprocess) | Acompanhe por `GET` ou webhook |
| `302` | Redirect para URL assinada (XML/PDF) | Siga o `Location` |
| `400` | Requisição inválida (ex.: chave malformada) | Corrija o payload |
| `401` | Não autenticado | Confira a API Key |
| `403` | Sem permissão (ex.: falta o papel `Management`) | Use credencial com o papel correto |
| `404` | Não encontrado | Verifique `companyId`/chave |
| `409` | Conflito (ex.: empresa já cadastrada; manifestação `Pending` duplicada) | Trate como idempotente |
| `400` | Campos obrigatórios faltando (ex.: rejeição sem `reasonCode`) | Complete os campos obrigatórios |
| `500` | Erro interno | Tente novamente; persistindo, contate o suporte |

:::note Alguns comportamentos em validação
A política de retry de webhook e o TTL exato das URLs assinadas estão em confirmação — ver [issue #210](https://github.com/nfe/dfetech-distribution-api/issues/210) e [Troubleshooting](./troubleshooting.md).
:::

## Veja também

- [Troubleshooting](./troubleshooting.md)
- [Endpoints NFS-e](./endpoints-nfse.md)