Erros HTTP — NFS-e Inbound
Formato do corpo de erro
{ "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 |
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 e Troubleshooting.