# API03001: Formato de Requisição Inválido

## O Que Isso Significa[​](#what-this-means "Link direto para O Que Isso Significa")

A requisição enviada ao servidor não estava no formato esperado. O servidor não conseguiu entender o que o POS estava pedindo porque a estrutura da requisição estava incorreta.

## Causas Comuns[​](#common-causes "Link direto para Causas Comuns")

* **Dados corrompidos** — Dados foram corrompidos antes de serem enviados
* **Erro de software** — Um problema no aplicativo POS
* **Interferência de proxy** — Um proxy ou firewall modificou a requisição
* **Problemas de codificação de caracteres** — Caracteres especiais não foram codificados corretamente

## Mapeamento de Erros do Servidor[​](#server-error-mapping "Link direto para Mapeamento de Erros do Servidor")

Este código de erro é acionado quando o servidor retorna:

| Código do Servidor | Fonte                                    |
| ------------------ | ---------------------------------------- |
| HTTP 400           | Qualquer resposta do servidor (fallback) |

## Como Corrigir[​](#how-to-fix "Link direto para Como Corrigir")

### 1. Tente Novamente a Ação[​](#1-retry-the-action "Link direto para 1. Tente Novamente a Ação")

Às vezes, esse é um erro pontual:

* Espere um momento e tente novamente
* Atualize o POS e tente novamente

### 2. Verifique Caracteres Especiais[​](#2-check-for-special-characters "Link direto para 2. Verifique Caracteres Especiais")

Se você estiver inserindo dados com caracteres especiais:

* Tente remover emojis ou símbolos incomuns
* Use caracteres padrão para nomes de produtos, etc.

### 3. Atualize o POS[​](#3-update-the-pos "Link direto para 3. Atualize o POS")

Garanta que você está usando a versão mais recente:

* Verifique se há atualizações do aplicativo
* Atualize o plugin WCPOS em seu servidor

### 4. Verifique a Configuração da Rede[​](#4-check-network-configuration "Link direto para 4. Verifique a Configuração da Rede")

Se você estiver atrás de um proxy:

* Verifique se o proxy não está modificando as requisições
* Verifique regras de firewall
* Tente acessar de uma rede diferente

### 5. Relate o Problema[​](#5-report-the-issue "Link direto para 5. Relate o Problema")

Se isso acontecer consistentemente:

* Observe qual ação aciona o erro
* Verifique o console do navegador para detalhes (versão web)
* Relate no [GitHub](https://github.com/wcpos) com etapas de reprodução

## Erros Relacionados[​](#related-errors "Link direto para Erros Relacionados")

* [API03002](/pt-BR/error-codes/API03002.md) — Parâmetros Obrigatórios Faltando
* [API03003](/pt-BR/error-codes/API03003.md) — Valor de Parâmetro Inválido