---
updatedAt: 2026-05-20T21:21:19.000Z
agentTools:
  projectIndex: https://docs.notagateway.com.br/llms.txt
---

# Erros

Entenda as mensagens de erro apresentadas pela API da Nota Gateway

## Como identificar as mensagens de erro:

A API retorna **Códigos de Status HTTP** para indicar sucesso ou falha da chamada.

Em geral, os códigos iniciados com:

* **2**xx indicam sucesso;
* **4**xx indicam erro *(Ex: Falta de parâmetro obrigatório ou Falha ao autenticar)*;
* **5**xx indicam erro interno nos serviços do Gateway.

Alguns métodos incluem outros retornos, portanto, consulte sempre o resultado do método utilizado.

| Status | Mensagem            | Descrição                                                                                                                                                                                           |
| :----- | :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | Sucesso             | Método invocado executou com sucesso.                                                                                                                                                               |
| 401    | Falha ao autenticar | Verifique sua <Anchor label="API Key" target="_blank" href="https://atendimento.notagateway.com.br/kb/pt-br/article/222600/">API Key</Anchor>                                                       |
| 403    | Não autorizado      |                                                                                                                                                                                                     |
| 500    | Erro interno        | Ocorreu uma instabilidade no Gateway, tente novamente em alguns segundos ou acione nosso <Anchor label="suporte" target="_blank" href="https://atendimento.notagateway.com.br/kb">suporte</Anchor>. |

> 🚧 Atenção!
>
> É importante notar que o código "HTTP 200" significa que a requisição a Nota Gateway foi **processada** corretamente e não que a nota fiscal tenha sido emitida.