> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/pedidos/alterar-status.md).

# Alterar Status

Altera o **status** de um pedido — por exemplo, marcá-lo como "Em Separação" ou "Enviado".

```
PUT /pedidos/{Codigo}/alterar-status/
```

## 1️⃣ Descubra o código do status

Cada status possui um **Código**. Para saber quais status existem na plataforma e seus códigos, consulte:

```
GET /informacoes/status/
```

A resposta lista os status disponíveis:

```json
[
  {
    "Codigo": 3,
    "NomeStaff": "Aguardando Pagamento"
  }
]
```

## 2️⃣ Envie a alteração

No corpo da requisição, envie o novo status:

| Campo           | Tipo    | Obrigatório | Descrição                                             |
| --------------- | ------- | ----------- | ----------------------------------------------------- |
| `CodigoStatus`  | inteiro | ✅ Sim       | Código do novo status (obtido no passo anterior)      |
| `IsEnviarEmail` | texto   | ❌ Não       | `S` para notificar o cliente por e-mail, `N` para não |

### 📥 Exemplo de requisição

```bash
curl -X PUT "https://api.toplojas.com.br/pedidos/1000/alterar-status/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]" \
  -H "Content-Type: application/json" \
  -d '{
    "CodigoStatus": 8,
    "IsEnviarEmail": "S"
  }'
```

Em caso de sucesso, a API retorna o HTTP Code **200**.

{% hint style="info" %}
Referência completa deste endpoint:

{% embed url="<https://api.toplojas.com.br/doc/#/Pedidos>" %}
{% endhint %}